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 de Workforce Identity Federation con OIDC

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.

Para configurar la Federación de identidad de Workforce, debes tener acceso Project Owner a Ops Manager.

Debe cumplir estos requisitos previos:

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

Para acceder a las implementaciones de MongoDB Ops Manager con la Federación de Identidad de la Fuerza Laboral, siga estos pasos:

  1. Configurar un proveedor de identidad de Workforce (configuración única).

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:

1

Seleccione public client/native application como el tipo de cliente.

2
3

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.

4

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

5

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

1
  1. Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.

  2. Selecciona tu proyecto en el menú Projects de la barra de navegación.

  3. Haz clic en Deployment en la barra lateral.

  4. Haz clic en la pestaña Security.

  5. Haz clic en la pestaña Settings.

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

2
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 .pemque contiene la cadena de certificados raíz de la Autoridad de Certificación. El MongoDB Agent utiliza este mismo archivo de Autoridad de Certificación para conectarse a cada elemento de su implementación.

La clave privada cifrada para el archivo de certificado .pem debe estar en formato PKCS #1. MongoDB Agent no es compatible con el formato PKCS #8.

Escriba la ruta del archivo hasta el archivo de la Autoridad Certificadora TLS en cada host que ejecute un proceso de MongoDB:

  • Escriba la ruta del archivo en todos los hosts Linux en el primer cuadro.

  • Escriba la ruta del archivo en todos los hosts de Windows en la segunda casilla.

Esto habilita la opción net.tls.CAFile para los procesos de MongoDB en el proyecto.

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 .pem que contiene la cadena de certificados raíz de la Autoridad de Certificación utilizada para validar el certificado presentado por un cliente que establece una conexión. Especifique el nombre del archivo .pem utilizando rutas relativas o absolutas. net.tls.clusterCAFile requiere que net.tls.CAFile esté configurado.

Si no especificas el net.tls.clusterCAFile, el clúster utiliza el archivo .pem especificado en la opción net.tls.CAFile.

net.tls.clusterCAFile permite utilizar Autoridades de Certificación separadas para verificar las porciones de cliente a servidor y de servidor a cliente del apretón de manos TLS.

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:

  • Opcional: Cada cliente puede presentar un certificado TLS válido al conectarse a implementaciones de MongoDB. Los agentes de MongoDB podrían usar certificados TLS si no configura el mongod tlsMode en None.

  • Obligatorio: Cada implementación de MongoDB en este Proyecto comienza con conexiones de red cifradas con TLS. Todos los agentes deben usar TLS para conectarse a cualquier implementación de MongoDB.

3

En la sección MongoDB Deployment Authentication Mechanism, seleccione Federated Auth (OIDC).

4
  1. En la sección OIDC Connection and Authorization (Required for OIDC), haga clic en + OIDC IdP Configuration.

  2. En el cuadro de diálogo OIDC Protocol Settings, selecciona Workforce Identity Federation.

5
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:

  • caracteres alfanuméricos (combinación de a a z y de 0 a 9)

  • guiones (-)

  • guiones bajos (_)

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 /.wellknown/open-id-configuration.

Client ID

Requerido

Identificador único para la aplicación registrada. Ingresar el valor de clientId de la aplicación que se registró con el proveedor de identidad externo.

Audience

Requerido

Entidad para la cual el proveedor de identidad externo destina el token. Ingresar el valor de audience de la aplicación que se registró con el proveedor de identidad externo. Generalmente, este valor es el mismo que el Client ID.

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 Group Membership para conceder autorización basada en la pertenencia a un grupo de usuarios del proveedor de identidad, o seleccionar User ID para conceder autorización a un usuario individual.

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: sub

Customize Group Claim

Requerido

Requerido si selecciona Group Membership como el tipo de autorización. El identificador del reclamo que incluye la información de pertenencia del principal al grupo de usuarios de proveedor de identidad. Acepte el valor por defecto a menos que su proveedor de identidad use un reclamo diferente o necesite un reclamo personalizado.

Por defecto: groups

6

Ops Manager guarda la configuración y la lista en la sección OIDC Connection and Authorization (Required for OIDC).

7
8
9

En caso contrario, haz clic en Cancel y podrás realizar cambios adicionales.

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:

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:

1
  1. Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.

  2. Selecciona tu proyecto en el menú Projects de la barra de navegación.

  3. Haz clic en Deployment en la barra lateral.

  4. Haz clic en la pestaña Security.

  5. Haz clic en la pestaña MongoDB Roles.

2
3
  1. Introduce los siguientes campos:

    Campo
    Necesidad
    Descripción

    Identifier

    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.

  2. Haga clic en Add Role.

Si seleccionó el tipo de autorización User ID, cree un nuevo usuario para otorgar autorización a un usuario individual:

1
  1. Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.

  2. Selecciona tu proyecto en el menú Projects de la barra de navegación.

  3. Haz clic en Deployment en la barra lateral.

  4. Haz clic en la pestaña Security.

  5. Haz clic en la pestaña MongoDB Users.

2
3

Nota

Antes de añadir usuarios, asegúrate de haber creado los roles que deseas asignar a los usuarios.

  1. Completa los campos de la cuenta de usuario:

    Campo
    Descripción

    Identifier

    • 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

    1. Haga clic en Add Entry.

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

    3. Haga clic en Save.

    4. Para añadir otra entrada, haz clic en Add Entry.

  2. Haga clic en Add User.

4
5

En caso contrario, haz clic en Cancel y podrás realizar cambios adicionales.

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.

Para gestionar la configuración de Workforce Identity Federation, puede realizar estas acciones.

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:

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

  2. Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.

  3. Si aún no se muestra, haz clic en Deployment en la barra lateral.

  4. Haz clic en la pestaña Security.

  5. Haz clic en la pestaña Settings.

2
  1. Desplázate hasta la sección OIDC Connection and Authorization (Required for OIDC).

  2. Haga clic en el botón REVOKE JWKS.

  3. En el cuadro de diálogo Revoke JWKS tokens?, haga clic en Revoke.

Para editar la configuración de Federación de Identidad de Workforce:

1
  1. Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.

  2. Selecciona tu proyecto en el menú Projects de la barra de navegación.

  3. Haz clic en Deployment en la barra lateral.

  4. Haz clic en la pestaña Security.

  5. Haz clic en la pestaña Settings.

2
  1. Desplázate hasta la sección OIDC Connection and Authorization (Required for OIDC).

  2. Para la configuración que deseas editar, haz clic en el botón EDIT.

  3. Realiza cambios en la configuración.

3
4
5
6

En caso contrario, haz clic en Cancel y podrás realizar cambios adicionales.

Para borrar la configuración de Workforce Identity Federation:

1
  1. Selecciona la organización que contiene tu proyecto desde el menú Organizations en la barra de navegación.

  2. Selecciona tu proyecto en el menú Projects de la barra de navegación.

  3. Haz clic en Deployment en la barra lateral.

  4. Haz clic en la pestaña Security.

  5. Haz clic en la pestaña Settings.

2
  1. Desplázate hasta la sección OIDC Connection and Authorization (Required for OIDC).

  2. Para la configuración que desea borrar, haga clic en el botón REMOVE.

  3. En el cuadro de diálogo Removing OIDC IdP configuration?, haga clic en Remove.