Programming Guides › Connector Programming Guide › SDK Sample Connectors › SDKWS (SDK Web Services) Connector › How to Incorporate Your Own Endpoint

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 abbreviations represent the directory paths that you use in this process:

• IM HOME–CA Identity Manager install 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:

1. Generate the client stubs, as follows:
   1. Change the SDKWS HOME/clientBuild.xml to point to your web service WSDL files.
   2. Run the ant build file SDKWS HOME/clientBuild.xml.

   Note: For more information, see Generate Stubs Manually.

2. Copy the generated classes into SRC.

   Note: Verify that you have a unique package for these classes. If necessary, you can use the Wsdl2Java tool to rename your package.

3. Create your metadata, and add it to /CONF.
4. Implement com.ca.jcs.sdkws.SDKWSHelper.

   The interface is located in SRC.

5. Update CONF/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:

   1. For each SDKWSHelper implementation, add a new entry to the helperMap. If necessary, remove the Forward Inc entries.

      The key is the metadata connector map to name 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.

   2. Update the staticMetadataFile to include your metadata file.

   Note: 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.

   Note: For more information, see http://ws.apache.org/axis2/ and http://ws.apache.org/axis2/modules/rampart/1_0/security-module.html2

6. Create a JMeter test, and add it to SDKWS HOME/test.
7. Build the SDKWS sample connector.
8. Start a web browser and enter the following URL:

   http://localhost:8089/forwardinc

   The Forward Inc web page appears.

   Note: To view the SDKWS Connector Account Management screens, start the CA IdentityMinder User Console and navigate to the SDKWS Endpoint.