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 Workforce Identity Federation desde Okta

Esta guía le muestra cómo configurar Workforce Identity Federation utilizando Okta como su proveedor de identidad.

Después de integrar Okta y Atlas, su personal puede usar sus credenciales de Okta para acceder a los clústeres de Atlas con autenticación OIDC.

Para gestionar la autenticación federada, debe tener Organization Owner acceso a una o más organizaciones que delegan la configuración de federación en la instancia.

Para utilizar Okta como proveedor de identidad para Atlas, debe tener:

Durante el siguiente procedimiento, es útil tener una pestaña del navegador abierta en tu Consola de gestión de federaciones de Atlas y otra pestaña abierta en tu cuenta de Okta.

Utilice su cuenta de Okta para configurar Okta como un OIDC proveedor de identidad.

Para registrar su aplicación OIDC con Okta:

1

En tu tablero de Okta Admin, utiliza el panel de navegación izquierdo para ir a Applications → Applications.

  1. En la pantalla Applications, haz clic en Create App Integration.

  2. En la sección Sign-in method, seleccione OIDC - OpenID Connect.

  3. En la sección Application type, seleccione Native Application.

  4. Haga clic en Next.

Para obtener más información, consulta Crear integraciones de apps OIDC.

2

Después de crear una integración de aplicación, se te redirige automáticamente a la pantalla New Native App Integration.

  1. En el campo App integration name, ingresa un nombre para la aplicación.

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

  3. En la sección Sign-in redirect URIs, introduce una URL.

    Introduce la siguiente URL: http://localhost:27097/redirect.

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

  5. Haga clic en Save.

Para obtener más información, consulta Crear integraciones de apps OIDC.

3

En el panel de su aplicación, vaya a la pestaña General y configure lo siguiente:

  1. En el campo Client ID, haga clic en el icono para copiar el ID de cliente para su uso posterior.

  2. En el campo Proof Key for Code Exchange (PKCE), asegúrese de que Require PKCE as additional verification esté habilitado (marcado por defecto).

4

En el panel de navegación izquierdo, ve a Security → API. Haz clic en Add Authorization Server.

  1. En el campo Name ingrese un nombre para su servidor.

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

  3. (Opcional) En el campo Description, introduzca una descripción de su servidor.

  4. Haga clic en Save.

Para aprender más, consulta Crear un servidor de autorización.

5

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.

6

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.

  1. Configure la reclamación Groups con la siguiente información de configuración:

    Campo
    Valor

    Name

    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 menú desplegable y seleccione Matches regex. Junto al menú desplegable, introduzca una expresión regular que coincida únicamente con los grupos utilizados para la autorización de Atlas. Por ejemplo, si sus grupos de autorización de Atlas utilizan un prefijo de nomenclatura común, introduzca ^<mongodb-atlas-group-prefix>.* donde <mongodb-atlas-group-prefix> es el prefijo elegido.

    Disable claim

    No marcar.

    Include in

    Seleccione Any scope.

  2. Haga clic en Create.

Importante

Evite usar .* como valor de filtro. La expresión .* coincide con cada grupo asignado al usuario, incluidos los grupos no relacionados con la autorización de Atlas. Un filtro amplio aumenta el tamaño del token de acceso y puede provocar errores de autenticación cuando el token supera el límite de preAuthMaximumMessageSizeBytes (16 KiB por defecto).

Para reducir el tamaño del token, cree una convención de nomenclatura dedicada para los grupos de autorización de Atlas y filtre 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.

7

En la pantalla de tu servidor de autorización, ve a la pestaña Access Policies y haz clic en Add Policy.

  1. En el campo Name, introduce un nombre de política.

  2. En el campo Description, introduce una descripción de la política.

  3. En el campo Assign to, seleccione All clients.

  4. Haga clic en Create Policy.

Para obtener más información, consulte Crear una política de acceso.

8

En la pestaña Access Policies, haz clic en Add Rule.

  1. En el campo Rule Name, ingresa un nombre para la política de acceso.

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

  3. Agrega configuraciones de reglas basadas en la política de seguridad de tu organización.

    Ejemplo de configuración de regla de Okta:

    Campo
    Valor

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

  4. Haga clic en Create Rule.

