3.4 Installing and Configuring the LDAP Plug-In

After you have created your plug-in, configure Access Manager to use it.

  1. Copy the plug-in class file to Identity Server:

    1. Copy it to the following directory under the correct directory structure as per the class package:

      • Linux:

        • If you want to use a LDAP-plugin class file: /opt/novell/nam/idp/webapps/nidp/WEB-INF/classes

        • If you want to use a LDAP-plugin class in a jar file: /opt/novell/nam/idp/webapps/nidp/WEB-INF/lib

      • Windows:

        • If you want to use a LDAP-plugin class file: C:\Program Files (x86)\Novell\Tomcat\webapps\nidp\WEB-INF\classes

        • If you want to use a LDAP-plugin class in a jar file: C:\Program Files (x86)\Novell\Tomcat\webapps\nidp\WEB-INF\lib

      If your class package name is com.acme.ldap.plugin, you need to create the com, acme, ldap, and plugin directories.

    2. Repeat Step 1.a for each Identity Server in the cluster.

  2. To associate an LDAP Server plug-in with the Custom1, Custom2, or Custom3 directory type, modify the web.xml file on Identity Server:

    1. In a text editor, open the following file:

      • Linux: /opt/novell/nam/idp/webapps/nidp/WEB-INF/web.xml

      • Windows: C:\Program Files (x86)\Novell\Tomcat\webapps\nidp\WEB-INF\web.xml

    2. Add an entry for the ladpStorePlugins context parameter. Your entry should look similar to the following to associate the com.acme.plugin.Sample1Plugin with the Custom1 directory type.

      <context-param>
      <param-name>ldapStorePlugins</param-name>
      <param-value>custom1:com.acme.ldap.plugin.Sample1Plugin</param-value>
      </context-param>

      You can add up to three values, using the following format:

      custom1:classname;custom2:classname;custom3:classname
    3. Repeat Step 2.a through Step 2.b on each Identity Server in the cluster.

  3. In Administration Console, configure Identity Server to use the new directory type for a user store.

    1. Click Access Manager > Identity Servers > Edit > Local.

    2. Either select the name of a user store or click New.

    3. For the Directory type, select the custom string you have configured in Step 2.

    4. Complete one of the following:

      • For a new user store, configure the other required values, then click Finish.

      • For a modified user store, modify the other options to fit the new directory type, then click OK.

    5. Update Identity Server.

  4. (Optional) To verify that the new directory type is functioning correctly, log in to the user portal by using the credentials of a user in the user store.

    If you encounter any errors, see Section 3.5, Troubleshooting.