How to Incorporate Your Own Endpoint
The following process describes how to use the SDKWS sample connector to connect to your own endpoint.
The following process describes how to use the SDKWS sample connector to connect to your own endpoint.
The following abbreviations represent the directory paths that you use in this process:
- IM HOME-Identity Managerinstall root
- SDKWS HOME-IM HOME/Connector Server SDK/connectors/sdkws
- SRC-SDKWS HOME/src
- CONF-SDKWS HOME/conf
To incorporate your own endpoint, do the following:
- Generate the client stubs, as follows:
- Change theSDKWS HOME/clientBuild.xml to point to your web service WSDL files.
- Run the ant build fileSDKWS HOME/clientBuild.xml.
For more information, see Generate Stubs Manually. - Copy the generated classes intoSRC.Verifythat you have a unique package for these classes. If necessary, you can use the Wsdl2Java tool to rename your package.
- Create your metadata, and add it to /CONF.
- Implement com.ca.jcs.sdkws.SDKWSHelper.The interface is located inSRC.
- UpdateCONF/connector.xml to customize the classes:The SDKWS sample connector supports customization of the classes that communicate with the endpoint. To customize the classes, do the following:
- For each SDKWSHelperimplementation, add a new entry to the helperMap. If necessary, remove the Forward Inc entries.The key is the metadataconnector map toname of the object that you want to manage.The key must be unique in the entries. If necessary, remove the Forward Inc entries.When a CRUD operation is requested on the keyed object, the class invoked is value. The value class must implement SDKWSHelper.
- Update the staticMetadataFile to include your metadata file.
If your endpoint has no security, we recommend that you do not define the username and password when acquiring the endpoint. If your endpoint uses other security, modify the SDKWS sample connector to match your endpoints security implementation. For more information, see http://ws.apache.org/axis2/ and http://ws.apache.org/axis2/modules/rampart/1_0/security-module.html2 - Create a JMeter test, and add it toSDKWS HOME/test.
- Start a web browser and enter the following URL:http://localhost:8089/forwardincThe Forward Inc web page appears.To view the SDKWS Connector Account Management screens, start the User Console and navigate to the SDKWS Endpoint.