Overview
Puede utilizar OpenID Connect (OIDC) para gestionar la autenticación y autorización de los usuarios de Ops Manager con un proveedor de identidad externo (proveedor de identidad). Cuando intentas acceder a Ops Manager sin una sesión autenticada, Ops Manager te redirige a tu proveedor de identidad para iniciar sesión. Después de autenticarte, regresas a Ops Manager.
Para la autenticación de la Interfaz de Usuario, Ops Manager utiliza el token de ID que emite su proveedor de identidad en lugar del token de acceso.
Este tutorial describe cómo:
Configura la autenticación OIDC para Ops Manager.
Asocie grupos de OIDC a roles de organización y roles de proyectode Ops Manager.
Gestiona las asignaciones de roles de organización y proyecto con la API pública.
Considerations
Utilice HTTPS para OIDC
HTTPS se recomienda encarecidamente para Ops Manager en general, y especialmente para OIDC. Es posible que algunas integraciones de proveedor de identidad no funcionen correctamente si Ops Manager no utiliza HTTPS.
Requisitos previos
Para configurar la integración de OIDC, debes realizar las siguientes acciones en tu proveedor de identidad:
Crea una aplicación de cliente para Ops Manager.
Registre MongoDB Ops Manager como una aplicación web que utiliza un cliente confidencial con autenticación de secreto de cliente. Agregue la URL de función de retorno de MongoDB Ops Manager, https://<ops-manager-host>:<port>/oidc/callback, a la lista de URI de redireccionamiento permitidos. Incluya la ruta /oidc/callback completa: algunos proveedor de identidad, como Okta, rechazan la solicitud durante la validación de URI de redireccionamiento si solo registra la URL base de MongoDB Ops Manager.
Cree un grupo para el rol de Global Owner y añada el usuario a él.
Procedimiento
Configurar la autenticación OIDC:
Configura los ajustes de conexión OIDC.
Especifica valores para los campos obligatorios y luego establece los campos opcionales según sea necesario.
La siguiente tabla asigna los campos de la interfaz de usuario de Ops Manager a los campos del archivo de configuración.
Campo de la IU de Ops Manager | Campo de archivo de configuración | Requerido | Descripción |
|---|---|---|---|
Issuer URI |
| Sí | URI del emisor o URL del documento de descubrimiento de metadatos OIDC. |
Client ID |
| Sí | Identificador de cliente asignado a Ops Manager por el proveedor de identidad. |
Client Secret |
| Sí | El secreto del cliente asignado a Ops Manager por el proveedor de identidad. |
Custom CA Certificate (PEM) |
| No | Certificado o certificados PEM-encoded CA en los que confiar al conectarse con el proveedor de identidad. Úsalo cuando tu proveedor de identidad utilice un certificado de CA privado o autofirmado. Puedes concatenar varios certificados. |
Enable PKCE (Proof Key for Code Exchange) |
| Sí | Habilitación de PKCE para el flujo de código de autorización. PKCE añade un paso de verificación que protege contra la interceptación del código de autorización. Recomendado y habilitado por defecto. Deshabilítelo solo si su proveedor de identidad no admite PKCE para clientes confidenciales. Valor por defecto: |
Requested Scopes |
| No | Lista de alcance que Ops Manager solicita desde el endpoint de autorización. |
Service Provider Base URL |
| No | URL base para el proveedor de servicios OIDC. Si no establece este valor, MongoDB Ops Manager utiliza |
Global Role Owner Groups |
| Sí | Lista separada por comas de grupos de proveedor de identidad cuyos nodos tienen asignado el rol de Propietario global. Los propietarios globales tienen privilegios completos sobre esta implementación, incluyendo todos los permisos administrativos. |
Global Automation Admin Groups |
| No | Lista separada por comas de grupos de proveedor de identidad cuyos miembros reciben el rol de Administrador Global de Automatización. |
Global Backup Admin Groups |
| No | Lista separada por comas de grupos de proveedor de identidad cuyos miembros tienen asignado el rol de Administrador Global de Copias de Seguridad. |
Global Monitoring Admin Groups |
| No | Lista separada por comas de los grupos de proveedor de identidad cuyos miembros tienen asignado el rol de Administrador global de supervisión. |
Global User Admin Groups |
| No | Lista separada por comas de grupos de proveedor de identidad cuyos miembros tienen asignado el rol de Administrador Global de usuarios. |
Global Read Only Groups |
| No | Lista separada por comas de grupos de proveedor de identidad cuyos miembros tienen asignado el rol Global de Solo Lectura. |
OIDC Claim for User First Name |
| No | Reclamación que contiene el primer nombre del usuario. Valor por defecto: |
OIDC Claim for User Last Name |
| No | Reclamo que contiene el apellido del usuario. Valor por defecto: |
OIDC Claim for User Email |
| No | Declaración que contiene la dirección de correo electrónico del usuario. Valor por defecto: |
OIDC Claim for Group Member |
| No | Reclamo que contiene la lista de grupos que Ops Manager utiliza para asignar roles a proyectos y organizaciones. Valor por defecto: |
MongoDB Ops Manager lee el nombre, el apellido y la dirección de correo electrónico del usuario a partir de las notificaciones en el token de ID. Aunque la configuración de las notificaciones es opcional, las notificaciones en sí deben estar presentes en el token de ID. MongoDB Ops Manager rechaza el inicio de sesión si falta alguna de estas notificaciones o si están vacías. Algunos proveedor de identidad, como Okta, no incluyen la notificación given_name en el token de ID bajo el ámbito openid por defecto. Configure su proveedor de identidad para incluir estas notificaciones.
Cómo funcionan los mapeos de roles
Los mapeos de roles de OIDC funcionan de la misma manera que los mapeos de roles de SAML. Se puedes mapear los grupos proveedor de identidad a los roles de Ops Manager para las organizaciones y los proyectos. Cuando un usuario inicia sesión, Ops Manager asigna roles en función de la pertenencia del usuario a un grupo.
Mapeos de roles organizacionales
Las asignaciones de roles de la organización asocian los grupos proveedor de identidad con los roles de la organización.
Los campos de mapeo de la organización incluyen:
Grupos OIDC para el rol de propietario de la organización
Grupos OIDC para el rol de creador de proyecto de organización
Grupos OIDC para el rol de solo lectura de la organización
Grupos OIDC para el rol de miembro de la organización
Asignaciones de roles de proyecto
Las asignaciones de roles de proyecto asocian los grupos de proveedor de identidad con los roles del proyecto.
Los campos de mapeo del proyecto incluyen:
Grupos OIDC para el rol de propietario del proyecto
Grupos OIDC para el rol de solo lectura
Grupos OIDC para el rol de Administrador de automatización
Grupos OIDC para el rol de administrador de copia de seguridad
Grupos OIDC para el rol de administrador de supervisión
Grupos OIDC para el rol de administrador de usuarios
Grupos OIDC para el rol de administrador de acceso a datos
OIDC Groups para acceso a los datos Read guardar rol
Grupos OIDC para el rol de acceso a los datos de solo lectura
Gestionar asignaciones de roles con la API pública
Puede gestionar asignaciones de roles del proveedor de identidad mediante programación utilizando el campo idpGroupMappings en las siguientes API públicas:
Obtén organizaciones.
Cree y actualice organizaciones.
Crea y actualiza proyectos.
El idpGroupMappings campo es un arreglo que asigna los roles de Ops Manager a los grupos de proveedor de identidad.
{ "idpGroupMappings": [ { "idpGroups": [ "name_of_your_idp_group", "another_name_of_idp_group" ], "roleName": "GROUP_USER_ADMIN" } ]}Los siguientes valores son válidos para la organización roleName:
ORG_OWNERORG_GROUP_CREATORORG_BILLING_ADMINORG_READ_ONLYORG_MEMBER
Los siguientes valores son válidos para el proyecto roleName:
GROUP_OWNERGROUP_READ_ONLYGROUP_AUTOMATION_ADMINGROUP_BACKUP_ADMINGROUP_MONITORING_ADMINGROUP_USER_ADMINGROUP_BILLING_ADMINGROUP_DATA_ACCESS_ADMINGROUP_DATA_ACCESS_READ_ONLYGROUP_DATA_ACCESS_READ_WRITEGROUP_CHARTS_ADMINGROUP_CLUSTER_MANAGERGROUP_SEARCH_INDEX_EDITOR
Cierre de sesión en segundo plano
Ops Manager admite OIDC backchannel cerrar sesión. Cuando su proveedor de identidad envía un token de cierre de sesión, Ops Manager invalida la sesión del usuario.
Endpoint
POST {OPSMANAGER-HOST}:{PORT}/oidc/backchannel-logout
Solicitud
Envía una solicitud codificada en formulario con el parámetro logout_token que contenga un JWT firmado.
Requisitos
Incluye un
subválido (asunto) claim.Puede incluir el
sid(ID de sesión) claim para la invalidación dirigida de la sesión.
Ops Manager no admite el cierre de sesión iniciado por el proveedor de servicios. Para cerrar la sesión, los usuarios deben cerrar la sesión desde el proveedor de identidad.