The information on this page refers to License Statistics v6.24 and newer, which changed "LDAP" labels to the generic label "User Directory." If you are using a version previous to v6.24, see documentation for previous versions.

To access User Directory configuration settings, select User Directory under the Administration section. (This page is visible only for License Statistics administrator users.) The following sections describe how to configure User Directory using the configuration page. Also see Importing User Directory user groups for more details on this topic.

Setting up a connection to a User Directory

To set up a connection to a User Directory, in the General section of the User Directory configuration page: 

  1. Enter the appropriate information for connecting to your User Directory server. (An example setup is shown in the screenshot below.)
    1. Directory type: Select from Active Directory (default), LDAP, or LDAP with POSIX. Your selection will populate the schema settings with the defaults for that selection, which can then be customized if needed.
    2. Hostame: The hostname of the User Directory server.
    3. Port: The port for the User Directory server. The default is 389.
    4. Use SSL: Check this box if you would like to connect to your User Directory server over SSL protocol. If using SSL, see Enabling User Directory over SSL for further setup information.
    5. Base DN: The base DN (Distinguished Name) under which to search for users and groups. (See Testing User Directory settings for more information on obtaining the base DN.)
    6. Manager DN: The DN for the manager account to be used for initial binding (authentication).
    7. Password: The password for the manager account.
    8. Follow Referrals: Check this box to use follow referrals, which allows navigating through the User Directory tree structures to find information that may be split into multiple servers. Note that enabling this setting may decrease performance. See https://httpd.apache.org/docs/trunk/mod/mod_ldap.html#ldapreferrals for detailed information about follow referrals.
    9. Referrals Hop Limit: Sets the limit on the number of referral hops to perform before the User Directory query is terminated. A higher Referrals Hop Limit lets you search more deeply for information on large networks, but reduces performance.
  2. Click Verify to ensure that your connection to the User Directory server works as expected. A message will indicate whether the test was successful. If the test is not successful, make the needed changes to the setup, save the changes, and retest the connection. (See Testing User Directory settings for more information on verifying your User Directory settings.)



  3. Click Save at the bottom of the User Directory page to save the User Directory configuration.

Enabling User Directory import

License Statistics lets you import user details and groups you have defined in a User Directory. Importing your user groups from User Directory eliminates the need to create user groups manually, which can be time consuming if you have a large number of users. For more information, see Importing User Directory user groups.

To enable User Directory import:

  1. Check the "Enable Users Import" checkbox to enable importing user groups you have defined in a User Directory directory.



  2. Optionally, you may enter a filter for the import to limit the data that is imported.
  3. Enter/edit the schema settings if needed for your configuration.
  4. Click Verify to ensure that your connection to the User Directory server works as expected. A message will indicate whether the test was successful. If the test is not successful, make the needed changes to the setup, save the changes, and retest the connection.
  5. Click Save and Import to save your settings and import the user details and groups from the User Directory.
  6. When you have completed all User Directory configuration settings, click Save at the bottom of the User Directory page to save the configuration.

Note that not all users matching the Base DN will be imported, but only those that were already monitored by License Statistics. Also, a group will be imported from User Directory only if it contains at least one user that is monitored by License Statistics.

Example:

Say you have the following users and groups in your configuration:

  • User1 belongs to Group1 and Group2 in User Directory, and is monitored by License Statistics
  • User2 belongs to Group2 and Group3 in User Directory, but is not monitored by License Statistics

Given this scenario, License Statistics will import:

  • User1 with his User Directory details
  • Group1 with member User1
  • Group2 with member User1

License Statistics will not import:

  • User2
  • Group3

 

Enabling User Directory authentication

You can enable License Statistics user authentication and optionally allow for automated License Statistics user account creation using the user accounts you already have defined in a User Directory directory.

Enabling account creation using a User Directory eliminates the potentially time-consuming task of adding users manually in License Statistics. With the User Directory option enabled, users simply log into License Statistics using their username and password that is stored in the User Directory, regardless whether the user has an account in License Statistics.

If User Directory authentication is enabled, you can also use User Directory authentication when creating new users.

To enable user authentication using User Directory:

  1. Check the "Enable User Directory Authentication" checkbox. 



  2. Optionally, you can enter a filter that limits the accounts that are allowed to authenticate and are automatically created.

    Default query with empty optional filter and username foo:

    &(objectClass=user)(sAMAccountName=foo)

      

    Query with optional field applied (filter value: memberOf=admin) and username bar:

    &(&(objectClass=user)(sAMAccountName=bar))(memberOf=admin)

      

  3. Optionally, check the "Automatic Account Creation" checkbox if you want to automatically create accounts using a User Directory.

    If "Enable User Directory Authentication" is selected and "Automatic Account Creation" is not selected (which is the default), all users that have accounts connected to a User Directory will be authenticated, but no new accounts will be created, even if the User Directory credentials are valid.

    Similarly, if you disable User Directory authentication, users who have already logged into License Statistics using a User Directory will retain the ability to use their login, but no new login attempts using User Directory user accounts will be possible.

  4. Enter/edit the schema settings if needed for your configuration.
  5. Click Verify to ensure that your connection to the User Directory server works as expected. A message will indicate whether the test was successful. If the test is not successful, make the needed changes to the setup, save the changes, and retest the connection.
  6. When you have completed all User Directory configuration settings, click Save at the bottom of the User Directory page to save the configuration.