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.


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


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:


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.