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.

Configura la federación de identidades de cargas de trabajo con OAuth 2.0

Con la federación de identidades de carga de trabajo, permite a las aplicaciones acceder a las implementaciones de MongoDB Cloud Manager mediante identidades programáticas externas, como los principales de servicio de Azure, las identidades gestionadas de Azure y las cuentas de servicio de Google.

La federación de identidades de carga de trabajo permite a las aplicaciones acceder a las implementaciones de MongoDB con tokens de acceso de OAuth 2.0. Los tokens de acceso los puede emitir cualquier proveedor de identidad externo, incluidos Azure Entra ID y Google Cloud Platform (GCP). Cloud Manager almacena los identificadores de usuario y los privilegios, pero no los secretos. Un conjunto limitado de drivers de MongoDB ofrece este mecanismo de autenticación para sus aplicaciones.

Los drivers MongoDB admiten dos tipos de flujo de autenticación para Workload Identity Federation: autenticación incorporada y autenticación de función de retorno.

Puede usar la funcionalidad incorporada de autenticación si implementa su aplicación en una infraestructura compatible con un tipo de principal compatible. La aplicación puede acceder a las implementaciones de Cloud Manager sin proporcionar una contraseña ni realizar una solicitud manual de JWT al servicio de metadatos del proveedor de nube. En su lugar, su driver utiliza el identificador principal existente para solicitar un token de acceso JSON web token (JWT). El driver pasa el token a la implementación de Cloud Manager cuando su aplicación se conecta.

Para más detalles sobre la implementación, consulta la documentación de tu driver.

Infraestructura y tipos principales compatibles con la autenticación incorporada

Proveedor de nube
Tipo de infraestructura
Tipo principal

GCP

Motor de cómputo

Cuentas de servicio de GCP

Entorno estándar del motor de la aplicación

Entorno flexible del motor de la aplicación

Funciones en la nube

Cloud Run

Google Kubernetes Engine

Cloud Build

Azure

Azure VM

Identidades gestionadas de Azure (asignadas al usuario y al sistema)

Puede utilizar la autenticación de función de retorno con cualquier servicio que admita tokens de acceso de OAuth 2.0. La federación de identidades de carga de trabajo llama a una función de retorno donde hace la solicitud del JWT necesario de su servidor de autorización o proveedor de nube. A continuación, pasa el token a Cloud Manager con Workload Identity Federation cuando tu aplicación se conecta.

Para más detalles sobre la implementación, consulta la documentación de tu driver.

Para configurar la Federación de Identidad de Carga de trabajo, debes contar con Project Owner acceso a Cloud Manager.

Debe cumplir estos requisitos previos:

  • 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 Cloud Manager no gestiona la supervisión o la copia de seguridad, debe configurarlas manualmente para que utilicen el mecanismo de autenticación alternativo.

Para configurar Workload Identity Federation, sigue estos pasos:

  1. Configura un proveedor de identidad de carga de trabajo (configuración única).

Proveedor de identidad

Nota

Para restablecer la autenticación y la configuración de TLS de tu proyecto, primero desadministra cualquier implementación de MongoDB que Cloud Manager administre en tu proyecto.

Nota

La Federación de Identidad de Carga de Trabajo solo admite JWT para autenticación. No admite tokens de acceso opacos.

MongoDB no crea explícitamente usuarios de bases de datos para OIDC. Asocia a los usuarios de OIDC con roles de MongoDB en función de la configuración.

Complete el procedimiento para el tipo de autorización que seleccionó al configurar la autenticación OIDC.

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.

Si seleccionaste el tipo de autorización Group Membership, completa los siguientes pasos para crear un rol personalizado que conceda autorización en función de la membresía del grupo de usuarios del IdP:

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.

Utiliza estos drivers de MongoDB para conectar una aplicación a MongoDB con autenticación de Workload Identity Federation:

Para gestionar su configuración de federación de identidades de carga de trabajo, 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, 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 Security en la sección Database.

Se muestra la página de Seguridad.

2

Haz clic en la pestaña Settings.

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

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

    Nota

    Este botón está inactivo si no hay un proveedor de identidad configurado.

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

Para editar tu configuración de carga de trabajo Identity Federation:

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 Security en la sección Database.

Se muestra la página de Seguridad.

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 tu configuración de Workload Identity Federation:

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 Security en la sección Database.

Se muestra la página de Seguridad.

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.