MongoDB Enterprise ofrece compatibilidad con la autenticación de usuarios mediante proxy. Esto permite a los administradores configurar un clúster de MongoDB para autenticar usuarios mediante el envío de solicitudes de autenticación a un servicio LDAP (Protocolo ligero de acceso a directorios) específico.
Nota
Para los binarios de MongoDB 4.2 Enterprise vinculados con
libldap (como cuando se ejecuta en RHEL), el acceso a libldap está sincronizado, lo que genera algunos costos de rendimiento/latencia.
Para los binarios de MongoDB 4.2 Enterprise vinculados con libldap_r, no hay ningún cambio en el comportamiento respecto de las versiones anteriores de MongoDB.
Considerations
Advertencia
MongoDB Enterprise para Windows no admite el enlace a través de saslauthd.
Los servidores MongoDB de Linux admiten la vinculación a un servidor LDAP a través del demonio
saslauthd.Utilice conexiones seguras, cifradas o de confianza entre los clientes y el servidor, así como entre
saslauthdy el servidor LDAP. El servidor LDAP utiliza elSASL PLAINmecanismo, enviando y recibiendo datos en texto sin formato. Debe utilizar únicamente un canal de confianza, como una VPN, una conexión cifrada con TLS/SSL o una red cableada de confianza.
Configurar saslauthd
La compatibilidad de LDAP con la autenticación de usuarios requiere una configuración adecuada del proceso demonio saslauthd así como del servidor MongoDB.
Especificar el mecanismo.
En los sistemas que configuran saslauthd con el archivo /etc/sysconfig/saslauthd, como Red Hat Enterprise Linux, Fedora, CentOS, y Amazon Linux AMI, configura el mecanismo MECH en ldap:
MECH=ldap
En los sistemas que configuran saslauthd con el archivo /etc/default/saslauthd, como Ubuntu, configure la opción MECHANISMS en ldap:
MECHANISMS="ldap"
Ajustar el comportamiento del almacenamiento en caché.
En ciertas distribuciones de Linux, saslauthd comienza con el almacenamiento en caché de las credenciales de autenticación habilitado. Hasta que se reinicie o caduque la caché, saslauthd no contactará con el servidor LDAP para volver a autenticar a los usuarios en su caché de autenticación. Esto permite saslauthd que autentique correctamente a los usuarios en su caché, incluso si el servidor LDAP está inactivo o si se revocan las credenciales de los usuarios almacenados en caché.
Para establecer el tiempo de expiración (en segundos) para el caché de autenticación, consulte la opción -tde.saslauthd
Configurar las opciones LDAP con ActiveDirectory.
Si el saslauthd.conf archivo no existe, créelo. El saslauthd.conf archivo suele residir en la /etc carpeta. Si especifica una ruta de archivo diferente, consulte la opción -O saslauthdde.
Para utilizar con ActiveDirectory, inicie saslauthd con las siguientes opciones de configuración establecidas en el archivo saslauthd.conf:
ldap_servers: <ldap uri> ldap_use_sasl: yes ldap_mech: DIGEST-MD5 ldap_auth_method: fastbind
Para <ldap uri>, especifique la URI del servidor LDAP. Por ejemplo, ldap_servers: ldaps://ad.example.net.
Para obtener más información sobre la saslauthd configuración de, consulte http://www.openldap.org/doc/admin24/guide.html#Configuringsaslauthd.
Pruebe la saslauthd configuración.
Utiliza la utilidad testsaslauthd para probar la configuración saslauthd. Por ejemplo:
testsaslauthd -u testuser -p testpassword -f /var/run/saslauthd/mux
0: OK "Success"Indica una autenticación exitosa.0: NO "authentication failed"Indica un error de nombre de usuario, contraseña o configuración.
Modifique la ruta del archivo con respecto a la ubicación del directorio saslauthd en el sistema operativo host.
Importante
El directorio principal del archivo de socket de dominio Unix saslauthd especificado para security.sasl.saslauthdSocketPath o deben --setParameter saslauthdPath otorgarr-x permisos de lectura y ejecución () para:
El mongod o no pueden autenticarse exitosamente a través mongos de saslauthd sin el permiso especificado en el saslauthd directorio y su contenido.
Configurar MongoDB
Agregar usuario a MongoDB para autenticación.
Agregue el usuario a la $external base de datos en MongoDB. Para especificar sus privilegios, asígnele roles.
Para usar sesiones de cliente y garantías de coherencia causal con usuarios de autenticación $external (usuarios Kerberos, LDAP o X.509), los nombres de usuario no pueden superar los 10k bytes.
Por ejemplo, lo siguiente agrega un usuario con acceso de solo lectura a la base de datos records.
db.getSiblingDB("$external").createUser( { user : <username>, roles: [ { role: "read", db: "records" } ] } )
Agregue principales adicionales según sea necesario. Para obtener más información sobre la creación y administración de usuarios, consulte Comandos de administración de usuarios.
Configurar el servidor MongoDB.
Para configurar el servidor MongoDB para utilizar la saslauthd instancia para la autenticación de proxy, incluya las siguientes opciones al mongod iniciar:
--authopción de línea desecurity.authorizationcomando o configuración,authenticationMechanismsparámetro establecidoPLAINen, ysaslauthdPathparámetro establecido a la ruta al zócalo de dominio Unix de la instanciasaslauthd.Importante
El directorio principal del archivo de
saslauthdsocket de dominio Unix especificado ensecurity.sasl.saslauthdSocketPatho debe--setParameter saslauthdPathotorgarr-xpermisos de lectura y ejecución () para:El
mongodo no pueden autenticarse exitosamente a travésmongosdesaslauthdsin el permiso especificado en elsaslauthddirectorio y su contenido.
Si utiliza la authorization opción para aplicar la autenticación, necesitará privilegios para crear un usuario.
Utilice la saslauthd ruta de socket específica.
Para la ruta del socket,/<some>/<path>/saslauthd establezca saslauthdPath /<some>/<path>/saslauthd/muxen, como en el siguiente ejemplo de línea de comando:
mongod --auth --setParameter saslauthdPath=/<some>/<path>/saslauthd/mux --setParameter authenticationMechanisms=PLAIN
Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.
O si utiliza un archivo de configuración en formato YAML, especifique las siguientes configuraciones en el archivo:
security: authorization: enabled setParameter: saslauthdPath: /<some>/<path>/saslauthd/mux authenticationMechanisms: PLAIN
O, si utiliza el formato de archivo de configuración anterior:
auth=true setParameter=saslauthdPath=/<some>/<path>/saslauthd/mux setParameter=authenticationMechanisms=PLAIN
Utilice la ruta de socket de dominio Unix predeterminada.
Para utilizar la ruta de socket de dominio Unix predeterminada, establezca saslauthdPath en la cadena "" vacía, como en el siguiente ejemplo de línea de comando:
mongod --auth --setParameter saslauthdPath="" --setParameter authenticationMechanisms=PLAIN
Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.
O si utiliza un archivo de configuración en formato YAML, especifique las siguientes configuraciones en el archivo:
security: authorization: enabled setParameter: saslauthdPath: "" authenticationMechanisms: PLAIN
O, si utiliza el formato de archivo de configuración anterior:
auth=true setParameter=saslauthdPath="" setParameter=authenticationMechanisms=PLAIN
Incluye opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a la implementación o si los miembros de la implementación se ejecutan en diferentes hosts, se debe especificar la configuración net.bindIp.
Autenticar al usuario en mongosh.
Puede autenticarse desde la línea de comandos durante la conexión o conectarse primero y luego autenticarse utilizando el db.auth() método.
Para autenticarse al conectarse con,mongosh ejecute mongosh con las siguientes opciones de línea de comando, sustituyendo <host> y,<user> e ingrese su contraseña cuando se le solicite:
mongosh --host <host> --authenticationMechanism PLAIN --authenticationDatabase '$external' -u <user> -p
Como alternativa, conéctese sin proporcionar credenciales y luego llame al método en db.auth() la $external base de datos. Especifique el valor "PLAIN" en el mechanism campo, y el usuario y la contraseña en los user pwd campos y, respectivamente. Utilice el digestPassword valor predeterminado (),false ya que el servidor debe recibir una contraseña sin procesar para reenviarla saslauthd a, como en el siguiente ejemplo:
Tip
Puede usar el método junto con varios métodos o comandos de autenticación/gestión de usuarios para solicitar la contraseña en lugar de especificarla directamente en la llamada al método/comando. Sin embargo, puede especificarla directamente como lo hacía con versiones anteriores passwordPrompt() del mongo shell.
db.getSiblingDB("$external").auth( { mechanism: "PLAIN", user: <username>, pwd: passwordPrompt() // or cleartext password } )
Introduzca la contraseña cuando se lo pidan.
El servidor reenvía la contraseña en texto plano. En general, úsela solo en un canal confiable (VPN, TLS/SSL, red cableada confiable). Consulte Consideraciones.