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

Workload Identity Federation permite a sus aplicaciones acceder a las implementaciones de MongoDB Ops 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). MongoDB Ops 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 MongoDB Ops Manager sin proporcionar una contraseña ni solicitar manualmente un 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 MongoDB Ops 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. Luego pasas el token a Ops 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.

La Federación de Identidades de carga de Trabajo con Identidades Gestionadas de Azure proporciona la forma más segura de autenticarse en las implementaciones de MongoDB Ops Manager que se ejecutan en Azure. Este enfoque ofrece las siguientes ventajas de seguridad:

  • Aprovecha las identidades administradas: permite que las aplicaciones que se ejecutan en los servicios de Azure (como las MV de Azure, AKS y Azure Functions) se autentiquen ante MongoDB Ops Manager utilizando las identidades administradas asignadas en Azure sin necesidad de administrar credenciales independientes de MongoDB.

  • Autenticación "sin contraseña" segura: Tus aplicaciones obtienen tokens de acceso OAuth 2.0 de vida corta desde el servidor de metadatos de Azure, los cuales MongoDB Ops Manager luego verifica. Esto elimina la necesidad de almacenar y manejar nombres de usuario y contraseñas sensibles de bases de datos dentro del código o las configuraciones de su aplicación.

  • Gestión de identidades centralizada: gestionas las identidades de tus cargas de trabajo de Azure dentro del marco de Azure Entra ID, lo que proporciona una fuente única de información fiable para la gestión de identidades.

  • Auditoría mejorada: Azure proporciona registros de auditoría de la actividad de las cuentas de servicio, lo que mejora la trazabilidad y las capacidades de supervisión de la seguridad.

Para configurar la Federación de Identidad de Carga de Trabajo, se debe tener acceso Project Owner a Ops 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 MongoDB Ops Manager no gestiona supervisión ni copia de seguridad, debes configurarlos manualmente para usar 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

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.

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 (JWKS) 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 tu configuración de carga de trabajo 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 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. 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.