Para aprender más, consulta Crea Reglas para cada Política de Acceso.

9

En el panel de navegación izquierdo, ve a Directory → Groups y haz clic en Add Group.

  1. En el campo Name, nombrar tu directorio OIDC.

  2. (Opcional) En el campo Description, ingresa una descripción para tu regla.

  3. Haga clic en Save.

    Para aprender más, consulta Crear un Grupo

  4. Sigue la documentación de Okta para asignar manualmente personas al grupo.

10

En el panel de navegación izquierdo, ve a Directory → People y haz clic en Add Person.

  1. Proporcione los datos del usuario ingresando los siguientes valores en los campos correspondientes:

    Campo
    Valor

    User 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

  2. Haga clic en Save.

Para obtener más información, consulta Agregar usuarios manualmente.

Nota

Requisito previo

Este procedimiento requiere que se tenga acceso Organization Owner y asume que ya se tiene una aplicación OIDC creada en el proveedor de identidad. Para aprender cómo configurar un proveedor de identidad, consulte Configurar Okta como proveedor de identidad.

Para configurar un proveedor de identidades de Workforce en Atlas:

1
  1. Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.

  2. En la barra lateral, haz clic en Federation en la sección Identity & Access.

  3. Haga clic en Open Federation Management App.

La página de Federación se muestra.

2
  1. Hacer clic en Identity Providers en la barra lateral izquierda.

  2. Realice uno de los siguientes pasos:

    • Si aún no tiene ningún proveedor de identidad configurado, haga clic en Set Up Identity Provider.

    • De lo contrario, en la pantalla Identity Providers, hacer clic en Configure Identity Provider(s).

  3. Seleccione Workforce Identity Federation y haga clic en Continue.

  4. Seleccione OIDC for Data Access.

3
Configuración
Necesidad
Valor
Configuration Name

Requerido

Etiqueta legible por humanos que identifica esta configuración. Esta etiqueta es visible para los usuarios de Atlas designados.

Configuration Description

Opcional

Etiqueta legible por humanos que describe esta 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 /.well-known/openid-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. Si se planea brindar soporte a tokens de actualización, este campo debe incluir el valor offline_access.

Para cada ámbito adicional que se desee agregar, hacer clic en Add more scopes.

Authorization Type

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 Groups Claim

Requerido

Identificador de la reclamación que incluye la información de membresía del grupo de usuarios del proveedor de identidad del principal. Aceptar el valor por defecto a menos que el proveedor de identidad utilice una reclamación diferente o necesite un reclamo personalizado. Este campo solo es obligatorio si se selecciona Group Membership.

Por defecto: groups

Customize User Claim

Requerido

Identificador de la reclamación que incluye la identidad principal del usuario. Aceptar el valor por defecto a menos que el proveedor de identidad utilice una reclamación diferente.

Por defecto: sub

4
5

Nota

Este paso solo es obligatorio si se necesita conectar varios proveedores de identidad de Workforce a la misma organización con diferentes dominios. Atlas admite un máximo de dos proveedores de identidad de Workforce conectados a una organización: un proveedor de identidad de OIDC (para el acceso a la base de datos) y un proveedor de identidad de SAML (para el acceso a la interfaz de usuario).

  1. En su tarjeta de proveedor de identidad de Workforce, hacer clic en Associate Domains.

  2. En el cuadro modal Associate Domains with Identity Provider, seleccione uno o más dominios.

  3. Haga clic en Submit.

6
  1. Haga clic en Connect Organizations.

  2. Para la organización a la que desea conectarse con el Proveedor de Identidad de Workforce, haga clic en Configure Access.

  3. Haga clic en Connect Identity Provider.

    Nota

    Si se tiene otro proveedor de identidad configurado, este botón dice Connect Identity Provider(s).

7

En el modal Connect Identity Provider(s), seleccionar un proveedor de identidad de Workforce donde el Purpose sea Workforce Identity Federation.

8

Cuando se conecta el proveedor de identidad de Workforce a una organización, Atlas habilita al proveedor de identidad de Workforce para todos los proyectos dentro de esa organización.

1
  1. Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.

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

  3. En la barra lateral, haz clic en Database & Network Access en la sección Security.

