> 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-de/integrieren-and-administrieren/integrations/group-mapping.md).

# Gruppenzuordnung

Halten Sie die Gruppenmitgliedschaften in Dispel mit den Gruppen Ihres Identitätsanbieters synchron. Ordnen Sie Microsoft Entra ID- oder Okta-Gruppen über OAuth (OIDC) oder SAML Dispel-Gruppen zu.

## Übersicht

Dispel vereinfacht die Verwaltung von Gruppenmitgliedschaften durch die direkte Zuordnung von Gruppen des Identitätsanbieters (IdP) zu Dispel-Gruppen. Wenn Gruppen zugeordnet sind, werden Änderungen am IdP bei der nächsten geplanten Synchronisierung in Dispel übernommen, normalerweise innerhalb weniger Minuten. Werden beispielsweise Benutzer zu einer IdP-Gruppe hinzugefügt oder daraus entfernt, wird ihre Mitgliedschaft in der entsprechenden Dispel-Gruppe aktualisiert – mit den unter [Funktionsweise der Synchronisierung](#how-sync-works)beschriebenen Ausnahmen. Mit dieser Integration können Unternehmen Benutzer und Gruppen über eine zentrale, intuitive und von Grund auf auditierbare Lösung verwalten.

Die Zuordnung von Gruppen umfasst zwei Schritte:

1. [Identitätsanbieter konfigurieren](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping/configure-your-identity-provider.md) damit Dispel die Gruppenmitgliedschaften auslesen kann.
2. [Gruppen zuordnen](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping/map-groups.md) Gruppen im Dashboard aufzuheben.

{% hint style="info" %}
Active Directory verfügt über eine eigene Gruppenzuordnung, die als Teil der Integration eingerichtet wird. Siehe [AD-Gruppen Dispel-Gruppen zuordnen](https://docs.dispel.com/pages/8bd15e3ffce384260b1027da2e8865d0c9185150#id-8.-map-a-d-groups-to-dispel-groups).
{% endhint %}

## Unterstützte Identitätsanbieter

| Anmeldeprotokoll | Identitätsanbieter | Art des Gruppenabgleichs                                                              |
| ---------------- | ------------------ | ------------------------------------------------------------------------------------- |
| OAuth (OIDC)     | Microsoft Entra ID | Nach Gruppenname                                                                      |
| OAuth (OIDC)     | Okta               | Nach Gruppenname                                                                      |
| SAML             | Microsoft Entra ID | Nach der Entra-ID-Gruppe selbst (ihrer Objekt-ID), die über die Suche ausgewählt wird |

## Funktionsweise der Synchronisierung

* **Die Synchronisierung erfolgt nach einem Zeitplan.** Dispel prüft Ihren IdP alle paar Minuten. Änderungen werden daher innerhalb eines Synchronisierungszyklus übernommen.
* **Wird jemand zur IdP-Gruppe hinzugefügt, wird die Person auch der Dispel-Gruppe hinzugefügt.** Gehört ein Benutzer bereits zu Ihrer Dispel-Organisation, wird er bei der nächsten Synchronisierung hinzugefügt. Andernfalls wird der Benutzer eingeladen und erhält Zugriff, sobald er sich zum ersten Mal mit SSO anmeldet.
* **Wird jemand aus der IdP-Gruppe entfernt, wird die Person bei der nächsten Synchronisierung auch aus der Dispel-Gruppe entfernt**, es sei denn, sie ist weiterhin in einer anderen zugeordneten IdP-Gruppe enthalten. Bis die Synchronisierung erfolgt, behält die Person ihren Dispel-Zugriff.
* **Wenn Dispel Ihren IdP nicht auslesen kann, entfernt die Synchronisierung niemals jemanden.** Kann eine Gruppe nicht ausgelesen werden, bleiben ihre Mitglieder erhalten, bis eine spätere Synchronisierung erfolgreich ist.
* **Bei SAML werden durch eine leere oder gelöschte Gruppe keine Mitglieder entfernt.** Die Synchronisierung behandelt ein leeres Ergebnis als möglichen Lesefehler, sodass die synchronisierten Mitglieder der Gruppe ihren Zugriff behalten. Bei OIDC werden die synchronisierten Mitglieder einer leeren oder gelöschten Gruppe entfernt.

{% hint style="warning" %}
**Wird das letzte Mitglied einer per SAML zugeordneten Gruppe entfernt, wird dessen Zugriff nicht widerrufen.** Die Gruppe wird leer zurückgegeben, daher lässt die Synchronisierung ihre Mitglieder unverändert. Um den Zugriff zu widerrufen, entfernen Sie den Benutzer manuell aus der Dispel-Gruppe oder heben Sie die Zuordnung der Gruppe in Dispel auf. Dadurch werden alle aus dieser Gruppe synchronisierten Mitglieder entfernt.
{% endhint %}

## OIDC und SAML im Vergleich

Bei beiden Protokollen erfolgt die Synchronisierung nach einem Zeitplan, doch Einrichtung und Verhalten beim Entfernen von Mitgliedern unterscheiden sich. Weitere Informationen zu den Unterschieden bei der Synchronisierung finden Sie unter [Was passiert, nachdem Sie eine Gruppe zugeordnet haben](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group) . Die Unterschiede bei der Einrichtung sind unten zusammengefasst:

|                                                                            | OAuth (OIDC)                                                                                                                  | SAML                                                                                                        |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Verwendete Anmeldedaten**                                                | Entra ID: dieselbe App-Registrierung, die Sie für SSO verwenden. Okta: ein Okta-API-Token                                     | Eine separate Entra-ID-App-Registrierung, die ausschließlich für die Gruppensynchronisierung verwendet wird |
| **Gruppen zuordnen**                                                       | Namen der IdP-Gruppen eingeben                                                                                                | Entra-ID-Gruppen suchen und die zuzuordnenden Gruppen auswählen                                             |
| **Aktiviert durch**                                                        | Dispel auf Anfrage                                                                                                            | Sie selbst in den SAML-Einstellungen                                                                        |
| **Manuell hinzugefügte Mitglieder**                                        | Nicht zulässig: Eine zugeordnete Gruppe darf nur synchronisierte Mitglieder enthalten                                         | Zulässig: Die Synchronisierung lässt sie unverändert                                                        |
| **Wenn eine zugeordnete Gruppe nicht ausgelesen werden kann**              | Niemand wird entfernt                                                                                                         | Niemand wird entfernt                                                                                       |
| **Wenn eine zugeordnete Gruppe leer zurückgegeben wird**                   | Alle über diese Gruppe synchronisierten Mitglieder werden entfernt                                                            | Niemand wird entfernt                                                                                       |
| **Wenn eine zugeordnete Gruppe gelöscht wird**                             | Alle über diese Gruppe synchronisierten Mitglieder werden entfernt                                                            | Niemand wird entfernt. Entfernen Sie die Zuordnung, wenn die Gruppe endgültig nicht mehr existiert.         |
| **Wenn eine zugeordnete Gruppe umbenannt wird**                            | Alle, die über diese Gruppe synchronisiert wurden, werden entfernt, bis Sie die Zuordnung auf den neuen Namen aktualisieren.  | Keine Aktion erforderlich: Die Zuordnung folgt der Gruppe.                                                  |
| **Wenn jemand eine Gruppe verlässt, bevor die Einladung angenommen wurde** | Die Einladung wird nur zurückgezogen, wenn Dispel die Benutzersynchronisierung für Ihre Organisation ebenfalls aktiviert hat. | Die Einladung wird zurückgezogen.                                                                           |

Weitere Informationen zu den Auswirkungen der einzelnen Änderungen finden Sie unter [Was nach der Zuordnung einer Gruppe geschieht](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group).

## Vorteile

1. **Zentralisierte Zugriffsverwaltung**
   * Administratoren verwalten Benutzerrollen direkt im IdP. Dadurch entfällt die Notwendigkeit, Berechtigungen in einzelnen Anwendungen zu konfigurieren.
   * Anwendungsberechtigungen sind an IdP-Gruppen gebunden und sorgen so für einen konsistenten und optimierten Arbeitsablauf.
2. **Automatisierte Bereitstellung**
   * Der Benutzerzugriff wird beim nächsten planmäßigen Synchronisierungsvorgang aktualisiert, nachdem Änderungen im IdP vorgenommen wurden.
   * Die Gruppensynchronisierung übernimmt Mitgliedschaftsänderungen nach einem Zeitplan und unterliegt den [protokollspezifischen Synchronisierungsregeln](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group). Leere oder gelöschte SAML-Gruppen entfernen ihre synchronisierten Mitglieder nicht automatisch.
3. **Erhöhte Sicherheit**
   * Zentralisierte Kontrollen verringern das Risiko fehlerhafter Konfigurationen und veralteter Berechtigungen.
   * Berechtigungen werden regelmäßig mit den IdP-Gruppenmitgliedschaften synchronisiert, sodass veraltete Zugriffsrechte ohne manuelle Prüfung bereinigt werden.
4. **Skalierbarkeit**
   * Berechtigungen werden auf Gruppenebene verwaltet. So lassen sich Änderungen problemlos auf große Benutzergruppen anwenden.
   * Wenn Benutzer zu einer Gruppe hinzugefügt oder daraus entfernt werden, wird der Zugriff auf mehrere Anwendungen gesammelt aktualisiert. Das vereinfacht die Verwaltung in wachsenden Organisationen.
5. **Verbesserte Benutzererfahrung**
   * Benutzer erhalten automatisch die Berechtigungen, die ihren Gruppenzuweisungen entsprechen, ohne dass eine zusätzliche Konfiguration erforderlich ist.
   * Nach der Authentifizierung erhalten sie nahtlosen Zugriff auf Anwendungen, in denen die richtigen Rollen bereits eingerichtet sind.
6. **Compliance und Audit-Bereitschaft**
   * Die Zuordnung von Rollen zu Gruppen sorgt für klare und konsistente Audit-Trails.
   * IdPs protokollieren häufig Änderungen an Gruppenmitgliedschaften. Dadurch lassen sich Zugriffsberechtigungen für Compliance-Zwecke leichter nachvollziehen und überprüfen.

Durch die Integration der Gruppenzuordnung erhalten Organisationen eine skalierbare, sichere und effiziente Möglichkeit zur Zugriffsverwaltung. Gleichzeitig werden Compliance-Prozesse vereinfacht und Benutzer profitieren von einer nahtlosen Erfahrung.

## Nächste Schritte

[Schritt 1: Identity Provider für die Gruppenzuordnung konfigurieren](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping/configure-your-identity-provider.md)

[Schritt 2: Gruppen im Dispel-Dashboard zuordnen](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping/map-groups.md)

## Verwandte Themen

* [Identitätsanbieter](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers.md)
* [Microsoft Entra ID](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/microsoft-entra-id.md)
* [Okta](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/okta.md)
* [Organisationsgruppen](https://docs.dispel.com/documentation/documentation-de/benutzer-and-zugriff-verwalten/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-de/integrieren-and-administrieren/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.
