This integration requires a license of Stoplight. If you are not currently a Stoplight customer and would like to use this functionality, please contact our Sales team for a demo.
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
From the Admin Settings
From the External Services Screen
Registering the LDAP Provider
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.