> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping.md).

# Asignación de grupos

Mantén sincronizada la pertenencia a los grupos de Dispel con los grupos de tu proveedor de identidad. Asigna grupos de Microsoft Entra ID u Okta a grupos de Dispel mediante OAuth (OIDC) o SAML.

## Descripción general

Dispel simplifica la gestión de la pertenencia a grupos al permitir la asignación directa entre los grupos del proveedor de identidad (IdP) y los grupos de Dispel. Una vez asignados los grupos, los cambios realizados en el IdP se reflejan en Dispel en la siguiente sincronización programada, normalmente en unos minutos. Por ejemplo, al añadir o quitar usuarios de un grupo del IdP, se actualiza su pertenencia al grupo correspondiente de Dispel, salvo las excepciones descritas en [Cómo funciona la sincronización](#how-sync-works). Esta integración permite a las organizaciones gestionar usuarios y grupos mediante una solución única y centralizada, intuitiva y auditable por diseño.

La configuración de la asignación de grupos consta de dos pasos:

1. [Configura tu proveedor de identidad](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping/configure-your-identity-provider.md) para que Dispel pueda leer la pertenencia a los grupos.
2. [Asignar grupos](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping/map-groups.md) para anular la asignación de grupos en el panel.

{% hint style="info" %}
Active Directory tiene su propia asignación de grupos, que se configura como parte de la integración. Consulta [Asignar grupos de AD a grupos de Dispel](https://docs.dispel.com/pages/c170461a149cd6bedd332e8b8bbd278865a3a0d2#id-8.-map-a-d-groups-to-dispel-groups).
{% endhint %}

## Proveedores de identidad compatibles

| Protocolo de inicio de sesión | Proveedor de identidad | Cómo se emparejan los grupos                                                               |
| ----------------------------- | ---------------------- | ------------------------------------------------------------------------------------------ |
| OAuth (OIDC)                  | Microsoft Entra ID     | Por nombre del grupo                                                                       |
| OAuth (OIDC)                  | Okta                   | Por nombre del grupo                                                                       |
| SAML                          | Microsoft Entra ID     | Por el propio grupo de Entra ID (su ID de objeto), que se selecciona mediante una búsqueda |

## Cómo funciona la sincronización

* **La sincronización se ejecuta según una programación.** Dispel consulta tu IdP cada pocos minutos, por lo que los cambios aparecen en un ciclo de sincronización.
* **Al añadir a alguien al grupo del IdP, se le añade al grupo de Dispel.** Si el usuario ya pertenece a tu organización de Dispel, se le añadirá en la siguiente sincronización. Si no pertenece, se le enviará una invitación y obtendrá acceso la primera vez que inicie sesión con SSO.
* **Al quitar a alguien del grupo del IdP, se le quita del grupo de Dispel en la siguiente sincronización**, salvo que siga incluido en otro grupo del IdP asignado. Hasta que se ejecute esa sincronización, conservará el acceso a Dispel.
* **La sincronización nunca quita a nadie si no puede leer tu IdP.** Si no se puede leer un grupo, sus miembros permanecen en él hasta que se complete correctamente una sincronización posterior.
* **Con SAML, un grupo vacío o eliminado no quita a nadie.** La sincronización considera que un resultado vacío podría deberse a un error de lectura, por lo que los miembros sincronizados del grupo conservan el acceso. Con OIDC, un grupo vacío o eliminado quita a sus miembros sincronizados.

{% hint style="warning" %}
**Quitar al último miembro de un grupo asignado mediante SAML no revoca su acceso.** El grupo vuelve a aparecer vacío, por lo que la sincronización mantiene a sus miembros. Para revocar el acceso, quita al usuario del grupo de Dispel manualmente o anula la asignación del grupo en Dispel, lo que quita a todas las personas sincronizadas desde ese grupo.
{% endhint %}

## Comparación entre OIDC y SAML

Ambos protocolos se sincronizan según una programación, pero difieren en la configuración y en cómo se quitan los miembros. Consulta [Qué ocurre después de asignar un grupo](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group) para conocer las diferencias de sincronización. A continuación se resumen las diferencias de configuración:

|                                                                 | OAuth (OIDC)                                                                                                               | SAML                                                                                       |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Credenciales utilizadas**                                     | Entra ID: el mismo registro de aplicación que utilizas para SSO. Okta: un token de API de Okta                             | Un registro de aplicación de Entra ID independiente, solo para la sincronización de grupos |
| **Asignación de grupos**                                        | Escribe los nombres de los grupos del IdP                                                                                  | Busca tus grupos de Entra ID y selecciona los que quieras asignar                          |
| **Habilitado por**                                              | Dispel, previa solicitud                                                                                                   | Tú, en la configuración de SAML                                                            |
| **Miembros añadidos manualmente**                               | No permitido: un grupo asignado solo puede contener miembros sincronizados                                                 | Permitido: la sincronización no los modifica                                               |
| **Si no se puede leer un grupo asignado**                       | No se quita a nadie                                                                                                        | No se quita a nadie                                                                        |
| **Si un grupo asignado vuelve a aparecer vacío**                | Se quita a todas las personas sincronizadas mediante ese grupo                                                             | No se quita a nadie                                                                        |
| **Si se elimina un grupo asignado**                             | Se quita a todas las personas sincronizadas mediante ese grupo                                                             | No se elimina a nadie. Elimina la asignación si el grupo desapareció definitivamente       |
| **Si se cambia el nombre de un grupo asignado**                 | Se elimina a todas las personas sincronizadas a través de ese grupo hasta que actualices la asignación con el nuevo nombre | No es necesario realizar ninguna acción: la asignación sigue al grupo                      |
| **Si alguien abandona un grupo antes de aceptar su invitación** | Su invitación se revoca solo si Dispel también ha habilitado la sincronización de usuarios para tu organización            | Su invitación se revoca                                                                    |

Para obtener más información sobre lo que hace cada cambio, consulta [Qué ocurre después de asignar un grupo](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group).

## Ventajas

1. **Gestión centralizada del acceso**
   * Los administradores gestionan los roles de usuario directamente en el IdP, lo que elimina la necesidad de configurar permisos en cada aplicación.
   * Los permisos de las aplicaciones están vinculados a los grupos del IdP, lo que garantiza un flujo de trabajo coherente y optimizado.
2. **Aprovisionamiento automatizado**
   * El acceso de los usuarios se actualiza en la siguiente sincronización programada después de que se realicen cambios en el IdP.
   * La sincronización de grupos aplica los cambios de pertenencia según un calendario, sujeto a las [reglas de sincronización específicas del protocolo](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group). Los grupos SAML vacíos o eliminados no eliminan automáticamente a sus miembros sincronizados.
3. **Seguridad mejorada**
   * Los controles centralizados minimizan los riesgos de configuraciones incorrectas y permisos obsoletos.
   * Los permisos se sincronizan periódicamente con la pertenencia a grupos del IdP, por lo que se revoca el acceso obsoleto sin necesidad de una revisión manual.
4. **Escalabilidad**
   * Los permisos se gestionan a nivel de grupo, lo que facilita aplicar cambios a grandes cantidades de usuarios.
   * Añadir o quitar usuarios de un grupo actualiza en bloque el acceso a varias aplicaciones, lo que simplifica la gestión a medida que crecen las organizaciones.
5. **Mejora de la experiencia del usuario**
   * Los usuarios reciben automáticamente permisos según los grupos a los que pertenecen, sin necesidad de configuración adicional.
   * Una vez autenticados, acceden sin complicaciones a las aplicaciones, con los roles correctos ya asignados.
6. **Preparación para el cumplimiento normativo y las auditorías**
   * La asignación de roles a grupos garantiza registros de auditoría claros y coherentes.
   * Los IdP suelen registrar los cambios en la pertenencia a grupos, lo que facilita el seguimiento y la verificación de los permisos de acceso con fines de cumplimiento normativo.

Al integrar la asignación de grupos, las organizaciones obtienen una forma escalable, segura y eficiente de gestionar el acceso, al tiempo que simplifican el cumplimiento normativo y ofrecen a los usuarios una experiencia fluida.

## Próximos pasos

[Paso 1: Configurar el proveedor de identidad para la asignación de grupos](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping/configure-your-identity-provider.md)

[Paso 2: Asignar grupos en el panel de control de Dispel](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping/map-groups.md)

## Relacionado

* [Proveedores de identidad](https://docs.dispel.com/documentation/documentation-es/proteger-y-gobernar/identity-providers.md)
* [Microsoft Entra ID](https://docs.dispel.com/documentation/documentation-es/proteger-y-gobernar/identity-providers/microsoft-entra-id.md)
* [Okta](https://docs.dispel.com/documentation/documentation-es/proteger-y-gobernar/identity-providers/okta.md)
* [Grupos de organizaciones](https://docs.dispel.com/documentation/documentation-es/gestionar-usuarios-y-acceso/groups/organization-groups.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/group-mapping.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
