> 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-nl/integreren-en-beheren/integrations/group-mapping.md).

# Groepstoewijzing

Houd het groepslidmaatschap in Dispel synchroon met de groepen in je identiteitsprovider. Koppel Microsoft Entra ID- of Okta-groepen aan Dispel-groepen via OAuth (OIDC) of SAML.

## Overzicht

Dispel vereenvoudigt het beheer van groepslidmaatschappen door directe koppeling tussen groepen van de identiteitsprovider (IdP) en Dispel-groepen te ondersteunen. Wanneer groepen zijn gekoppeld, worden wijzigingen in de IdP bij de volgende geplande synchronisatie in Dispel doorgevoerd, meestal binnen enkele minuten. Als bijvoorbeeld gebruikers aan een IdP-groep worden toegevoegd of eruit worden verwijderd, wordt hun lidmaatschap van de bijbehorende Dispel-groep bijgewerkt, met de uitzonderingen die worden beschreven in [Hoe synchronisatie werkt](#how-sync-works). Met deze integratie kunnen organisaties gebruikers en groepen beheren via één centrale oplossing die intuïtief is en standaard volledig controleerbaar is.

Het instellen van groepskoppelingen bestaat uit twee stappen:

1. [Je identiteitsprovider configureren](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/group-mapping/configure-your-identity-provider.md) zodat Dispel het groepslidmaatschap kan lezen.
2. [Groepen koppelen](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/group-mapping/map-groups.md) om groepen in het Dashboard op te heffen.

{% hint style="info" %}
Active Directory heeft een eigen groepskoppeling, die als onderdeel van de integratie wordt ingesteld. Zie [AD-groepen koppelen aan Dispel-groepen](https://docs.dispel.com/pages/38b494bad2b21eaf8a189268053c331159992f5a#id-8.-map-a-d-groups-to-dispel-groups).
{% endhint %}

## Ondersteunde identiteitsproviders

| Aanmeldprotocol | Identiteitsprovider | Hoe groepen worden gekoppeld                                                |
| --------------- | ------------------- | --------------------------------------------------------------------------- |
| OAuth (OIDC)    | Microsoft Entra ID  | Op basis van groepsnaam                                                     |
| OAuth (OIDC)    | Okta                | Op basis van groepsnaam                                                     |
| SAML            | Microsoft Entra ID  | Op basis van de Entra ID-groep zelf (de object-ID), geselecteerd via zoeken |

## Hoe synchronisatie werkt

* **Synchronisatie wordt volgens een schema uitgevoerd.** Dispel controleert je IdP om de paar minuten, zodat wijzigingen binnen één synchronisatiecyclus zichtbaar zijn.
* **Als je iemand aan de IdP-groep toevoegt, wordt diegene aan de Dispel-groep toegevoegd.** Als een gebruiker al deel uitmaakt van je Dispel-organisatie, wordt diegene bij de volgende synchronisatie toegevoegd. Zo niet, dan wordt de gebruiker uitgenodigd en krijgt diegene toegang zodra die zich voor het eerst aanmeldt met SSO.
* **Als je iemand uit de IdP-groep verwijdert, wordt diegene bij de volgende synchronisatie uit de Dispel-groep verwijderd**, tenzij diegene nog lid is van een andere gekoppelde IdP-groep. Totdat die synchronisatie plaatsvindt, behoudt diegene de toegang tot Dispel.
* **Bij een fout bij het lezen van je IdP verwijdert de synchronisatie nooit iemand.** Als een groep niet kan worden gelezen, blijven de leden ervan behouden totdat een latere synchronisatie slaagt.
* **Bij SAML verwijdert een lege of verwijderde groep niemand.** De synchronisatie beschouwt een leeg resultaat als een mogelijke leesfout, zodat de gesynchroniseerde leden van de groep hun toegang behouden. Bij OIDC verwijdert een lege of verwijderde groep de gesynchroniseerde leden ervan.

{% hint style="warning" %}
**Als het laatste lid van een aan SAML gekoppelde groep wordt verwijderd, wordt diens toegang niet ingetrokken.** De groep wordt leeg teruggegeven, dus de synchronisatie laat de leden erin staan. Als je de toegang wilt intrekken, verwijder je de gebruiker handmatig uit de Dispel-groep of ontkoppel je de groep in Dispel. Daarmee verwijder je iedereen die via die groep is gesynchroniseerd.
{% endhint %}

## OIDC en SAML vergeleken

Beide protocollen synchroniseren volgens een schema, maar de configuratie en het gedrag bij het verwijderen van leden verschillen. Zie [Wat er gebeurt nadat je een groep hebt gekoppeld](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group) voor de verschillen in synchronisatie. Hieronder worden de verschillen in configuratie samengevat:

|                                                                            | OAuth (OIDC)                                                                                                           | SAML                                                                                     |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Gebruikte referenties**                                                  | Entra ID: dezelfde app-registratie die je voor SSO gebruikt. Okta: een Okta API-token                                  | Een afzonderlijke Entra ID-app-registratie, uitsluitend voor groepssynchronisatie        |
| **Groepen koppelen**                                                       | Typ de groepsnamen van de IdP                                                                                          | Zoek in je Entra ID-groepen en selecteer de groepen die je wilt koppelen                 |
| **Ingeschakeld door**                                                      | Dispel, op verzoek                                                                                                     | Jou, in de SAML-instellingen                                                             |
| **Handmatig toegevoegde leden**                                            | Niet toegestaan: een gekoppelde groep mag alleen gesynchroniseerde leden bevatten                                      | Toegestaan: de synchronisatie laat ze ongemoeid                                          |
| **Als een gekoppelde groep niet kan worden gelezen**                       | Niemand wordt verwijderd                                                                                               | Niemand wordt verwijderd                                                                 |
| **Als een gekoppelde groep leeg terugkomt**                                | Iedereen die via die groep is gesynchroniseerd, wordt verwijderd                                                       | Niemand wordt verwijderd                                                                 |
| **Als een gekoppelde groep wordt verwijderd**                              | Iedereen die via die groep is gesynchroniseerd, wordt verwijderd                                                       | Er wordt niemand verwijderd. Verwijder de koppeling als de groep definitief is opgeheven |
| **Als een gekoppelde groep een andere naam krijgt**                        | Iedereen die via die groep is gesynchroniseerd, wordt verwijderd totdat je de koppeling bijwerkt met de nieuwe naam    | Geen actie nodig: de koppeling volgt de groep                                            |
| **Als iemand een groep verlaat voordat diegene de uitnodiging accepteert** | De uitnodiging wordt alleen ingetrokken als Dispel ook gebruikerssynchronisatie voor je organisatie heeft ingeschakeld | De uitnodiging wordt ingetrokken                                                         |

Zie voor meer informatie over de gevolgen van elke wijziging [Wat er gebeurt nadat je een groep hebt gekoppeld](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group).

## Voordelen

1. **Gecentraliseerd toegangsbeheer**
   * Beheerders beheren gebruikersrollen rechtstreeks in de IdP, waardoor het niet meer nodig is om machtigingen in afzonderlijke applicaties in te stellen.
   * Machtigingen voor applicaties zijn gekoppeld aan IdP-groepen, wat zorgt voor een consistente en gestroomlijnde workflow.
2. **Geautomatiseerde inrichting**
   * De gebruikerstoegang wordt bijgewerkt bij de eerstvolgende geplande synchronisatie nadat er wijzigingen zijn aangebracht in de IdP.
   * Groepssynchronisatie verwerkt lidmaatschapswijzigingen volgens een schema, met inachtneming van de [protocolspecifieke synchronisatieregels](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group). Lege of verwijderde SAML-groepen verwijderen hun gesynchroniseerde leden niet automatisch.
3. **Verbeterde beveiliging**
   * Gecentraliseerde beheeropties beperken het risico op onjuiste configuraties en verouderde machtigingen.
   * Machtigingen worden volgens een vast schema gesynchroniseerd met de groepslidmaatschappen in de IdP, zodat verouderde toegang wordt opgeschoond zonder handmatige controle.
4. **Schaalbaarheid**
   * Machtigingen worden op groepsniveau beheerd, waardoor wijzigingen eenvoudig kunnen worden doorgevoerd voor grote gebruikersgroepen.
   * Als je gebruikers aan een groep toevoegt of eruit verwijdert, wordt de toegang voor meerdere applicaties in één keer bijgewerkt. Zo wordt het beheer eenvoudiger naarmate organisaties groeien.
5. **Verbeterde gebruikerservaring**
   * Gebruikers krijgen automatisch machtigingen op basis van de groepen waaraan ze zijn toegewezen. Er is geen extra configuratie nodig.
   * Na authenticatie krijgen ze naadloos toegang tot applicaties, met de juiste rollen al ingesteld.
6. **Naleving en auditgereedheid**
   * Dankzij de koppeling van rollen aan groepen zijn audittrails duidelijk en consistent.
   * IdP's registreren wijzigingen in groepslidmaatschappen vaak in logboeken. Daardoor zijn toegangsrechten eenvoudiger te traceren en te verifiëren voor nalevingsdoeleinden.

Door groepskoppelingen te integreren, kunnen organisaties toegang schaalbaar, veilig en efficiënt beheren. Tegelijkertijd vereenvoudigen ze de naleving en bieden ze gebruikers een naadloze ervaring.

## Volgende stappen

[Stap 1: Configureer de identiteitsprovider voor groepskoppelingen](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/group-mapping/configure-your-identity-provider.md)

[Stap 2: Koppel groepen in het Dispel-dashboard](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/group-mapping/map-groups.md)

## Gerelateerd

* [Identiteitsproviders](https://docs.dispel.com/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md)
* [Microsoft Entra ID](https://docs.dispel.com/documentation/documentation-nl/beveiligen-en-beheren/identity-providers/microsoft-entra-id.md)
* [Okta](https://docs.dispel.com/documentation/documentation-nl/beveiligen-en-beheren/identity-providers/okta.md)
* [Organisatiegroepen](https://docs.dispel.com/documentation/documentation-nl/gebruikers-en-toegang-beheren/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-nl/integreren-en-beheren/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.
