This documentation supports the 22.1 version of Action Request System.
To view an earlier version, select the version from the Product version menu.

Configuring the ARDBC LDAP plug-in

Before you create the vendor form used to access user information in your LDAP server, you must configure the ARDBC LDAP plug-in.

For individual servers and on a local level, you can use the ARDBC LDAP Configuration form in the AR System Administration Console. If a local value does not exist, the form displays the global-level configuration. If you modify the value on this form, the local level configuration value is modified. For example, if a configuration shows global-level value and you modify the value by using this form, the local-level value gets created for the configuration. In a server group environment, you must configure ARDBC LDAP plug-in settings on each server.

Best practice

Alternatively, we recommend that you use the Server Group Configuration screen to configure ARDBC LDAP plug-in at global level. This screen provides a single location to manage configuration settings across the server group. To access the Server Group Configuration screen:

  1. In a browser, enter the following URL address:
  2. Log in.
  3. Select AR System Management Console > AR System Server Group Console > Server Group Configuration.

For more information about setting global and local level configurations, see Managing AR Server Group components by using global and local level configurations.

To add a new ARDBC LDAP source

  1. Create a new ARDBC LDAP configuration.
  2. Create a plug-in corresponding to the newly created configuration.

To create a new ARDBC LDAP configuration

  1. Open the AR System Administration Console.
  2. Select System > LDAP > ARDBC Configuration.
    The ARDBC LDAP Configuration form is displayed.

  3. Click Create New Configuration .
  4. Follow the steps in To configure the ARDBC LDAP plug-in below.
  5. Click Save Current Configuration.
    The Create New ARDBC LDAP Component dialog box is displayed.
  6. In the Configuration Names list, select the configuration name corresponding to the server in the server group, for which you want to add the ARDBC LDAP configuration.
  7. In the Component Name box, type some text, which will be used as a part of the new component name.
    The component name that you provided gets appended to the selected configuration name to form a complete component name with which the new configuration is created.
  8. Click OK.
    The new configuration is saved. This configuration is listed in the Configuration column on the ARDBC LDAP Configuration form.

To create a plug-in corresponding to the newly created configuration

  1. In AR System Administration Console, select System > General > Plugin Server Configuration.
    The Plugin Server Configuration screen is displayed.

  2. In the Plugin Server Instance list, select the plug-in server instance for the AR System server  for which the new ARDBC LDAP configuration is created.
    Refer to step 6 to know what server you selected, and select the plug-in server instance that hosts the AR System  plug-ins. Then, from the port number, you know which plug-ins this instance is hosting. The default port is 9999.
  3. Click the Plugin Configuration tab.
  4. Click Create.
    The Create New Plugin dialog box is displayed.

  5. In the Plugin Name box, type a name for the new plug-in.

    For the fields listed in steps 6 through 12, you can enter the same values as that of an existing plug-in.

  6. In the Plugin File Name field, type the name of the plug-in file along with the location where it is saved.
  7. In the Plugin Class Name field, type the class name of the plug-in.
  8. In the Path Elements section, click .
    The following setting name is displayed in the Setting Name column:
  9. In the Setting Value column, type the value for the corresponding setting.
  10. In the Path Elements section, click .
    The following setting name is displayed in the Setting Name column:
  11. In the preceding setting name, replace the location with path.
  12. In the Setting Value column, type the value for the corresponding setting.

  13. In the User Defined Elements section, click .
    A setting name is displayed in the  Setting Name  column.
  14. Append configComponentName to the setting name.
  15. In the Setting Value column, type the value for the corresponding setting.
    The value for this setting is the name of the newly created configuration in step 8.
  16. Click OK.
    The new ARDBC LDAP source is added on the same plug-in server.

To configure the ARDBC LDAP plug-in

These are server-specific settings.

  1. In the AR System Administration Console, select System > LDAP > ARDBC Configuration.
    The ARDBC LDAP Configuration form is displayed.
  2. In the Host Name field, enter one or more host names of the directory service from which you want information for the vendor form.
    You can specify a space-separated list of host names up to 255 characters long. Starting with the first host name in the list, AR System  tries to connect to each server until it is successful.
    If you use Secure Socket Layer (SSL), this host name should match the name for which the server's certificate was issued.
  3. In the Port Number field, enter a port number for this directory service. The default port number is 389. (For an SSL connection, the default is 636.)
  4. In the Bind User field, enter the distinguished name of the user account that the ARDBC LDAP plug-in uses to log in to the directory service. The administrator who set up the LDAP service designated this name. With the vendor form, some LDAP servers allow you to make an anonymous connection. If you plan to use an anonymous connection, leave the Bind User and Bind Password fields blank.
    Otherwise, use a standard distinguished name such as cn=manager, dc=remedy, dc=com.
  5. In the Bind Password field, enter the password for the user account.
    If you leave the Bind Name and Password fields blank, you are connected anonymously.
  6. To use a Secure Socket Layer (SSL) connection, select Yes in the Using Secure Socket Layer field; otherwise, accept the default value No.
    If you select Yes, the Certificate Database field becomes active, and you can enter a certificate database as described in step 7. Because SSL requires additional setup in this form and outside AR System , you might first want to experiment without SSL and then add this option later.
  7. In the Certificate Database field, enter the path to the directory containing the certificate database file. (Do not include the file name in the path.)

  8. In the LDAP Date-Time Format field, select the format to use to represent date and time to LDAP servers.




    Example: 6 a.m. Sept. 28, 2001

    Generalized Time


    YYYYMMDDHHMMSSZ This format is recognized by all LDAP servers, and it is recommended.


    AD Generalized Time


    YYYYMMDDHHMMSS.0Z This format is recognized only by Microsoft Active Directory servers.


    UTC Time


    YYMMDDHHMMSSZ This is a historical format and does not indicate the century. It is not recommended.


  9. In the Failover Timeout field, specify the number of seconds in which the directory service must respond to the plug-in server before an error is returned.
    The minimum value is 0 (which means the connection must be made immediately). The failover timeout cannot be set higher than the value of the Server-Plugin-Default-Timeout parameter.
  10. In the Directory Page Size field, enter the number of entries to return on a single page to the client from the external directory server when a search request is processed.


    The default Directory Page Size is 10000. However, setting Directory Page Size to a lower value (such as 1000) might help to improve your system's performance while you design and create vendor forms.

    Directory Page Size value should be less than or equal to the maximum page size setting on the LDAP server. For more information on ARDBC-LDAP-Page-Size, see Configuration settings A-B.

  11. In the Base DN For Discovery field, enter a base distinguished name to use instead of the root distinguished name as the basis for obtaining the list of vendor tables.


    Specifying a value in the Base DN For Discovery field can help improve your system's performance while you design and create vendor forms.

  12. In the ARDBC Plugin Cache box, specify this ARDBC plug-in caching information:
    1. For the Enable field, select Yes to enable ARDBC plug-in caching.
    2. In the Time To Live field, specify how long data should be kept in the ARDBC plug-in cache.
    3. In the Maximum Size field, specify the maximum size of the cache.


      Enabling the ARDBC plug-in cache can help improve your system's performance at runtime.

  13. Click Save.
    The system updates the AR System  configuration settings with the parameters you specified in this form.
Was this page helpful? Yes No Submitting... Thank you