Developing a custom user registry for Liberty

You can develop a custom user registry class by implementing the com.ibm.websphere.security.UserRegistry interface in the Liberty server.

About this task

The UserRegistry interface is a Service Programming Interface (SPI) that enables support to virtually any type of account repository. For a general view of stand-alone custom registries, see Stand-alone custom registries.

Procedure

  1. Implement the custom user registry. For more information, see Developing the UserRegistry interface for using custom registries.
  2. Convert the implementation class into an OSGi service. You can do the conversion in the following ways:
  3. Package the custom user registry as an OSGi bundle and export the UserRegistry service. For information on creating an OSGi bundle, see Creating an OSGi service bundle.
  4. Create a feature manifest to include the OSGi bundle. For more information, see Liberty: Product extension.
  5. After the feature is installed into the user product extension location, configure the server.xml file with the feature name. For example:
    <featureManager>
       ...
       <feature>usr:customRegistrySample-1.0</feature>
    </featureManager>

    For a downloadable custom user registry sample, see https://developer.ibm.com/wasdev/downloads/#asset/samples-Custom_User_Registry.

    For more information, see https://www.ibmdw.net/wasdev/docs/creating-a-custom-user-registry-as-a-liberty-user-feature/.


Icon that indicates the type of topic Task topic

File name: twlp_sec_custmr.html