Configure a Lightweight Directory Access Protocol (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 click System Settings.

  2. Navigate to the Authentication tab and click Edit.

  3. Click Add, and select LDAP.

    settings auth ldap

    Result: The Authentication dialog opens.

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

    1. Enter a Name for the authentication.

    2. Check Active to activate this authentication method.

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

    4. Enter a Description.

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

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

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

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

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

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

    11. 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. Click OK.

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

Results

  • You have configured and activated an LDAP authentication.

Related topics