Skip to end of banner
Go to start of banner

Connecting to LDAP Directories

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

Before connecting EmpowerID to an external directory, please review the Getting Started with Directory Systems topic. The topic walks you through the prerequisites you need to complete before connecting to an external directory for the first time. These prerequisites include:

  • Configuring the appropriate server roles for your EmpowerID servers

  • Reviewing the Join and Provision Rules for your environment

  • Reviewing the Join and Provision Filters for your environment

If you have already connected EmpowerID to another external directory, you can skip the above prerequisites.

EmpowerID provides connectors for a wide range of user directories and resource systems. As an administrator, you can use these connectors to quickly connect EmpowerID to your organization's identity-aware systems and applications. When you do so, you create an account store for that application in the EmpowerID Identity Warehouse and use that account store to configure how you want EmpowerID to manage the identity information in that system.

This topic demonstrates how to add an LDAP Directory domain to the EmpowerID Identity Warehouse as a managed Account Store. We demonstrate this by connecting EmpowerID to Open LDAP, but the process is the same for connecting to other supported LDAP directories, including:

  • IBM — IBM Tivoli Directory Server
  • NOVELL — Novell eDirectory
  • OpenDS — Open Directory Service (OpenDS)
  • OpenLDAP — Open LDAP
  • ORACLE — Oracle Internet Directory
  • Radiant Logic — Radiant Logic
  • SUN — Oracle Directory Server Enterprise Edition (SUN)

Error rendering macro 'excerpt-include' : No link could be created for 'Connecting to Active Directory'.

To create an LDAP account store

  1. From the navigation sidebar, expand Admin, then Applications and Directories, and click Account Stores and Systems.
  2. Click the Actions tab, and then click the Create Account Store action.



  3. Search for open and then click the record for Open LDAP to select that System type.



  4. Click Submit.

  5. On the Choose Servers page that appears, select the EmpowerID server or servers to register and click Submit.

    The Choose Servers page displays only those servers where the EmpowerID Web Role service is running. If you do not see your server on the page, check the following:

    • Ensure that the server has been assigned either the All-in-One Server or Web Front-End server role.
    • Ensure that the EmpowerID Web Role service is running.

    (The LDAP Management Host Web Service is responsible for LDAP communications and is enabled by default on each server running the EmpowerID Web Role service.)




    The LDAP Settings page appears, where you enter settings to connect to your LDAP directory to allow EmpowerID to discover and connect to it.



  6. On the LDAP Settings page, do the following:
    1. In the Name and Display Name fields, enter a name for the LDAP account store.

    2. In the LDAP Server field, enter the name of the server on which the directory is installed and include the port number if it is other than 389.
      e.g. dc-exch:636

    3. In the Partition Suffix field, enter the partition suffix for the directory. 
      e.g. dc=eiddoc,dc=com

    4. In the Proxy User field, enter the admin user account that has read access to the partition that holds the objects in the directory. 

      This user account is saved as the connection credential for this account store. You can change it at any time.

    5. In the Password field, enter the password for the proxy account.

    6. Click Submit.

      The Account Store is created and appears in the list of Account Stores in both the web application and the Management Console and a corresponding Resource System is created.

