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
-
Create a custom UserAuthAdapter class that implements the
com.ibm.configurator.userauth.adapter.UserAuthAdapter interface.
-
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.
-
Create a new JAR file containing the custom authentication adapter class.
-
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.
-
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
-
Restart the Omni-Configurator server.