Nota
Comenzando con MongoDB 8.0, La autenticación y autorización LDAP está obsoleta. La funcionalidad está disponible y seguirá funcionando sin cambios durante toda la vida útil de MongoDB 8. LDAP será removido en una próxima versión importante.
Para obtener más detalles, consulte Desuso de LDAP.
Nota
Esta característica no está disponible para ninguna de las siguientes implementaciones:
Clústeres gratuitos
Clústeres Flex
Para aprender más, Límites.
Esta guía le muestra cómo habilitar Atlas para autenticar y autorizar usuarios de bases de datos (no usuarios de Atlas) desde OneLogin, un proveedor LDAP de terceros.
Puedes habilitar solo la autenticación LDAP o puedes habilitar tanto la autenticación como la autorización LDAP:
Si solo habilitas la autenticación LDAP, puedes añadir usuarios individuales a Atlas y asignar privilegios de acceso a bases de datos a cada usuario que añadas.
Si habilitas la autenticación y autorización LDAP, agregas grupos de usuarios a Atlas y asignas privilegios de acceso a la base de datos a cada grupo. Los usuarios heredan los privilegios de acceso a la base de datos del grupo LDAP al que pertenecen.
Atlas es compatible con la autenticación y autorización de usuarios de bases de datos desde OneLogin.
Limitaciones
Debes implementar
M10o clústeres de Atlas más grandes para habilitar la integración LDAP. La integración LDAP es una característica de Atlas Enterprise.Atlas no admite la autenticación y autorización de usuarios sincronizados desde directorios LDAP existentes.
Atlas no admite la integración del inicio de sesión único para usuarios de bases de datos. Para obtener más información sobre la integración del inicio de sesión único para la interfaz web administrativa de Atlas, consulte Configurar la autenticación federada.
Acceso requerido
Para administrar usuarios o grupos de LDAP, debes tener acceso Organization Owner o Project Owner a Atlas.
Procedimientos
Configurar OneLogin para la autenticación LDAP
El siguiente procedimiento configura OneLogin para la autenticación con Atlas:
Configure el servicio LDAP de OneLogin.
Para obtener más información sobre cómo configurar el servicio de LDAP de OneLogin, consulte la documentación de OneLogin.
Importante
Es posible que tengas que ponerte en contacto con el soporte de OneLogin para habilitar el servicio VLDAP en tu cuenta.
Toma nota de tu
<onelogin-instance-id>. Deberás proporcionarlo en varios lugares durante el proceso de configuración.El nombre de la instancia se encuentra en la URL que utiliza para iniciar sesión en su cuenta de OneLogin:
https://<onelogin-instance-id>.onelogin.com
Añade direcciones IP a la lista de acceso IP.
En OneLogin, haga clic en Authenticationy haga clic en VLDAP. Agrega lo siguiente al campo Allow access by IP address para agregarlos a la lista de acceso IP:
La dirección IP de cada nodo del clúster Atlas. Utilice
nslookuppara obtener la dirección IP de cada host del clúster, utilizando los nombres de host generados por Atlas:nslookup cluster0-shard-00-00-example.mongodb.net Nota
Si las direcciones IP de cualquiera de tus nodos cambian, debes actualizar la lista de acceso IP con las nuevas direcciones IP.
(Opcional) La dirección IP de una máquina desde la que se pueden ejecutar comandos
ldapsearchpara resolver problemas de conexión LDAP.
Crea un usuario de vinculación.
Crea un nuevo usuario de OneLogin para utilizarlo como el usuario de vinculación de Atlas. El usuario de enlace es un usuario de OneLogin que se utiliza para consultar la cuenta y autenticar las credenciales de los usuarios de la base de datos cuando se conectan a una base de datos de Atlas.
Los campos Email y Username son obligatorios cuando creas el usuario de vinculación. Debes ingresar la misma dirección de correo electrónico en ambos campos.
Importante
No utilice su propia cuenta de usuario para el usuario vinculado.
Utilice la siguiente plantilla para determinar el nombre distinguido completo (DN) de su usuario de enlace:
cn=<bind-user-email>,ou=users,dc=<onelogin-instance-id>,dc=onelogin,dc=com Por ejemplo, si su
<bind-user-email>esbind@example.comy su<onelogin-instance-id>esmdb-example, el nombre distinguido del usuario de enlace es:cn=bind@example.com,ou=users,dc=mdb-example,dc=onelogin,dc=com
Asignar privilegios al usuario de vinculación.
En OneLogin, asigne al usuario vinculado el privilegio Manage users, Manage group o Super user.
Nota
Si le otorga al usuario de enlace el privilegio de Manage group, debes seleccionar un grupo. Atlas solo puede autenticar y autorizar a los usuarios de LDAP que pertenezcan a este grupo.
Navegue a su página de Usuarios de OneLogin.
Haz clic en el usuario de enlace.
Haga clic en Add Privilege.
Selecciona el privilegio que deseas otorgar al usuario y luego haz clic en Continue.
Haga clic en Save User.
Crea usuarios de base de datos en OneLogin.
Si aún no existen, cree usuarios en OneLogin a los que desea otorgar acceso a la base de datos:
Navegue a su página de usuarios de OneLogin.
Haga clic en New User.
Introduzca los datos del usuario.
Los campos Email y Username son obligatorios cuando creas usuarios de base de datos. Introduzca la misma dirección de correo electrónico en ambos campos.
Nota
Evita introducir direcciones de correo electrónico con símbolos de suma (
+). La integración LDAP de Atlas puede encontrar problemas con direcciones de correo electrónico que contienen el símbolo más.Haga clic en Save User.
Establece las contraseñas de los usuarios de base de datos en OneLogin.
Si aún no lo ha hecho, establezca una contraseña para cada usuario de la base de datos en OneLogin:
Navegue a su página de usuarios de OneLogin.
Haz clic en el usuario para el que deseas establecer una contraseña.
Hacer clic en More Actions, luego hacer clic en Change Password.
Introduzca una contraseña y haga clic en Update.
Configurar Atlas para la autenticación LDAP
El siguiente procedimiento permite a Atlas autenticar usuarios de bases de datos desde OneLogin LDAP:
En Atlas, ve a la página Advanced de tu proyecto.
Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Database & Network Access en la sección Security.
En la barra lateral, haga clic en Advanced.
La página Avanzada se muestra.
Cambie el botón junto LDAP Authentication a On a.
Nota
Es posible que incurras en costos adicionales al habilitar esta funcionalidad. Consulte Seguridad avanzada.
Agregar un usuario al mapeo de DN.
Agregue una asignación de DN para el usuario similar al siguiente ejemplo para permitir que los clientes proporcionen sus direcciones de correo electrónico en lugar de nombres distinguidos completos cuando se conectan a las bases de datos de Atlas:
[ { "match": "(.+)", "substitution": "cn={0},ou=users,dc=<onelogin_instance_id>,dc=onelogin,dc=com" } ]
En Atlas, ve a la página Database & Network Access de tu proyecto.
Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Database & Network Access en la sección Security.
La página Acceso a la base de datos y a la red se muestra.
Agrega usuarios de LDAP a Atlas
Nota
Saltar este paso si deseas habilitar la autorizacion LDAP.
Añade usuarios gestionados en OneLogin LDAP a Atlas.
Haga clic en Add New Database User.
Haga clic en LDAP User.
Realice una de las siguientes acciones:
Si no has ingresado un User to DN Mapping, ingresa el nombre distinguido completo del usuario LDAP. Sigue esta plantilla:
cn=<user-name>,ou=users,dc=<onelogin-instance-id>,dc=onelogin,dc=com Por ejemplo, si su
<user-name>esjane@example.comy su<onelogin-instance-id>esmdb-example, el nombre distinguido del usuario de enlace es:cn=jane@example.com,ou=users,dc=mdb-example,dc=onelogin,dc=com Si ingresaste un User to DN Mapping, introduce el nombre de usuario o la dirección de correo electrónico que requiere tu asignación.
Selecciona el nivel de acceso a la base de datos que se concederá al usuario.
Haga clic en Add User.
Configura OneLogin para la autorizacion LDAP
Nota
Omita esta sección si no desea habilitar la autorización LDAP.
El siguiente procedimiento configura Atlas para autorizar a los usuarios que pertenezcan a los grupos de acceso a la base de datos LDAP de OneLogin.
Importante
Debe activar la autenticación con LDAP antes de activar la autorización.
Cuando habilitas y configuras la autorización LDAP, los usuarios de la base de datos que solo están configurados para la autenticación LDAP ya no podrán acceder a las bases de datos.
Crear grupos de acceso a la base de datos de OneLogin.
Atlas LDAP autorizacion LDAP utiliza grupos LDAP para determinar si los usuarios están autorizados a realizar acciones en la base de datos.
Crear grupos OneLogin separados para cada nivel de acceso que se desee otorgar a los usuarios. Por ejemplo, puedes crear un grupo para el acceso de sólo lectura a una base de datos, otro para el acceso de lectura y escritura, y así sucesivamente.
Navega a la página de tus grupos de OneLogin.
Haga clic en New Group.
Introduce un nombre de grupo, por ejemplo
db-read.Haga clic en Save.
Agrega usuarios de OneLogin a los grupos de acceso a la base de datos.
Asigne usuarios a grupos en función del nivel de acceso que cada usuario requiera.
Navegue a su página de Usuarios de OneLogin.
Haga clic en el usuario que desea agregar a un grupo.
Haz clic en la pestaña Authentication.
Seleccione el grupo al que desea agregar el usuario.
Haga clic en Save User.
Configurar Atlas para la autorización LDAP
Nota
Omita esta sección si no desea habilitar la autorización LDAP.
El siguiente procedimiento agrega los grupos de acceso a la base de datos de OneLogin a Atlas y habilita la autorización de usuarios de la base de datos en Atlas:
En Atlas, ve a la página Database & Network Access de tu proyecto.
Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Database & Network Access en la sección Security.
La página Acceso a la base de datos y a la red se muestra.
Agregue los grupos LDAP de acceso a la base dedatos a Atlas.
Agregue a Atlas cada uno de los grupos de bases de datos de OneLogin que creó. Los miembros de los grupos que agregue tendrán autorización para realizar las acciones de base de datos asignadas al grupo.
Haga clic en Add New Database User.
Haz clic en LDAP Group y, a continuación, introduce el nombre distinguido completo del grupo que contiene a los usuarios de tu base de datos, incluso si activaste User to DN Mapping. Sigue esta plantilla:
cn=<group-name>,ou=groups,dc=<onelogin-instance-id>,dc=onelogin,dc=com Por ejemplo, si su
<group-name>esdb-ready su<onelogin-instance-id>esmdb-example, el nombre distinguido del usuario de enlace es:cn=db-read,ou=groups,dc=mdb-example,dc=onelogin,dc=com
Seleccione el nivel de acceso a la base de datos que desea otorgar a los usuarios de este grupo.
Haga clic en Add User.
En Atlas, ve a la página Advanced de tu proyecto.
Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Database & Network Access en la sección Security.
En la barra lateral, haga clic en Advanced.
La página Avanzada se muestra.
Ingresa una plantilla de consulta en Query Template.
Cuando un usuario intenta realizar una acción, Atlas ejecuta la plantilla de consulta LDAP para obtener los grupos LDAP a los que pertenece el usuario autenticado. Atlas permite la acción si la consulta devuelve al menos un grupo autorizado para realizarla. Atlas no permite la acción si la consulta no devuelve ningún grupo autorizado para realizarla.
Atlas sustituye el nombre de usuario autenticado en el marcador de posición {USER} cuando ejecuta la query. La consulta es relativa al host especificado en Server Hostname.
El formato de la consulta debe cumplir con RFC4515 y RFC.4516
Introduzca el siguiente Query Template:
{USER}?memberOf?base
Nota
También pueden funcionar otras plantillas de consultas.
Conéctese a su clúster usando mongosh
El siguiente procedimiento verifica que la autenticación LDAP (y la autorización LDAP, si está habilitada) esté configurada correctamente:
Nota
Cuando la autenticación LDAP está habilitada, los usuarios de la base de datos deben anular los siguientes parámetros en la cadena de conexión para sus clientes:
authSourcedebe ser$externalauthenticationMechanismdebe serPLAIN
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Conéctate a tu clúster con las credenciales de usuario que agregaste en Atlas.
Utiliza mongosh para conectarte a tu clúster. Para copiar la cadena de conexión:
Haga clic en Connect.
Haz clic en LDAP y después en Copy.
Pega y edita la string con tu Nombre Distinguido de Usuario (DN) y contraseña.
Nota
Conéctate a tu clúster con el nombre distinguido completo de un usuario si la asignación de usuario a nombre distinguido no está habilitada.
Solucionar problemas de conexión LDAP
Nota
agregue el host desde el que está ejecutando ldapsearch a su lista de acceso IP antes de solucionar problemas de conexión de OneLogin.
Usa ldapsearch para determinar si la plantilla de query que se te configuró en Atlas devuelve los DN de usuario tal como esperabas. La plantilla de consulta puede no estar devolviendo los DN de usuarios correctos si la autenticación LDAP funciona, pero la autorización LDAP no.
Utilice la siguiente plantilla ldapsearch:
ldapsearch -H 'ldaps://ldap.us.onelogin.com:636' -D '<bind_user_dn>' -w '<bind_user_pwd>' -b 'dc=<onelogin_instance_id>,dc=onelogin,dc=com' -s sub
Por ejemplo, si tu bind-user-dn es cn=jane@example.com,ou=users,dc=mdb-example,dc=onelogin,dc=com y tu <onelogin-instance-id> es mdb-example, utiliza el siguiente comando:
ldapsearch -H 'ldaps://ldap.us.onelogin.com:636' -D 'cn=jane@example.com,ou=users,dc=mdb-example,dc=onelogin,dc=com' -w '<REDACTED>' -b 'dc=mdb-example,dc=onelogin,dc=com' -s sub
Nota
También pueden funcionar otras plantillas de consultas.