Mapeo de grupos
El mapeo de grupos sincroniza automáticamente los grupos de usuarios de tu proveedor de identidad (IdP) con los equipos de tu organización de Docker. Por ejemplo, cuando añades a un desarrollador al grupo "backend-team" en tu IdP, este se añade automáticamente al equipo correspondiente en Docker.
Esta página explica cómo funciona el mapeo de grupos y cómo configurarlo.
TipEl mapeo de grupos es ideal para añadir usuarios a varias organizaciones o a varios equipos dentro de una sola organización. Si no necesitas configurar la asignación a varias organizaciones o equipos, los atributos a nivel de usuario de SCIM pueden adaptarse mejor a tus necesidades.
Requisitos previos
Antes de comenzar, debes tener:
- SSO configurado para tu organización
- Acceso de administrador a Docker Home y a tu proveedor de identidad
Cómo funciona el mapeo de grupos
El mapeo de grupos mantiene sincronizados tus equipos de Docker con los grupos de tu IdP a través de los siguientes componentes clave:
- Flujo de autenticación: Cuando los usuarios inician sesión a través de SSO, tu IdP comparte los atributos del usuario con Docker, incluyendo correo electrónico, nombre y pertenencia a grupos.
- Actualizaciones automáticas: Docker utiliza estos atributos para crear o actualizar perfiles de usuario y gestionar las asignaciones de equipos según los cambios en los grupos del IdP.
- Identificación única: Docker utiliza las direcciones de correo electrónico como identificadores únicos, por lo que cada cuenta de Docker debe tener una dirección de correo electrónico única.
- Sincronización de equipos: La pertenencia de los usuarios a los equipos en Docker refleja automáticamente los cambios realizados en los grupos de tu IdP.
Configurar el mapeo de grupos
La configuración del mapeo de grupos implica configurar tu proveedor de identidad para que comparta la información del grupo con Docker. Esto requiere:
- Crear grupos en tu IdP utilizando el formato de nomenclatura de Docker.
- Configurar atributos para que tu IdP envíe los datos del grupo durante la autenticación.
- Añadir usuarios a los grupos adecuados.
- Probar la conexión para garantizar que los grupos se sincronicen correctamente.
Puedes usar el mapeo de grupos solo con SSO, o tanto con SSO como con SCIM para una gestión mejorada del ciclo de vida del usuario.
Formato de nomenclatura de grupos
Crea grupos en tu IdP utilizando el formato: organización:equipo.
Por ejemplo:
- Para el equipo "developers" en la organización "moby":
moby:developers - Para el acceso a varias organizaciones:
moby:backendywhale:desktop
Docker crea los equipos automáticamente si no existen cuando los grupos se sincronizan.
Atributos admitidos
| Atributo | Descripción |
|---|---|
id | ID único del grupo en formato UUID. Este atributo es de solo lectura. |
displayName | Nombre del grupo que sigue el formato de mapeo de grupos: organización:equipo. |
members | Una lista de usuarios que son miembros de este grupo. |
members(x).value | ID único del usuario que es miembro de este grupo. Los miembros se referencian por ID. |
Configure group mapping with SSO
Usa el mapeo de grupos con conexiones SSO que utilizan el método de autenticación SAML.
NoteEl mapeo de grupos con SSO no es compatible con el método de autenticación de Azure AD (OIDC). SCIM no es necesario para estas configuraciones.
La interfaz de usuario de tu IdP puede diferir ligeramente de los siguientes pasos. Consulta la documentación de Okta para verificarlo.
Para configurar el mapeo de grupos:
- Inicia sesión en Okta y abre tu aplicación.
- Navega a la página SAML Settings (Ajustes de SAML) para tu aplicación.
- En la sección Group Attribute Statements (optional) (Declaraciones de atributos de grupo, opcional), realiza la siguiente configuración:
- Name (Nombre):
groups - Name format (Formato de nombre):
Unspecified - Filter (Filtro):
Starts with(Comienza con) +organización:dondeorganizaciónes el nombre de tu organización. La opción de filtro filtrará los grupos que no están afiliados a tu organización de Docker.
- Name (Nombre):
- Crea tus grupos seleccionando Directory (Directorio) y luego Groups (Grupos).
- Añade tus grupos usando el formato
organización:equipoque coincida con los nombres de tu organización y equipos en Docker. - Asigna usuarios a los grupos que crees.
La próxima vez que sincronices tus grupos con Docker, tus usuarios se asignarán a los grupos de Docker que definiste.
La interfaz de usuario de tu IdP puede diferir ligeramente de los siguientes pasos. Consulta la documentación de Entra ID para verificarlo.
Para configurar el mapeo de grupos:
- Inicia sesión en Entra ID y abre tu aplicación.
- Selecciona Manage (Gestionar), luego Single sign-on (Inicio de sesión único).
- Selecciona Add a group claim (Añadir una reclamación de grupo).
- En la sección Group Claims (Reclamaciones de grupo), selecciona Groups assigned to the application (Grupos asignados a la aplicación) con el atributo de origen Cloud-only group display names (Preview).
- Selecciona Advanced options (Opciones avanzadas), luego la opción Filter groups (Filtrar grupos).
- Configura el atributo como se indica a continuación:
- Attribute to match (Atributo a coincidir):
Display name - Match with (Coincidir con):
Contains(Contiene) - String (Cadena):
:
- Attribute to match (Atributo a coincidir):
- Selecciona Save (Guardar).
- Selecciona Groups (Grupos), All groups (Todos los grupos), luego New group (Nuevo grupo) para crear tus grupos.
- Asigna usuarios a los grupos que crees.
La próxima vez que sincronices tus grupos con Docker, tus usuarios se asignarán a los grupos de Docker que definiste.
Configure group mapping with SCIM
Usa el mapeo de grupos con SCIM para una gestión más avanzada del ciclo de vida del usuario. Antes de comenzar, asegúrate de haber configurado SCIM primero.
La interfaz de usuario de tu IdP puede diferir ligeramente de los siguientes pasos. Consulta la documentación de Okta para verificarlo.
Para configurar tus grupos:
- Inicia sesión en Okta y abre tu aplicación.
- Selecciona Applications (Aplicaciones), luego Provisioning (Aprovisionamiento) e Integration (Integración).
- Selecciona Edit (Editar) para habilitar los grupos en tu conexión, luego selecciona Push groups (Enviar grupos).
- Selecciona Save (Guardar). Guardar esta configuración añadirá la pestaña Push Groups a tu aplicación.
- Crea tus grupos navegando a Directory (Directorio) y seleccionando Groups (Grupos).
- Añade tus grupos usando el formato
organización:equipoque coincida con los nombres de tu organización y equipos en Docker. - Asigna usuarios a los grupos que crees.
- Regresa a la página Integration (Integración), luego selecciona la pestaña Push Groups para abrir la vista donde puedes controlar y gestionar cómo se aprovisionan los grupos.
- Selecciona Push Groups, luego Find groups by rule (Buscar grupos por regla).
- Configura los grupos por regla como se indica a continuación:
- Introduce un nombre de regla, por ejemplo
Sync groups with Docker Hub - Coincidir grupo por nombre, por ejemplo, que comience con
docker:o contenga:para varias organizaciones. - Si habilitas Immediately push groups by rule (Enviar grupos por regla inmediatamente), la sincronización ocurrirá tan pronto como haya un cambio en el grupo o en las asignaciones de grupo. Habilita esto si no deseas enviar los grupos manualmente.
- Introduce un nombre de regla, por ejemplo
Encuentra tu nueva regla en By rule (Por regla) en la columna Pushed Groups (Grupos enviados). Los grupos que coinciden con esa regla se enumeran en la tabla de grupos en el lado derecho.
Para enviar los grupos desde esta tabla:
- Selecciona Group in Okta.
- Selecciona el menú desplegable Push Status (Estado de envío).
- Selecciona Push Now (Enviar ahora).
La interfaz de usuario de tu IdP puede diferir ligeramente de los siguientes pasos. Consulta la documentación de Entra ID para verificarlo.
Completa lo siguiente antes de configurar el mapeo de grupos:
- Inicia sesión en Entra ID y ve a tu aplicación.
- In tu aplicación, selecciona Provisioning (Aprovisionamiento), luego Mappings (Mapeos).
- Selecciona Provision Microsoft Entra ID Groups (Aprovisionar grupos de Microsoft Entra ID).
- Selecciona Show advanced options (Mostrar opciones avanzadas), luego Edit attribute list (Editar lista de atributos).
- Actualiza el tipo de
externalIdareference, luego selecciona la casilla de verificación Multi-Value y elige el atributo de objeto referenciadourn:ietf:params:scim:schemas:core:2.0:Group. - Selecciona Save (Guardar), luego Yes (Sí) para confirmar.
- Ve a Provisioning (Aprovisionamiento).
- Cambia Provision Status (Estado de aprovisionamiento) a On (Activado), luego selecciona Save (Guardar).
A continuación, configura el mapeo de grupos:
- Ve a la página de descripción general de la aplicación.
- Bajo Provision user accounts (Aprovisionar cuentas de usuario), selecciona Get started (Comenzar).
- Selecciona Add user/group (Añadir usuario/grupo).
- Crea tus grupos utilizando el formato
organización:equipo. - Asigna el grupo al grupo de aprovisionamiento.
- Selecciona Start provisioning (Iniciar aprovisionamiento) para comenzar la sincronización.
Para verificarlo, selecciona Monitor (Monitorear), luego Provisioning logs (Registros de aprovisionamiento) para ver que tus grupos se aprovisionaron correctamente. En tu organización de Docker, puedes comprobar que los grupos se aprovisionaron correctamente y que los miembros se añadieron a los equipos correspondientes.
Una vez completado, un usuario que inicie sesión en Docker a través de SSO se añadirá automáticamente a las organizaciones y equipos mapeados en el IdP.
TipHabilita SCIM para aprovechar el aprovisionamiento y desaprovisionamiento automático de usuarios. Si no habilitas SCIM, los usuarios solo se aprovisionarán automáticamente. Tendrás que desaprovisionarlos manualmente.
Siguientes pasos
- Asignar roles a los miembros de tu organización.
- Exigir inicio de sesión, si es necesario.