Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Configurar la autenticación y autorización de usuarios con LDAP

Nota

A partir de MongoDB 8.0, la autenticación y autorización de LDAP están desactualizadas. La funcionalidad está disponible y continuará operando sin cambios durante toda la vigencia de MongoDB 8. LDAP será eliminado en una futura versión principal.

Para más detalles, consulta Obsolescencia de LDAP.

Nota

Esta característica no está disponible para ninguna de las siguientes implementaciones:

  • Clústeres gratuitos

  • Clústeres Flex

Para obtener más información, consulta Límites.

Atlas ofrece la capacidad de gestionar la autenticación y autorización de los usuarios desde todos los clientes de MongoDB usando su propio servidor de Protocolo ligero de acceso a Directorios (LDAP) a través de TLS. Una única configuración de LDAPS (LDAP sobre TLS) se aplica a todos los clústeres de un proyecto.

Si habilita la autorización de usuario con LDAP, puede crear grupos LDAP en la base de datos admin mediante la asignación de grupos LDAP a roles de MongoDB en sus bases de datos de Atlas. Para utilizar los grupos LDAP de manera efectiva, crea proyectos adicionales dentro de Atlas para controlar el acceso a implementaciones específicas en tu organización, como la creación de proyectos de Atlas separados para entornos de desarrollo y producción. Luego puede asignar un grupo LDAP a un rol en el Proyecto Atlas para proporcionar acceso a la implementación deseada.

Nota

Cuando habilitas la autorización de usuarios y un usuario LDAP no pertenece a ningún grupo LDAP, Atlas no asigna ningún rol de base de datos al usuario. Cuando habilitas la autenticación de usuarios y deshabilitas la autorización de usuarios, Atlas asigna roles de base de datos de MongoDB al usuario LDAP.

Si tienes varios departamentos con sus propias necesidades de facturación, configuraciones de alertas y miembros de proyectos, considera crear un nuevo conjunto de proyectos o una nueva organización para cada departamento o unidad empresarial.

Nota

Una explicación de LDAP está fuera del alcance de la documentación de MongoDB. Haga una revisión de RFC 4515 y RFC 4516 o consulte su documentación preferida de LDAP.

Para gestionar usuarios o grupos de LDAP, debe tener acceso de Organization Owner o Project Owner a Atlas.

Debe cumplir con los siguientes prerrequisitos para gestionar la autenticación y autorización de usuario utilizando LDAP en Atlas:

  • Clúster de Atlas utilizando MongoDB 7.0 o posterior.

  • Servidor LDAP que utiliza TLS y al cual tus clústeres de Atlas pueden acceder a través de la red, utilizando una conexión de emparejamiento de VPC o VNet o la dirección IP pública de los nodos del clúster.

  • Las membresías de grupo de LDAP están incorporadas como un atributo para cada usuario en la entrada LDAP solo para autorización de usuarios.

Para que tu servicio LDAPS acceda a los clústeres de Atlas, MongoDB recomienda una de dos configuraciones:

Uso de una VPC o VNet:

  1. Ejecute su servidor LDAP en una VPC o VNet.

  2. Establece una conexión de emparejamiento con tu proyecto de Atlas.

  3. Utiliza un FQDN público que resuelva a la dirección IP privada de tu servidor LDAP.

Utilizando su centro de datos:

  1. Ejecutar su LDAP servidor con un FQDN público que resuelva a una dirección IP pública.

  2. Configura el servidor LDAP para permitir el acceso entrante desde las direcciones IP públicas de los nodos del clúster Atlas y las direcciones IP de Atlas Gateway. El tráfico LDAP puede originarse tanto en el nodo de datos como en Atlas Gateway, por lo que debe incluir ambos conjuntos de direcciones IP en su lista de acceso.

Cuando habilites la autenticación y autorización LDAP, ten en cuenta lo siguiente:

No puede usar tanto la autenticación LDAP como SCRAM para el mismo usuario de base de datos.

No se puede utilizar la autenticación OIDC cuando la autorizacion LDAP está habilitada. Cuando se habilita la autorización LDAP, el servidor LDAP gestiona todas las decisiones de autorización, incluso para cualquier mecanismo externo de autenticación. Por lo tanto, si se intenta conectar a Atlas utilizando OIDC, la conexión falla. Debe inhabilitar la autorizacion LDAP para poder utilizar la autenticación OIDC.

