You can use the LDAP policy to set the details of the LDAP server you wish to use to:

• authenticate gateway users (available in SSH and Telnet as Authentication Policy)

• query gateway groups (available for RDP, Telnet, SSH, and ICA)

• query remote groups (available for RDP, Telnet, SSH, ICA, and HTTP)

To configure an LDAP policy for a connection

1. Navigate to Policies > LDAP Servers and click to create a new LDAP policy.

   Figure 180: Policies > LDAP Servers — Configuring LDAP Server policies

   

2. Enter a name for the policy (for example ldapservers).

3. Select the type of your LDAP server in the Type field. Select:

   • Active Directory to connect to Microsoft Active Directory servers.

     You can enable nested groups. Select Enable AD group membership check, then Enable nested groups.

     Caution: Nested groups can slow down the query and cause the connection to timeout if the LDAP tree is very large. In this case, disable the Enable nested groups option.

     To also check group membership based on group DNs in a user attribute, select Enable checking for group DNs in user objects and enter the name of the user attribute, for example, memberOf in the User attribute of group DNs field.

     Caution: If you have too many groups, using this option significantly slows down logging in to the SPS web interface. Use this option only if you have an LDAP schema where the user groups can only be determined from a user attribute that contains the group DNs.

     To check for group membership based on user DNs in group attributes, use the Check the user DN in these groups options.

     For more information, see Active Directory LDAP backend.

   • POSIX to connect to servers that use the POSIX LDAP scheme.

     If your LDAP server uses a custom POSIX LDAP scheme, you might need to set which LDAP attributes store the username, or the attributes that set group memberships. For example, if your LDAP scheme does not use the uid attribute to store the usernames, set the Username (user ID) attribute name option.

     In addition to the primary group membership checking, you can allow checking for supplementary group memberships by selecting Enable POSIX group membership check and specifying the POSIX group membership attribute name field.

     To also check group membership based on group Distinguished Names (DNs) in a user attribute, select Enable checking for group DNs in user objects. Then, enter the name of the user attribute (for example, memberOf) in the User attribute of group DNs field, and objectClass (for example, groupOfNames) in the Group objectClass field.

     Caution: If you have too many groups, using this option significantly slows down logging in to the SPS web interface. Use this option only if you have an LDAP schema where the user groups can only be determined from a user attribute that contains the group DNs.

     To check for group membership based on user DNs in group attributes, use the Check the user DN in these groups option.

     For more information, see POSIX LDAP backend.

     For an overview about LDAP user and group resolution in SPS, see Overview.

4. Enter the IP address/hostname and the port of the LDAP server in the respective text boxes.

   Consider the following when specifying the address information:

   • If you want to encrypt the communication between SPS and the LDAP server, use the following port numbers:

     • For TLS, specify 636 as the port number.

     • For STARTTLS, specify 389 as the port number.

   • Use an IPv4 adress or a hostname.

   • To add multiple servers, click and enter the address of the next server. If a server is unreachable, SPS will try to connect to the next server in the list in failover fashion.

   • When you configure the location of the LDAP server, that is, the IP address or hostname and the port number, you can use a Service record (SRV record), which is a type of information record in the DNS that maps the name of a service to the DNS name of the server. SRV records have the following format: _ldap._tcp.<SITE_NAME>._sites.dc._msdcs.<DOMAIN.NAME> in the Address field. SPS looks up of the SRV record during committing the configuration change.

     For more information on SRV records, see the relevant Microsoft documentation.

   • Caution: If you connect to the LDAP server over a TLS-encrypted connection with certificate verification, you must fill the Address field with a name or IP address, which must be present in the certificate.

5. In the User Base DN field, enter the name of the DN to be used as the base of queries regarding users (for example: OU=People,DC=demodomain,DC=exampleinc).

   NOTE: This field is mandatory. You can use the same value for the User Base DN and the Group Base DN settings.

   To speed up LDAP operations, specify a sufficiently narrow base for the LDAP subtrees where users and groups are stored.

6. In the Group Base DN field, enter the name of the DN to be used as the base of queries regarding groups (for example: OU=Groups,DC=demodomain,DC=exampleinc).

   NOTE: This field is mandatory. You can use the same value for the User Base DN and the Group Base DN settings.

   To speed up LDAP operations, specify a sufficiently narrow base for the LDAP subtrees where users and groups are stored.

7. In the Bind DN field, enter the Distinguished Name that SPS must use to bind to the LDAP directory (for example: CN=Administrator,DC=demodomain,DC=exampleinc).

   NOTE: SPS accepts both pre Windows 2000-style and Windows 2003-style account names, or User Principal Names (UPNs). For example, administrator@example.com is also accepted.

8. To configure or change the password to use when binding to the LDAP server, click Change and enter the password. Click Update. Click Commit.

   NOTE: SPS accepts passwords that are not longer than 150 characters and supports the following characters:

   • Letters A-Z, a-z

   • Numbers 0-9

   • The space character

   • Special characters: !"#$%&'()*+,-./:;<>=?@[]\^-`{}_|

9. Skip this step if you use passwords to authenticate the users.

   • If you use public-key authentication and receive the public key of the users from the LDAP database, enter the name of the LDAP attribute that stores the public keys of the users into the Publickey attribute name field. For details on using public-key authentication with the LDAP database, see Configuring public-key authentication on One Identity Safeguard for Privileged Sessions (SPS).

   • If you use X.509 certificate for authentication and receive the certificates of the users from the LDAP database, enter the name of the LDAP attribute that stores the certificates of the users into the Certificate attribute name field.

10. Skip this step if you use passwords to authenticate the users.

    • If you use public-key authentication and want SPS to generate server-side encryption keys on-the-fly and store them in a separate attribute on the LDAP server, enter the name of the attribute into the Generated publickey attribute name field.

    • If you use certificate authentication and want SPS to generate server-side certificates on-the-fly and store them in a separate attribute on the LDAP server, enter the name of the attribute into the Generated certificate attribute name field.

11. If you want to encrypt the communication between SPS and the LDAP server, in Encryption, select the TLS or the STARTTLS option and complete the following steps:

    Figure 181: Policies > LDAP Servers — Configuring encryption

    

    NOTE: TLS-encrypted connection to Microsoft Active Directory is supported only on Windows 2003 Server and newer platforms. Windows 2000 Server is not supported.

    Verify the certificate of the server

    • If you want SPS to verify the certificate of the server, select Only accept certificates authenticated by the Trust Store and select a trust store in the Trust Store field.

      SPS will use the selected trust store to verify the certificate of the server, and reject the connections if the verification fails.

      Caution: SPS checks if the certificate revocation list (CRL) has expired and that the CRL has been signed by the same certificate authority (CA).

      Caution: If you connect to the LDAP server over a TLS-encrypted connection with certificate verification, you must fill the Address field with a name or IP address, which must be present in the certificate.

      Authenticate as client

    • If the LDAP server requires mutual authentication, that is, it expects a certificate from SPS, enable Authenticate as client. Generate and sign a certificate for SPS, then click in the Client X.509 certificate field to upload the certificate. After that, click in the Client key field and upload the private key corresponding to the certificate.

    TIP: One Identity recommends using 2048-bit RSA keys (or stronger).

12. To commit the changes, click .

13. Click Test to test the connection.

    NOTE: Testing TLS and STARTTLS-encrypted connections is not supported.