La página Acceso a la base de datos y a la red se muestra después de completar los pasos anteriores.

2

Haga clic en Add New Database User or Group.

Nota

Hasta que se aplique el proveedor de identidad de Workforce a Atlas, este botón dice Add New Database User.

3

En la sección Authentication Method, seleccione Federated Auth.

Nota

Hasta que habilites Workforce proveedor de identidad para tu organización, no podrás seleccionar esta casilla.

4

En la sección Select Identity Provider, seleccionar un proveedor de identidad OIDC configurado.

Especifica el identificador de usuario o el identificador de grupo asociado con tu proveedor de identidad de Workforce configurado.

Nota

Para los usuarios de Azure Entra ID, este valor se asigna al ID de objeto de su grupo de usuarios de Azure en lugar del nombre del grupo de usuarios.

5

Para asignar privilegios al nuevo usuario o grupo, realice una o más de las siguientes tareas:

  • Selecciona un rol incorporado del menú desplegable Built-in Role.

    • Puede seleccionar un rol con funcionalidad incorporada por grupo de base de datos en la interfaz de usuario de Atlas.

    • Si borra la opción por defecto, puede hacer clic en Add Built-in Role para seleccionar un nuevo rol con funcionalidad incorporada.

  • Selecciona o agrega roles personalizados.

    • Si tiene roles personalizados definidos, puede expandir la sección Custom Roles y seleccionar uno o más roles del menú desplegable Custom Roles.

    • Haga clic Add Custom Role para añadir más roles personalizados.

    • Se debe hacer clic en el enlace Custom Roles para ver los roles personalizados del proyecto.

  • Add privilegio.

    • Expanda la sección Specific Privileges y seleccione uno o más privilegios del menú desplegable de Specific Privileges.

    • Haga clic en Add Specific Privilege para agregar más privilegios. Esto asigna al grupo privilegios específicos en bases de datos y colecciones individuales.

  • Remueve un rol o privilegio aplicado.

    • Haz clic en Delete junto al

      rol o privilegio que deseas borrar.

    Nota

    Atlas no muestra el icono de Delete junto a la selección de Built-in Role, Custom Role o Specific Privilege si solo se seleccionó una opción. Se puede borrar el rol o privilegio seleccionado una vez que se aplique otro rol o privilegio.

Atlas puede aplicar un rol incorporado, varios roles personalizados y diversos privilegios específicos a un grupo de bases de datos.

Para obtener más información sobre la autorización, consulte Control de accesos en función del rol y Roles con funcionalidad incorporada en el manual de MongoDB.

6

Por defecto, los grupos pueden acceder a todos los clústeres e instancias federadas de bases de datos en el proyecto. Para restringir el acceso a clústeres específicos e instancias federadas de bases de datos:

  1. Establece Restrict Access to Specific Clusters/Federated Database Instances en On.

  2. Selecciona los clústeres e instancias federadas de bases de datos para conceder acceso al grupo desde la lista de Grant Access To.

7

Cambia Temporary User o Temporary Group a On y elige un tiempo después del cual Atlas puede borrar al usuario o grupo del menú desplegable Temporary User Duration o Temporary Group Duration. Puedes seleccionar uno de los siguientes períodos de tiempo para que el grupo exista:

  • 6 horas

  • 1 día

  • 1 semana

En la pestaña Database Users, los usuarios o grupos temporales muestran el tiempo restante hasta que Atlas borre a los usuarios o al grupo. Después de que Atlas borre al usuario o grupo, cualquier cliente o aplicación que utilice las credenciales temporales del usuario o grupo perderá acceso al clúster.

8

Realice uno de los siguientes pasos:

  • Si agregaste un usuario, haz clic en el botón Add User.

  • Si ha agregado un grupo, haga clic en el botón Add Group.

A continuación se enumeran las formas en las que se puede conectar un cliente a MongoDB con la autenticación de Workforce Identity Federation:

Nota

Si configuraste el Flujo de autorización de dispositivos, debes pasar la bandera --oidcFlows=device-auth al conectarte con mongosh. Por ejemplo:

mongosh "<connection-string>" \ --authenticationMechanism MONGODB-OIDC \ --oidcFlows=device-auth