This section describes how to configure POSIX LDAP servers.

To create a new POSIX LDAP server

  1. To create a POSIX LDAP server, navigate to Users & Access Control > Login options > Manage AD/LDAP Servers, click Add new server and select POSIX LDAP.

    Figure 131: Users & Access Control > Login Options > Manage AD/LDAP Servers — POSIX LDAP

  2. In the Name field, enter the server name.

  3. 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 mode.

    • 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 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.

  4. Configure POSIX settings.

    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.

  5. Configure the options of the Distinguished Names field.

    • 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.

    • 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.

    • 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.

  6. If you want to encrypt the communication between SPS and the LDAP server, in Encryption, select the TLS or the STARTTLS option and verify the certificate of the server.

    • If you want SPS to verify the certificate of the server, under Certificate requirements, select Trust Store.

      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.

    • If the LDAP server requires mutual authentication, that is, it expects a certificate from SPS, enable Authenticate as a client. Generate and sign a certificate for SPS, upload the certificate and its private key, and click Save.

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

  7. To save your modifications, click Commit.

    NOTE: You must configure the usergroups in SPS, and possibly in your LDAP database. For details on using usergroups, see Using usergroups.