- API >
- API Resources >
- LDAP Configuration
LDAP Configuration¶
Use the following endpoints to verify and save an LDAP configuration for an Atlas project. An LDAP configuration defines settings for Atlas to connect to your LDAP server over TLS/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 TLS/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. The resource and corresponding endpoints use the
term groups.
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 project. |
GET |
/api/atlas/v1.0/groups/{GROUP-ID} | Get the current LDAP configuration for an Atlas project. |
DELETE |
/api/atlas/groups/{GROUP-ID}/userSecurity | Delete the current userToDNMapping from the LDAP configuration
for an Atlas project. |