Selecting the authentication method

  1. Once you have finished specifying your connection parameters in the Connection tab, click Authentication.

  2. Provide the full DN of the user account you will use to connect to the LDAP server to import users, groups, and check user credentials in the Lookup DN field. A few examples follow.


    Tip: We recommend a read-only user account.

  3. Provide the password of the account in the Lookup Password field.

  4. Select one of the following.

  5. Refer to the section that corresponds to your selection.

Specifying simple bind parameters

  1. Type a DN template that the external LDAP directory can use to locate user accounts in the User DN Template field. This string must include %(username)s, which DC/OS will replace with the user name provided by the user at login. Some examples follow.

  2. When you have completed your entries, the dialog should look something like the following.

  3. Click Add Directory.

  4. Verify your connection.

Specifying search/bind parameters

While the simple bind connection takes place in a single step, the search/bind operation requires two steps. First the directory is searched for the user name attribute. If located, a bind operation ensues to check the user’s credentials against the external directory.

  1. In the User Search Base field, specify where in the directory to begin the search for the LDAP user name. This should be the DN of the search base object. Example: cn=Users,dc=example,dc=com

  2. Specify the template for translating the LDAP user name to a valid LDAP search filter in the User Search Filter Template field. Must contain the following placeholder: %(username)s Examples:

    • (sAMAccountName=%(username)s)
    • (uid=%(username)s)
  3. When you have completed your entries, the dialog should look something like the following.

  4. Click Add Directory.

  5. Verify your connection.