En MongoDB 7.0 y versiones posteriores, puede usar Workforce Identity Federation con un proveedor de identidad (proveedor de identidad) externo, como el proveedor de identidad de su empresa. La Federación de identidades de la fuerza laboral autentica y autoriza a su fuerza laboral, incluidos empleados, socios y contratistas.
Con Workforce Identity Federation, se puede:
Gestionar el acceso de la fuerza laboral a las implementaciones de MongoDB a través del proveedor de identidad que se tenga actualmente.
Aplica políticas de seguridad como la complejidad de la contraseña, la rotación de credenciales y la autenticación de múltiples factores en tu proveedor de identidad.
Solo puedes crear una Federación de Identidad de Workforce por proyecto, pero puedes editar o recrear la configuración en cualquier momento.
Acceso requerido
Para configurar la Federación de identidad de Workforce, debes tener acceso Project Owner a Ops Manager.
Requisitos previos
Debe cumplir estos requisitos previos:
mongosh1.9.1 o posterior.MongoDB 7.0 o posterior.
Al menos otro mecanismo de autenticación con el MongoDB Agent configurado.
Nota
El MongoDB Agent no puede conectarse a su implementación a través de OIDC. Debe habilitar otro mecanismo de autenticación para el MongoDB Agent. Si MongoDB Ops Manager no gestiona supervisión ni copia de seguridad, debes configurarlos manualmente para usar el mecanismo de autenticación alternativo.
Procedimientos
Para acceder a las implementaciones de MongoDB Ops Manager con la Federación de Identidad de la Fuerza Laboral, siga estos pasos:
Configurar un proveedor de identidad de Workforce (configuración única).
Configurar una aplicación de Proveedor de Identidad Externo
IMPORTANTE: Para restablecer la autenticación y la configuración de TLS de su proyecto, primero deje de gestionar las implementaciones de MongoDB que MongoDB Ops Manager gestiona en su proyecto.
Para configurar Workforce Identity Federation con OIDC, registrar la aplicación OIDC con un proveedor de identidad que admita el estándar OIDC. Ejemplos incluyen Microsoft Entra ID, Okta y Ping Identity.
Se puede configurar su aplicación OIDC para estos tipos de concesiones:
Flujo de código de autorización con PKCE
Flujo de autorización de dispositivos
MongoDB recomienda que se utilice el Flujo de códigos de autorización con PKCE para mayor seguridad. Se debe utilizar el Flujo de autorización de dispositivos solo si los usuarios necesitan acceder a la base de datos desde máquinas sin navegador.
Los pasos de registro de la aplicación OIDC pueden variar según el proveedor de identidad. Durante el registro de su aplicación, establezca estos elementos:
Los pasos genéricos de registro para su aplicación OIDC son los siguientes:
(Condicional) Agregar o permitir una reclamacióngroups si se autentica con grupos.
Para los grupos, este paso garantiza que los tokens de acceso contengan la información de membresía del grupo del usuario que se autentica. MongoDB utiliza los valores enviados en una reclamación de grupos para la autorización.
(Opcional) Se puede permitir que se actualicen los tokens si se desea que los clientes de MongoDB actualicen los tokens para una mejor experiencia de usuario.
(Opcional) Configurar la vida útil del token de acceso (reclamaciónexp ) para que se alinee con el tiempo de sesión de la conexión a la base de datos.
Después de registrar su aplicación, guarde los valores de issuer, clientId y audience para usar en la siguiente etapa de la configuración.
Para registrar la aplicación OIDC con Microsoft Entra ID:
Registre una aplicación.
Ir a App registrations.
En la cuenta del portal de Azure, buscar y hacer clic en Microsoft Entra ID.
En la sección Manage de la navegación izquierda, hacer clic en App registrations.
Haga clic en New registration.
Aplicar los siguientes valores.
CampoValorName
Ops Manager Database - Workforce
Supported Account Types
Accounts in this organizational directory only (single tenant)
Redirect URI
- Public client/native (mobile & desktop)
-http://localhost:27097/redirectHaga clic en Register.
Para aprender más sobre cómo registrar una aplicación, se puede consultar Azure Documentation.
Agregar una reclamación de grupo.
Ir a Token Configuration.
En la sección Manage de la navegación izquierda, hacer clic en Token Configuration.
Haga clic en Add groups claim.
En el cuadro modal Edit groups claim, seleccionar Security.
Los grupos que seleccione dependen del tipo de grupos que haya configurado en su entorno de Azure. Es posible que necesite seleccionar un tipo diferente de grupo para enviar la información de grupo adecuada.
En la sección Customize token properties by type, seleccionar solo Group ID.
Haga clic en Add.
Para aprender más sobre cómo agregar una reclamación de grupo, se puede consultar Documentación de Azure.
Agregar una reclamación de identificador de usuario al token de acceso.
Haga clic en Add optional claim.
En el cuadro modal Add optional claim, seleccionar Access.
Seleccionar una reclamación que lleve un identificador de usuario al que se pueda referir en los registros de acceso de MongoDB, como un correo electrónico.
Se puede usar la reclamación UPN para identificar a los usuarios con su dirección de correo electrónico.
Haga clic en Add.
En la nota Microsoft Graph Permissions, marque la casilla y haga clic en Add.
Para aprender más, se puede consultar la documentación de Azure.
Actualizar el manifiesto.
En la sección Manage de la navegación izquierda, hacer clic en Manifest.
Actualizar el accessTokenAcceptedVersion de
nulla2.El número
2representa la versión 2 de los tokens de acceso de Microsoft. Otras aplicaciones pueden utilizar esto como una declaración firmada de la identidad del usuario gestionado por el Directorio de Active. La versión 2 garantiza que el token sea un JSON Web Token que MongoDB comprenda.Haga clic en Save.
Para aprender más sobre cómo agregar una reclamación opcional, se puede consultar Documentación de Azure.
Recuerde los metadatos.
En la navegación izquierda, hacer clic en Overview.
Copiar el valor de Application (client) ID.
En la navegación superior, haga clic en Endpoints.
Copie el valor OpenID Connect metadata document sin la parte
/.well-known/openid-configuration.También se puede obtener este valor copiando el valor de
issueren la URL OpenID Connect metadata document.
La siguiente tabla muestra a qué se corresponden estos valores de la Interfaz de Usuario de Microsoft Entra ID en nuestras propiedades de configuración de MongoDB Atlas:
Microsoft Entra ID UI | Propiedad de configuración de MongoDB Atlas |
|---|---|
Application (client) ID | Client ID |
OpenID Connect metadata document (without /.well-known/openid-configuration) | Issuer URI. |
Para registrar su aplicación OIDC con Microsoft Active Directory Federation Services (AD FS), debe contar con un servidor AD FS unido a un dominio de Active Directory y que cuente con un certificado SSL de confianza pública.
Utilice el siguiente procedimiento para registrar su solicitud OIDC con AD FS:
Actualice el identificador del servicio de federación.
En Server Manager, vaya a Tools → AD FS Management.
Haga clic en Edit Federation Service Properties.
En el campo Federation Service identifier , cambia el valor de
https://<domain>/adfs/services/trustahttps://<domain>/adfs.<domain>debe sustituirse por el nombre del dominio de Active Directory al que pertenece su servidor AD FS.Haga clic en OK.
El identificador de servicio de federación que actualice en este paso es el URI del emisor que utiliza al configurar su proveedor OIDC en MongoDB. Si estos valores no coinciden, la autenticación falla debido a una discrepancia entre el emisor del token.
Añade las reivindicaciones groups y sub al token de acceso.
MongoDB lee las groups y sub reclamaciones desde el token de acceso. Por defecto, AD FS incluye sub solo en el token ID y envía una idsub claim en el token de acceso en su lugar. Para añadir ambas claims al token de acceso, crea una regla de transformación de emisión en tu API web:
En AD FS Management, abra las propiedades de su grupo de aplicaciones.
En la sección Applications , selecciona tu API web y haz clic Edit.
En la pestaña Issuance Transform Rules , haga clic en Add Rule.
En el campo Claim rule template , selecciona Send LDAP Attributes as Claims y haz clic en Next.
En el campo Claim rule name , introduzca un nombre para la regla.
En el campo Attribute store, seleccione Active Directory.
Asigna los siguientes atributos LDAP a los tipos de reclamaciones salientes:
Atributo LDAPTipo de reclamación salienteToken-Groups - Unqualified Names
groupsUser-Principal-Name
subHaga clic en OK.
Para registrar su aplicación OIDC con Okta:
Crear una aplicación en Okta.
En tu tablero de Okta Admin, utiliza el panel de navegación izquierdo para ir a Applications → Applications.
En la pantalla Applications, haz clic en Create App Integration.
En la sección Sign-in method, seleccione OIDC - OpenID Connect.
En la sección Application type, seleccione Native Application.
Haga clic en Next.
Para obtener más información, consulta Crear integraciones de apps OIDC.
Configura tu New Native App Integration.
Después de crear una integración de aplicación, se te redirige automáticamente a la pantalla New Native App Integration.
En el campo App integration name, ingresa un nombre para la aplicación.
En el campo Grant type , seleccione los tipos de concesiones.
Habilitar los siguientes tipos de concesión:
Authorization Code, Device Authorization, o ambos
(Opcional) Refresh Token
Habilitar tokens de actualización proporciona una mejor experiencia de usuario. Si no habilitas los tokens de actualización, los usuarios deben volver a autenticarse con el proveedor de identidad una vez que su token de acceso expire.
En la sección Sign-in redirect URIs, introduce una URL.
Introduce la siguiente URL:
http://localhost:27097/redirect.En la sección Assignments , configura los campos Controlled access y Enable immediate access con la configuración adecuada para tus políticas de seguridad.
Haga clic en Save.
Para obtener más información, consulta Crear integraciones de apps OIDC.
Configura PKCE y obtén el ID de cliente.
En el panel de su aplicación, vaya a la pestaña General y configure lo siguiente:
En el campo Client ID, haga clic en el icono para copiar el ID de cliente para su uso posterior.
En el campo Proof Key for Code Exchange (PKCE), asegúrese de que Require PKCE as additional verification esté habilitado (marcado por defecto).
Agrega un servidor de autorización.
En el panel de navegación izquierdo, ve a Security → API. Haz clic en Add Authorization Server.
En el campo Name ingrese un nombre para su servidor.
Rellena el campo Audience .
El Audience es la entidad para la que OIDC pretende que el token sea utilizado. Aunque puede ser cualquier URI válido, generalmente este es el ID de cliente de tu aplicación que copiaste en el paso anterior.
(Opcional) En el campo Description, introduzca una descripción de su servidor.
Haga clic en Save.
Para aprender más, consulta Crear un servidor de autorización.
Encuentra y guarda el URI del emisor.
Después de crear tu servidor de autorización, eres redirigido automáticamente a la pantalla de tu servidor de autorización.
En la pestaña Settings, guarda el URI del emisor copiando la primera parte del Metadata URI hasta la sección .well-known. La estructura de URI debe ser similar a: https://<your-okta-domain>/oauth2/ausabgmhveoOQSMsE697.
(Requisito condicional) Añade una reclamación Groups .
Este paso solo es obligatorio si desea autorizar usuarios que usan grupos de Okta. Si planea usar ID de usuario para la autorización en su lugar, puede saltarse este paso.
En la pantalla de tu servidor de autorización, ve a la pestaña Claims y haz clic en Add Claim.
Configure la reclamación Groups con la siguiente información de configuración:
CampoValorName
Escribe un nombre para tu propuesta.
Include in token type
Haz clic en el menú desplegable y selecciona Access Token.
Value type
Haz clic en el menú desplegable y selecciona Groups.
Filter
Haga clic en el desplegable y seleccione Matches regex. Junto al desplegable, introduzca una expresión regular que coincida únicamente con los grupos utilizados para la autorización de MongoDB Atlas. Por ejemplo, si sus grupos de autorización de MongoDB Atlas usan un prefijo de nombre común, introduzca
^<mongodb-atlas-group-prefix>.*donde<mongodb-atlas-group-prefix>sea el prefijo elegido.Disable claim
No marcar.
Include in
Seleccione Any scope.
Haga clic en Create.
Importante
Evita usar .* como valor del filtro. La expresión .* coincide con todos los grupos asignados al usuario, incluidos grupos no relacionados con la autorización de MongoDB Atlas. Un filtro amplio aumenta el tamaño del token de acceso y puede causar fallos de autenticación cuando el token supera el límite de preAuthMaximumMessageSizeBytes (16 KiB por defecto).
Para reducir el tamaño del token, crea una convención de nombres dedicada para los grupos de autorización de MongoDB Atlas y filtra según esa convención.
Si su implementación requiere intencionadamente una reclamación de grupos grande, puede aumentar el parámetro preAuthMaximumMessageSizeBytes en su clúster. Sin embargo, aumentar este límite tiene implicaciones para los recursos y la seguridad, y no debe utilizarse como solución alternativa para una reclamación innecesariamente amplia.
Para obtener más información, consulta Crear reclamos.
Crea una política de acceso.
En la pantalla de tu servidor de autorización, ve a la pestaña Access Policies y haz clic en Add Policy.
En el campo Name, introduce un nombre de política.
En el campo Description, introduce una descripción de la política.
En el campo Assign to, seleccione All clients.
Haga clic en Create Policy.
Para obtener más información, consulte Crear una política de acceso.
Crea una regla para la política de acceso.
En la pestaña Access Policies, haz clic en Add Rule.
En el campo Rule Name, ingresa un nombre para la política de acceso.
Para IF Grant Type is, seleccione un tipo de concesión.
Al configurar tipos de permisos, seleccione la opción adecuada basada en el comportamiento del cliente:
Si el cliente actúa en nombre propio, seleccione Client Credentials.
Si el cliente actúa en nombre de un usuario, selecciona lo siguiente:
Authorization Code
Device Authorization
Agrega configuraciones de reglas basadas en la política de seguridad de tu organización.
Ejemplo de configuración de regla de Okta:
CampoValorAND user is
Seleccione Any user assigned to the app.
AND Scopes requested
Seleccione Any scopes.
THEN Use this inline hook
Ninguna (deshabilitada)
AND Access token lifetime is
1 Hours
AND Refresh token lifetime is
Haz clic en el segundo desplegable y selecciona Unlimited.
but will expire if not used every
Introduce 7 days.
Haga clic en Create Rule.
Para aprender más, consulta Crea Reglas para cada Política de Acceso.
Cree un grupo.
En el panel de navegación izquierdo, ve a Directory → Groups y haz clic en Add Group.
En el campo Name, nombrar tu directorio
OIDC.(Opcional) En el campo Description, ingresa una descripción para tu regla.
Haga clic en Save.
Para aprender más, consulta Crear un Grupo
Sigue la documentación de Okta para asignar manualmente personas al grupo.
Agregue un usuario a su organización.
En el panel de navegación izquierdo, ve a Directory → People y haz clic en Add Person.
Proporcione los datos del usuario ingresando los siguientes valores en los campos correspondientes:
CampoValorUser type
Seleccione User.
First name
Proporciona un nombre según sea necesario.
Last name
Proporciona un nombre según sea necesario.
Username
Introduzca un correo electrónico como nombre de usuario.
Primary email
Ingrese un correo electrónico. El correo electrónico debe ser el mismo que se utilizó para el campo Username.
Secondary email
Opcional.
Groups
Introduce OIDC.
Activation
Selecciona Activate Now y verifica I will set password.
Password
Ingresa una contraseña.
User must change password on first login
Seleccionar Optional
Haga clic en Save.
Para obtener más información, consulta Agregar usuarios manualmente.
Configurar la autenticación de la Workforce Identity Federation
Para configurar la Federación de Identidad Laboral con OIDC, siga este procedimiento.
Nota
Workforce Identity Federation solo brinda soporte a JSON Web Token (JWT) para la autenticación. No brinda soporte para tokens de acceso opacos.
Navegue al cuadro de diálogo Security Settings para su implementación.
Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.
Selecciona tu proyecto en el menú Projects de la barra de navegación.
Haz clic en Deployment en la barra lateral.
Haz clic en la pestaña Security.
Haz clic en la pestaña Settings.
Realiza una de las siguientes acciones:
Si es la primera vez que configura TLS, la autenticación o la configuración de autorización para este Proyecto, haga clic en Get Started.
Si ya ha configurado la autenticación TLS o la configuración de autorización para este Proyecto, haga clic en Edit.
Opcional: Especifica los ajustes de TLS.
Campo | Acción |
|---|---|
Seguridad de capa de transporte de implementación de MongoDB (TLS) | Active este control deslizante para ON. |
Ruta del archivo CA de TLS | El archivo de la Autoridad de Certificación TLS es un archivo de certificado de formato La clave privada cifrada para el archivo de certificado Escriba la ruta del archivo hasta el archivo de la Autoridad Certificadora TLS en cada host que ejecute un proceso de MongoDB:
Esto habilita la opción Haz clic en Validate para probar que cada host en tu implementación tenga una autoridad certificadora TLS en las rutas que especificaste. |
Ruta del archivo CA TLS del clúster | El archivo Si no especificas el
|
Modo de certificado de cliente | Select if client applications or MongoDB Agents must present a TLS certificate when connecting to TLS-enabled MongoDB deployments. Each MongoDB deployment checks for certificates from these client hosts when they try to connect. If you choose to require the client TLS certificates, make sure they are valid. Los valores aceptados son:
|
Introduce la siguiente configuración.
Configuración | Necesidad | Valor |
|---|---|---|
Configuration Name | Requerido | Etiqueta única que identifica esta configuración. Esta etiqueta es visible para los usuarios de Ops Manager y se utiliza cuando se crean usuarios y roles para la autorización. Es sensible a mayúsculas y solo puede contener los siguientes caracteres:
Después de guardar la configuración, no puedes editar el nombre de la configuración. |
Issuer URI | Requerido | Valor del emisor proporcionado por la solicitud del proveedor de identidad registrada. Usando este URI, MongoDB encuentra un documento de configuración del proveedor de OpenID, que debería estar disponible en el endpoint |
Client ID | Requerido | Identificador único para la aplicación registrada. Ingresar el valor de |
Audience | Requerido | Entidad para la cual el proveedor de identidad externo destina el token. Ingresar el valor de |
Requested Scopes | Opcional | Tokens que otorgan a los usuarios permiso para realizar una solicitud de datos desde el punto de autorización. Para cada ámbito adicional que se desee agregar, hacer clic en Add more scopes. |
Tipo de autorización | Requerido | Seleccionar |
Customize User Claim | Requerido | El identificador del reclamo que incluye la identidad principal del usuario. Acepte el valor predeterminado a menos que su proveedor de identidad utilice una reclamación diferente. Por defecto: |
Customize Group Claim | Requerido | Requerido si selecciona Por defecto: |
Configurar la autorización OIDC
MongoDB no crea explícitamente usuarios de base de datos para OIDC. Asocia a los usuarios de OIDC con roles de MongoDB en función de la configuración.
Siga el procedimiento para el tipo de autorización que eligió al configurar la autenticación OIDC:
Membresía de grupo
Si seleccionaste el tipo de autorización Group Membership, sigue estos pasos para crear un rol personalizado que conceda autorización en función de la membresía del grupo de usuarios del proveedor de identidad:
Navega a la pestaña MongoDB Roles para tu implementación.
Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.
Selecciona tu proyecto en el menú Projects de la barra de navegación.
Haz clic en Deployment en la barra lateral.
Haz clic en la pestaña Security.
Haz clic en la pestaña MongoDB Roles.
Crea el rol OIDC.
Introduce los siguientes campos:
CampoNecesidadDescripciónIdentifier
Requerido
En el recuadro Database, introduzca
admin.En el cuadro Name, introduzca el nombre de configuración de su OIDC proveedor de identidad y el nombre del grupo de su proveedor de identidad externo, separados por una barra diagonal (
/):{configuration_name}/{group_name}Inherits From
Opcional
Una lista de pares de nombres de roles y bases de datos. El formato para estos pares es
roleName@dbName.Authentication Restrictions
Opcional
Una lista de direcciones IP o notaciones CIDR que deseas restringir desde tu proveedor de identidad.
Privilege Actions by Resource
Opcional
Acciones permitidas sobre el recurso.
Para obtener más información, consulta Acciones de privilegio.
Haga clic en Add Role.
ID de usuario
Si seleccionó el tipo de autorización User ID, cree un nuevo usuario para otorgar autorización a un usuario individual:
Navega a la pestaña MongoDB Users para tu implementación.
Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.
Selecciona tu proyecto en el menú Projects de la barra de navegación.
Haz clic en Deployment en la barra lateral.
Haz clic en la pestaña Security.
Haz clic en la pestaña MongoDB Users.
Agregue el usuario OIDC.
Nota
Antes de añadir usuarios, asegúrate de haber creado los roles que deseas asignar a los usuarios.
Completa los campos de la cuenta de usuario:
CampoDescripciónIdentifier
En el primer campo, introduce la base de datos
$external.En el segundo campo, introduzca un nombre de usuario utilizando el nombre de configuración de su OIDC proveedor de identidad y la declaración de entidad de usuario de su configuración separados por una barra diagonal (
/):{configuration_name}/{user_principal_claim}
Roles
Ingrese cualquier rol definido por el usuario disponible y roles integrados en este cuadro. El cuadro combinado proporciona una lista de roles existentes cuando haces clic en él.
Authentication Restrictions
Haga clic en Add Entry.
Añada una o más direcciones IP y/o bloques CIDR en los cuadros Client Source o Server Address. Separe varias direcciones o bloques con comas.
Client Source restringe las direcciones desde las cuales este usuario puede autenticarse y usar los roles asignados.
Server Address restringe las direcciones desde las que este usuario puede autenticarse y tener los roles asignados.
Haga clic en Save.
Para añadir otra entrada, haz clic en Add Entry.
Haga clic en Add User.
Conéctate a MongoDB con la Federación de Identidad Laboral
Utilice mongosh o Compass para conectar una aplicación a MongoDB con la autenticación de la Federación de Identidad de la Fuerza Laboral.
Gestionar una configuración existente de la Workforce Identity Federation
Para gestionar la configuración de Workforce Identity Federation, puede realizar estas acciones.
Revoke JSON Web Key Sets (JWKS)
Nota
No use esta funcionalidad para rotar las claves de firma. Cuando gire las claves de firma OIDC proveedor de identidad, MongoDB obtiene la JWKS automáticamente una vez vencidos los tokens de acceso existentes.
Si la llave privada está comprometida, se pueden revocar inmediatamente los conjuntos de llaves web JSON almacenados en caché en los nodos de MongoDB:
Navegue al cuadro de diálogo Security Settings para su implementación.
Si aún no se muestra, se debe seleccionar la organización que contiene el proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.
Si aún no se muestra, haz clic en Deployment en la barra lateral.
Haz clic en la pestaña Security.
Haz clic en la pestaña Settings.
Edite una configuración
Para editar la configuración de Federación de Identidad de Workforce:
Navegue al cuadro de diálogo Security Settings para su implementación.
Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.
Selecciona tu proyecto en el menú Projects de la barra de navegación.
Haz clic en Deployment en la barra lateral.
Haz clic en la pestaña Security.
Haz clic en la pestaña Settings.
Borrar una configuración
Para borrar la configuración de Workforce Identity Federation:
Navegue al cuadro de diálogo Security Settings para su implementación.
Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.
Selecciona tu proyecto en el menú Projects de la barra de navegación.
Haz clic en Deployment en la barra lateral.
Haz clic en la pestaña Security.
Haz clic en la pestaña Settings.