To configure account store settings

  1. In the navigation Sidebar, expand Admin, then Applications and Directories, and click Account Stores and Systems.
  2. On the Account stores tab, search for the account store you just created and click the Account Store link to go to its details page.



  3. On the Account Store Details page, click the Edit button or the name of the account store.



  4. In the edit view of the page, you can edit values in any of the enabled fields on the Settings tab. In the General section, these are:
    • Option 1 Specify an Account Proxy — Change the user name and password for the proxy connection.
    • Option 2 Select a Vaulted Credential as Account Proxy — Click in this box and press Enter to see a list of shared credentials in your system to use for the proxy connection.
    • Inventoried Directory Server — Select the server to inventory.
    • Is Remote (Cloud Gateway Connection Required) — Select if you are using the Installing the EmpowerID Cloud Gateway.



  5. In the Authentication and Password Settings section, you can select any of these values:
    • Use for Authentication — Select to allow users to log into EmpowerID with their credentials for this account.
    • Allow Search for User Name in Authentication — 
    • Allow Password Sync — Toggle to allow EmpowerID to sync password changes discovered during inventory.
    • Queue Password Changes — Toggle to have EmpowerID send password changes to the Account Password Reset Inbox for batch processing.
    • Password Manager Policy for Accounts without Person — Select a password manager policy to use for the account. If not selected, it uses the Default Password Manager Policy.



  6. In the Provisioning Settings section, you can set any of the following:
    • Allow Person Provisioning (Joiner Source) — Toggle to allow EmpowerID to create Person objects from the user records discovered during inventory.
    • Allow Attribute Flow — Toggle to allow attribute changes to flow between EmpowerID and the account store.
    • Allow Provisioning (By RET) — Toggle to allow EmpowerID to create new Groups in ServiceNow from requests discovered during inventory.
    • Allow Deprovisioning (By RET) — Toggle to allow EmpowerID to delete Groups in ServiceNow based on requests discovered during inventory.
    • Default User Creation Path  — Select a location in which to create users if none is specified.
    • Default Group Creation Path — Select a location in which to create groups if none is specified.
    • EmpowerID Group Creation Path — Select a location in which to create EmpowerID groups if none is specified.
    • Max Accounts per Person — Enter the maximum number of user accounts from this domain that an EmpowerID Person can have linked to them. This prevents the possibility of a runaway error caused by a wrongly configured Join rule. We recommended setting this value to 1 unless users commonly have multiple accounts and you want them to be joined to the same person.
    • Allow Account Creation on Membership Request — Toggle to allow users without accounts to request group membership and automatically have an account created.
    • Recertify All Group Changes as Detected — Toggle to allow EmpowerID to generate recertification review tasks for all changes in account store groups.
    • Allow Business Role and Location Re-Evaluation — Toggle if you have multiple account stores to manage and want to specify a priority for each.
    • Business Role and Location Re-Evaluation Order — Enter a number to specify the priority of the account store for determining the Business Roles and Locations to assign to a Person. Account Stores with a higher value take precedence.
    • Default Person Business Role — Set a default Business Role to assign people if none is specified.
    • Default Person Location — Set a default Location to assign people if none is specified.



  7. In the Special Use Settings section, you can select any of the following:
    • RBAC Assign Group Members On First Inventory — 
    • Automatically Join Account to a Person On Inventory (Skip Account Inbox) — Toggle to allow EmpowerID to join newly discovered accounts to people during the inventory process if they meet the Join Rule as specified by the Custom_Account_InventoryInboxJoinBulk SQL stored procedure.
    • Automatically Create a Person On Inventory (Skip Account Inbox) — Toggle to allow EmpowerID to provision EmpowerID people for new accounts discovered during the inventory process if they meet the Provision Rule specified by the Custom_Account_InventoryInboxGetAccountsToProvision SQL stored procedure.
    • Show in Tree — Toggle to show the account store in the Locations tree.
    • Queue Password Changes on Failure — Toggle to have EmpowerID send password changes to the Account Password Reset Inbox only when the change fails.
    • Use Secure LDAPS Binding — Toggle to bind accounts with encryption.



  8. In the Naming Fields section, you can set the following values:
    • Application ID — If the account store is a one-to-one match with a Tracking Only application, enter the Application Resource GUID of the application. (This value is supplied automatically if you select the Create a New Account Directory option when creating a Tracking Only application.)
    • Tenant ID — Enter the Tenant ID, if supplied by the connection account. (AWS uses this.)



  9. When you have finished editing, click Save, or keep this page open to continue setting up inventory, membership, projection, etc.

To set up and enable inventory and other workflows

This procedure continues on the Account Store Details page from the previous procedure, which was performed on the Settings tab.

  1. On the Account Store Details page, click the Inventory tab, where you can specify the following settings:
    • Start and End dates — Specify a start and end date to run inventory on the system. Otherwise, it starts on the current date and runs for ten years (or indefinitely). 
    • Run Indefinitely — Selected by default, this allows inventory to run until it is intentionally disabled.
    • Inventory Schedule Interval — Select one of the following values to set the type of interval to use:
      • Once runs inventory once and then stops.
      • Hour Interval runs inventory every so many hours, as specified in the Interval box.
      • Weekly runs inventory every so many weeks, as specified in the Interval box.
      • Minute Interval runs inventory every so many minutes, 10 by default, as specified in the Interval box.
      • Daily runs inventory every so many days, as specified in the Interval box.
      • Monthly runs inventory every so many months, as specified in the Interval box.
    • Interval — Specify the number of minutes, hours, days, weeks, or months after which to run inventory again after the most recent run. 
    • Inventory Next Compilation Time — Specify a date and time at which to run inventory next.
    • Inventory Batch Size — Specify the number of records to process in each batch, to avoid hanging up your system when large numbers of records are processed. 



  2. Once you have your settings in place, select the Inventory Enabled checkbox at the top and click Save to allow EmpowerID to take inventory of accounts in the external system.
  3. On the Membership tab, group membership reconciliation is enabled by default to run every ten minutes, indefinitely. Here, you can specify the following settings:
    • Start and End dates — Specify a start and end date to run inventory on the system. Otherwise, it starts on the current date and runs for ten years (or indefinitely). 
    • Run Indefinitely — Selected by default, this allows inventory to run until it is intentionally disabled.
    • Inventory Schedule Interval — Select one of the following values to set the type of interval to use:
      • Once runs inventory once and then stops.
      • Hour Interval runs inventory every so many hours, as specified in the Interval box.
      • Weekly runs inventory every so many weeks, as specified in the Interval box.
      • Minute Interval runs inventory every so many minutes, 10 by default, as specified in the Interval box.
      • Daily runs inventory every so many days, as specified in the Interval box.
      • Monthly runs inventory every so many months, as specified in the Interval box.
    • Interval — Specify the number of minutes, hours, days, weeks, or months after which to run inventory again after the most recent run. 



  4. On the Projection tab, you can enable resource role reconciliation and the intervals at which to run it with the same settings as group membership reconciliation above.
  5. On the Rights Inventory tab, you can enable inventory of rights in the native system and the intervals at which to run it with the same settings as group membership reconciliation above.
  6. On the Deleted Object Detection tab, you can set the following options and enable EmpowerID to detect deleted objects in the system:
    • Interval Minutes — Specify the number of minutes after the last check for deleted objects to run the check again.
    • Threshold Max # of Deleted Objects — Specify the maximum number of deleted objects.



  7. When you have finished, click Save.





In this article



  • No labels