Implementing custom user authentication adapter

You can implement a custom user authentication adapter wherein you plug in your own user authentication adapter implementation and do not use the default Sterling User Authentication implementation.

About this task

To implement a custom user authentication adapter:

Procedure

  1. Create a custom UserAuthAdapter class that implements the com.ibm.configurator.userauth.adapter.UserAuthAdapter interface.
  2. Implement the methods of the UserAuthAdapter interface. For information about the input and output parameters used in each of the methods of the adapter class, refer to the Javadoc. The implementation should read the category and product details from the preferred user authentication system. You can access the Javadoc using the following application URL: http://<hostname>:<port>/configurator/javadoc/index.html.
  3. Create a new JAR file containing the custom authentication adapter class.
  4. Copy the custom jar that you created in Step 3 to the <TENANT_ID> directory located in the <tenant_repository>. For example, if the tenant id is matrix and the <tenant_repository> is C:/data/tenants, place the custom jar in the C:/data/tenants/matrix directory. <TENANT_ID> refers to the External Partner ID set in the Sterling Configurator Visual Modeler when creating a storefront.
  5. Configure the following properties in the tenant properties file and point to the custom authentication adapter class that you created in Step 1:
    • cnfg.<TENANT_ID>.userauth.authentication.enabled
    • cnfg.<TENANT_ID>.userauth.adapter.impl
    For example, if the tenant id is matrix and the <tenant_repository> is C:/data/tenants, edit the C:/data/tenants/matrix/matrix.properties file and configure the properties as follows:
    cnfg.matrix.userauth.authentication.enabled=truecnfg.matrix.userauth.adapter.impl=com.pc.userauth.adapter.impl.CustomUserAuthAdapter
  6. Restart the Omni-Configurator server.