Articles in this section

Configuring LDAP

  • Last updated

This article reviews how to configure LDAP authentication, which allows you to authenticate Stoplight users using a company LDAP provider (Active Directory, OpenLDAP, and more).

Before continuing, be sure to:

  • Contact the team responsible for your organization's LDAP configuration for the following pieces of information:
    • The fully-qualified URL of the LDAP provider
    • The admin connection DN
    • The corresponding password for the admin connection DN
  • Be logged in to Stoplight as an Administrator

From the Stoplight Landing Screen

Screen_Shot_2019-10-07_at_11.58.02_AM.png

From the Admin Settings

Screen_Shot_2019-10-07_at_12.04.12_PM.png

From the External Services Screen

Screen_Shot_2019-10-07_at_12.05.48_PM.png

Registering the LDAP Provider

Screen_Shot_2019-11-01_at_10.31.38_AM.png

A Note About Search Filters

Regarding the "Search Filter" configuration setting, note that the literal string {{username}} will be replaced with the authenticating user's provided username within the LDAP search. For example, if user "johndoe" is attempting to authenticate and the Search Filter is set to:

(uid={{username}})

The LDAP search will be performed for all users with the uid attribute of johndoe. For more information on LDAP search filters, please see the article here.

 

Next Steps

Now that you've configured LDAP, continue to Logging into Stoplight to verify that you can properly authenticate with your auth provider.

Related articles