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 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.
    For more information, see Generate Stubs Manually.
  2. Copy the generated classes into
    SRC
    .
    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.
    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
  6. Create a JMeter test, and add it to
    SDKWS HOME
    /test.
  7. Start a web browser and enter the following URL:
    http://localhost:8089/forwardinc
    The Forward Inc web page appears.
    To view the SDKWS Connector Account Management screens, start the
    User Console and navigate to the SDKWS Endpoint.