Configure an LDAP authentication

In this topic, you learn how to set up authentication via LDAP and how to configure it in your cockpit. You must perform multiple tasks to enable the connection.

Prerequisites

  • There are no prerequisites.

Procedure

  1. In the Cockpit, go to Settings, and select System Settings.

  2. In the Authentication tab, select Edit.

  3. Select Add, and select LDAP.

    Result: The Authentication dialog opens.

  4. In LDAP, fill in or select the following fields:

    1. Enter a Name for the authentication.

    2. Select Active to activate this authentication method.

    3. Select Show on login page to display the authentication method on the login page.

    4. Enter a Description.

    5. To disable certificate validation by allowing unauthorized certificates for the authentication method, select Allow Unauthorized Certificates.

    6. Enter a Path to post login data. (Not applicable when the login screen is used, but a value needs to be assigned). For example: "If myldap" then full is:

      http://planet9server/user/logon/ldap/myldap

    7. In Url, enter the URI to the LDAP server.

    8. In Bind DN, enter the distinguished name. Bind DN is an object or user within LDAP to which you connect to obtain permissions, for example: uid=theapp,ou=users,dc=example,dc=org. If not specified, the admin client remains unbound.

      Providing an empty string might lead to an anonymous bind if permitted.

    9. In Bind Credentials, enter the password for the object or user specified in Bind DN.

    10. In Search Base, enter the base DN, used to search for users by username. Specifies the starting point in the directory for the LDAP search, for example: ou=users, dc=example, dc=org.

    11. In Filter for user login, enter filters for user login, to define who has access to the Neptune DXP - Open Edition.

    12. In Filter for groups on user login, enter filters for groups on user login, and a unique identifier to define who has access to the Neptune DXP - Open Edition.

  5. In Filter Search, you have the option to filter based on either a user or a group, utilizing specific search criteria.

  6. In Filter User, enter filters for users and a unique identifier to define who has access to the Neptune DXP - Open Edition.

  7. In User Mapping, enter the user details to map a specific user with their corresponding user mapping details.

  8. In Filter Group, enter filters for groups and a unique identifier to define who has access to the Neptune DXP - Open Edition.

  9. In Group Mapping, enter a name and a description for the group that you defined before.

  10. If required, in Auto Assignment, assign roles and groups that you have defined in the Role and Security Group tools in the Cockpit.

  11. Select OK.

  12. In System Settings, select Restart to activate LDAP authentication.

Results

  • You have configured and activated an LDAP authentication.

Related topics