Si habilitas la autorización LDAP, no podrás conectarte a tus clústeres con usuarios que se autentican con un certificado X.509 gestionado por Atlas.

Después de activar la autorización LDAP,puedes conectarte a tus clústeres con usuarios que se autentiquen con un certificado autogestionado X..509 Sin embargo, el Nombre Común del usuario en su certificado X.509 debe coincidir con el Nombre Distinguido de un usuario que esté autorizado para acceder a su base de datos con LDAP.

Atlas utiliza el nombre distinguido (DN) completo de los usuarios en su servidor LDAP como nombre de usuario de Atlas. Por ejemplo, un ejemplo de usuario LDAP llamado ralph tiene el siguiente nombre de usuario en Atlas:

cn=ralph,cn=Users,dc=aws-atlas-ldap-01,dc=myteam,dc=com

Si el administrador habilita la autenticación de usuario o tanto la autenticación de usuario como la autorización con LDAP, los usuarios de la base de datos deben anular los siguientes parámetros en la cadena de conexión para sus clientes.

  • authSource debe ser $external

  • authenticationMechanism debe ser PLAIN

Ejemplo

La siguiente cadena de conexión para mongosh autentica a un usuario LDAP llamado rob:

mongosh "mongodb+srv://cluster0-tijis.mongodb.net/test?authSource=%24external" \ --authenticationMechanism PLAIN \ --username cn=rob,cn=Users,dc=ldaps-01,dc=myteam,dc=com

Para copiar la cadena de conexión:

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

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

2

Haga clic en Connect.

3

Edita la string con tu User DN y la contraseña.

Nota

Si sus contraseñas, nombres de bases de datos o cadenas de conexión contienen caracteres URI reservados, debe reemplazar dichos caracteres. Por ejemplo, si su contraseña es @bc123, debe reemplazar el carácter @ al especificar la contraseña en la cadena de conexión, como %40bc123. Para obtener más información, consulte los Caracteres especiales en la contraseña de la cadena de conexión.

Puedes usar direcciones IP públicas que remitan a otras direcciones IP internas o privadas utilizando la traducción de direcciones de red para permitir el tráfico de Atlas a tu servidor LDAP. Si haces esto, ten en cuenta que ciertas actividades desencadenan un cambio en las direcciones IP públicas del clúster de Atlas.

Si permitiste el acceso al servidor LDAP en función de las direcciones IP públicas, los cambios en la dirección IP pública del clúster de Atlas impedirán el acceso a LDAP. Para restaurar el acceso LDAP, agregue las nuevas direcciones IP públicas del clúster de Atlas a la lista de acceso de LDAP.

Nota

Puede utilizar el mismo comando CLI de Atlas para configurar la autenticación LDAP y la autorización LDAP.

Para guardar una configuración LDAP para el proyecto que especifiques usando la Atlas CLI, ejecuta el siguiente comando:

atlas security ldap save [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulte la documentación de la CLI de Atlas para atlas seguridad ldap save.

Nota

Puede utilizar el mismo comando CLI de Atlas para configurar la autenticación LDAP y la autorización LDAP.

Para guardar una configuración LDAP para el proyecto que especifiques usando la Atlas CLI, ejecuta el siguiente comando:

atlas security ldap save [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulte la documentación de la CLI de Atlas para atlas seguridad ldap save.

Para crear un usuario de base de datos para su proyecto usando Atlas CLI, ejecute el siguiente comando:

atlas dbusers create [builtInRole]... [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulta la documentación de la CLI de Atlas para atlas dbusers create.

Para devolver los detalles de una configuración de LDAP usando la CLI de Atlas, ejecuta el siguiente comando:

atlas security ldap get [options]

Para obtener más información sobre la sintaxis de los comandos y los parámetros, consulte la documentación de Atlas CLI para atlas security ldap get.

Nota

Puedes usar el mismo comando CLI de Atlas para desactivar la configuración de autenticación LDAP y la configuración de autorizacion LDAP.

Para borrar una configuración LDAP usando Atlas CLI, ejecuta el siguiente comando:

atlas security ldap delete [options]

Para obtener más información sobre la sintaxis del comando y los parámetros, consulta la documentación de la Atlas CLI para Atlas seguridad LDAP borrar.

Utiliza los siguientes tutoriales para configurar Atlas para autenticar y autorizar usuarios de proveedores de LDAP de terceros: