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 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.


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.6 or later. Groups for which you have configured LDAPS can not create a cluster using a version of MongoDB before 3.6 or later.


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:


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.