> 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-pt-br/integre-e-administre/integrations/group-mapping.md).

# Mapeamento de grupos

Mantenha a participação em grupos do Dispel sincronizada com os grupos do seu provedor de identidade. Mapeie grupos do Microsoft Entra ID ou do Okta para grupos do Dispel usando OAuth (OIDC) ou SAML.

## Visão geral

O Dispel simplifica o gerenciamento da participação em grupos ao permitir o mapeamento direto entre grupos do provedor de identidade (IdP) e grupos do Dispel. Quando os grupos são mapeados, as alterações feitas no IdP são refletidas no Dispel na próxima sincronização agendada, geralmente em poucos minutos. Por exemplo, adicionar ou remover usuários de um grupo do IdP atualiza a participação deles no grupo correspondente do Dispel, com as exceções descritas em [Como funciona a sincronização](#how-sync-works). Essa integração permite que as organizações gerenciem usuários e grupos por meio de uma única solução centralizada, intuitiva e inerentemente auditável.

A configuração do mapeamento de grupos envolve duas etapas:

1. [Configure seu provedor de identidade](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/group-mapping/configure-your-identity-provider.md) para que o Dispel possa ler a participação nos grupos.
2. [Mapeie os grupos](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/group-mapping/map-groups.md) para os grupos do Dispel no Dashboard.

{% hint style="info" %}
O Active Directory tem um mapeamento de grupos próprio, configurado como parte da integração. Consulte [Mapear grupos do AD para grupos do Dispel](https://docs.dispel.com/pages/d6ba60feabd12e839a07de1494a63903a5651868#id-8.-map-a-d-groups-to-dispel-groups).
{% endhint %}

## Provedores de identidade compatíveis

| Protocolo de autenticação | Provedor de identidade | Como os grupos são correspondidos                                                 |
| ------------------------- | ---------------------- | --------------------------------------------------------------------------------- |
| OAuth (OIDC)              | Microsoft Entra ID     | Pelo nome do grupo                                                                |
| OAuth (OIDC)              | Okta                   | Pelo nome do grupo                                                                |
| SAML                      | Microsoft Entra ID     | Pelo próprio grupo do Entra ID (seu ID de objeto), escolhido por meio da pesquisa |

## Como funciona a sincronização

* **A sincronização é executada conforme uma programação.** O Dispel verifica seu IdP a cada poucos minutos, então as alterações aparecem em um ciclo de sincronização.
* **Adicionar alguém ao grupo do IdP adiciona essa pessoa ao grupo do Dispel.** Se um usuário já pertencer à sua organização no Dispel, ele será adicionado na próxima sincronização. Caso contrário, receberá um convite e terá acesso na primeira vez que entrar usando SSO.
* **Remover alguém do grupo do IdP remove essa pessoa do grupo do Dispel na próxima sincronização**, a menos que outro grupo do IdP mapeado ainda inclua essa pessoa. Até a execução dessa sincronização, ela continua tendo acesso ao Dispel.
* **A sincronização nunca remove ninguém quando não consegue ler seu IdP.** Se não for possível ler um grupo, seus membros permanecem nele até que uma sincronização posterior seja concluída com sucesso.
* **Com SAML, um grupo vazio ou excluído não remove ninguém.** A sincronização considera um resultado vazio uma possível falha de leitura, portanto os membros sincronizados do grupo continuam com acesso. Com OIDC, um grupo vazio ou excluído remove seus membros sincronizados.

{% hint style="warning" %}
**Remover o último membro de um grupo mapeado por SAML não revoga o acesso dessa pessoa.** O grupo volta vazio, então a sincronização mantém seus membros. Para revogar o acesso, remova o usuário manualmente do grupo do Dispel ou desfaça o mapeamento do grupo no Dispel, o que remove todos os membros sincronizados dele.
{% endhint %}

## Comparação entre OIDC e SAML

Ambos os protocolos sincronizam conforme uma programação, mas diferem na configuração e no comportamento de remoção de membros. Consulte [O que acontece depois que você mapeia um grupo](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group) para ver as diferenças de sincronização. As diferenças de configuração estão resumidas abaixo:

|                                                           | OAuth (OIDC)                                                                                                           | SAML                                                                                   |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| **Credenciais usadas**                                    | Entra ID: o mesmo registro de aplicativo usado para SSO. Okta: um token de API do Okta                                 | Um registro de aplicativo separado no Entra ID, dedicado à sincronização de grupos     |
| **Mapeamento de grupos**                                  | Digite os nomes dos grupos do IdP                                                                                      | Pesquise seus grupos do Entra ID e selecione aqueles que deseja mapear                 |
| **Habilitado por**                                        | Dispel, mediante solicitação                                                                                           | Você, nas configurações de SAML                                                        |
| **Membros adicionados manualmente**                       | Não permitido: um grupo mapeado deve conter apenas membros sincronizados                                               | Permitido: a sincronização não os altera                                               |
| **Se não for possível ler um grupo mapeado**              | Ninguém é removido                                                                                                     | Ninguém é removido                                                                     |
| **Se um grupo mapeado ficar vazio**                       | Todos os usuários sincronizados por esse grupo são removidos                                                           | Ninguém é removido                                                                     |
| **Se um grupo mapeado for excluído**                      | Todos os usuários sincronizados por esse grupo são removidos                                                           | Ninguém é removido. Remova o mapeamento se o grupo tiver sido excluído definitivamente |
| **Se um grupo mapeado for renomeado**                     | Todos os usuários sincronizados por esse grupo são removidos até que você atualize o mapeamento com o novo nome        | Nenhuma ação necessária: o mapeamento acompanha o grupo                                |
| **Se alguém sair de um grupo antes de aceitar o convite** | O convite dessa pessoa só é revogado se a Dispel também tiver ativado a sincronização de usuários para sua organização | O convite dessa pessoa é revogado                                                      |

Para saber mais sobre o efeito de cada alteração, consulte [O que acontece depois que você mapeia um grupo](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group).

## Benefícios

1. **Gerenciamento centralizado de acesso**
   * Os administradores gerenciam as funções dos usuários diretamente no IdP, eliminando a necessidade de configurar permissões em cada aplicativo.
   * As permissões dos aplicativos são vinculadas aos grupos do IdP, garantindo um fluxo de trabalho consistente e simplificado.
2. **Provisionamento automatizado**
   * O acesso dos usuários é atualizado na próxima sincronização agendada após as alterações serem feitas no IdP.
   * A sincronização de grupos aplica alterações de associação conforme um cronograma, sujeita às [regras de sincronização específicas do protocolo](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group). Grupos SAML vazios ou excluídos não removem automaticamente os membros sincronizados.
3. **Segurança aprimorada**
   * Os controles centralizados minimizam os riscos de configurações incorretas e permissões desatualizadas.
   * As permissões são sincronizadas regularmente com as associações aos grupos do IdP, para que acessos desatualizados sejam removidos sem necessidade de revisão manual.
4. **Escalabilidade**
   * As permissões são gerenciadas no nível do grupo, facilitando a aplicação de alterações em grandes bases de usuários.
   * Adicionar ou remover usuários de um grupo atualiza em lote o acesso a vários aplicativos, simplificando o gerenciamento em organizações em crescimento.
5. **Experiência aprimorada para o usuário**
   * Os usuários recebem automaticamente permissões com base nos grupos aos quais pertencem, sem necessidade de configuração adicional.
   * Após a autenticação, eles têm acesso contínuo aos aplicativos, com as funções corretas já configuradas.
6. **Conformidade e preparação para auditorias**
   * O mapeamento de funções para grupos garante trilhas de auditoria claras e consistentes.
   * Os IdPs geralmente registram alterações nas associações aos grupos, facilitando o rastreamento e a verificação das permissões de acesso para fins de conformidade.

Com a integração do mapeamento de grupos, as organizações obtêm uma forma escalável, segura e eficiente de gerenciar o acesso, simplificando a conformidade e proporcionando uma experiência fluida aos usuários.

## Próximas etapas

[Etapa 1: configure o provedor de identidade para o mapeamento de grupos](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/group-mapping/configure-your-identity-provider.md)

[Etapa 2: mapeie os grupos no painel da Dispel](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/group-mapping/map-groups.md)

## Relacionado

* [Provedores de identidade](https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md)
* [Microsoft Entra ID](https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/microsoft-entra-id.md)
* [Okta](https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/okta.md)
* [Grupos da organização](https://docs.dispel.com/documentation/documentation-pt-br/gerencie-usuarios-e-acesso/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-pt-br/integre-e-administre/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.
