- API >
- API Resources >
- LDAP Configuration
LDAP Configuration¶
Use the following endpoints to verify and save an LDAP configuration for an Atlas group. An LDAP configuration defines settings for Atlas to connect to your LDAP server over SSL for user authentication and authorization. Your LDAP server must be visible to the internet or connected to your Atlas cluster with VPC Peering. In addition, your LDAP server must use SSL.
Note
You must have the Atlas Admin user privilege to use these
endpoints.
In addition, to configure user authentication and authorization with LDAPS, your cluster must run MongoDB 3.4+. Groups for which you have configured LDAPS can not create a cluster using a version of MongoDB before 3.4+.
Note
Groups and projects are synonymous terms. Your {GROUP-ID} is the
same as your project id. For existing groups, your group/project id
remains the same. This page uses the more familiar term group. The
endpoints are as stated on the page.
Base URL: https://cloud.mongodb.com/api/atlas/v1.0
Endpoints¶
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/atlas/v1.0/groups/{GROUP-ID}/userSecurity/ldap/verify | Request verification of an LDAP configuration. Use this endpoint to test your LDAP configuration details before saving them. |
GET |
/api/atlas/v1.0/groups/{GROUP-ID}/userSecurity/ldap/verify/{REQUEST-ID} | Retrieve the status of a request for verification of an LDAP configuration. |
PATCH |
/api/atlas/v1.0/groups/{GROUP-ID}/userSecurity | Save an LDAP configuration for a Atlas group. |
GET |
/api/atlas/v1.0/groups/{GROUP-ID} | Get the current LDAP configuration for an Atlas group. |