Gruppen aus Microsoft Entra ID
Wer sich über Microsoft Entra ID anmeldet, bringt seine Entra-Gruppen mit. BasePeak.AI kann daraus Gruppen, Rollen und Agentenfreigaben ableiten, sodass Sie Zuständigkeiten nicht zweimal pflegen müssen: Wer in Entra in der Gruppe „Amt 10“ ist, landet automatisch in der BasePeak.AI-Gruppe „Amt 10“, erhält deren Rollen und sieht die für die Gruppe freigegebenen Agenten.
So funktioniert es
- Bei der Anmeldung sendet Entra ID die Gruppen des Benutzers im groups-Claim des Tokens. Eine laufende Sitzung erneuert das Token etwa stündlich und erhält dabei die aktuellen Gruppen.
- BasePeak.AI speichert diese Werte am Benutzer. Sie sehen sie in der Benutzer-Detailansicht unter Erweiterte Details → OAuth-Claim-Gruppen.
- Auto-Zuweisungsregeln an einer BasePeak.AI-Gruppe legen fest, welche Werte in diese Gruppe führen (siehe Gruppen).
- Eine Gruppe kann Rollen tragen und für Agenten freigegeben werden. Mitglieder erhalten beides.
Fällt ein Benutzer in Entra aus einer Gruppe heraus, entfernt BasePeak.AI die automatische Mitgliedschaft wieder, sobald das Token die Änderung trägt (siehe Hinweise). Manuell hinzugefügte Mitglieder bleiben davon unberührt.
1. Gruppen-Claim in Entra einrichten
Entra sendet Gruppen erst, wenn die App-Registrierung das vorsieht:
- Öffnen Sie im Entra Admin Center die App-Registrierung, die BasePeak.AI für die Anmeldung verwendet.
- Wählen Sie Tokenkonfiguration → Gruppenanspruch hinzufügen (englisch: Token configuration → Add groups claim).
- Wählen Sie die Gruppentypen, typischerweise Sicherheitsgruppen (Security groups), oder Der Anwendung zugewiesene Gruppen (Groups assigned to the application, siehe Viele Gruppen).
- Legen Sie fest, in welcher Form die Gruppen im ID-Token stehen:
- Gruppen-ID (Standard): Entra sendet die Objekt-IDs der Gruppen, z. B.
6f1c2c3e-…. Das funktioniert immer. - sAMAccountName: nur für Gruppen, die aus einem lokalen Active Directory synchronisiert werden.
- Anzeigenamen von reinen Cloudgruppen (Cloud-only group display names): für Gruppen, die nur in Entra existieren, wenn Sie Der Anwendung zugewiesene Gruppen gewählt haben.
- Gruppen-ID (Standard): Entra sendet die Objekt-IDs der Gruppen, z. B.
In BasePeak.AI ist für Entra ID nichts weiter einzustellen. Unter Auth-Anbieter → … → Gruppen-Sync finden Sie denselben Hinweis.
Sie müssen keine IDs abtippen. Sobald sich Benutzer angemeldet haben, bietet der Regel-Dialog die gesehenen Werte zur Auswahl an, mit der Anzahl der Benutzer je Wert. Den Anzeigenamen einer Gruppe zu ihrer ID finden Sie im Entra Admin Center unter Gruppen.
2. Einmal anmelden
Melden Sie sich mit einem Testbenutzer an, der in den gewünschten Entra-Gruppen ist. Prüfen Sie danach in der Benutzer-Detailansicht unter Erweiterte Details, dass die OAuth-Claim-Gruppen erscheinen. Ist die Liste leer, sendet Entra noch keinen Gruppen-Claim. Prüfen Sie dann Schritt 1.
3. Gruppe und Auto-Zuweisungsregel anlegen
- Legen Sie unter Gruppen eine Gruppe an, z. B.
amt-10mit dem Anzeigenamen „Amt 10“. - Klicken Sie in der Gruppe auf Regel hinzufügen.
- Wählen Sie unter Auth-Anbieter Ihre Entra-Instanz.
- Klicken Sie unter Bei Anmeldungen gesehen auf den Wert der Entra-Gruppe. Er erscheint als ausgewählter Wert unter dem Feld Werte. Mehrere Werte verknüpft die Regel mit „oder“.
- Klicken Sie auf Erstellen.
Die Regel greift nach spätestens etwa einer Minute bei der nächsten Aktion jedes angemeldeten Benutzers, ohne erneute Anmeldung.
4. Rollen und Agentenzugriff an die Gruppe hängen
- Rollen: In der Gruppen-Detailansicht unter Zugewiesene Rollen auf Rolle zuweisen klicken. Alle Mitglieder erhalten die Berechtigungen der Rolle.
- Agenten: Im Agenten-Editor unter Zugriffskontrolle über Veröffentlichen die Gruppe hinzufügen (siehe Agenten).
Wer eine Rolle über welche Gruppe hat, zeigt die Detailansicht der Rolle unter Rollen.
Viele Gruppen pro Benutzer
Ein Token hat in Entra ID Platz für höchstens 200 Gruppen. Ist ein Benutzer in mehr Gruppen, lässt Entra den Gruppen-Claim weg und verweist stattdessen auf Microsoft Graph („Group Overage“). BasePeak.AI fragt diese Gruppen bei der Anmeldung zwar bei Microsoft Graph nach, hält sie aber nicht aktuell: Nach der stündlichen Token-Erneuerung fehlen sie wieder, und die Mitgliedschaften bleiben auf dem Stand der Anmeldung stehen. Graph liefert außerdem immer Gruppen-IDs, auch verschachtelte Gruppen.
Wählen Sie in diesem Fall in Schritt 1 Der Anwendung zugewiesene Gruppen und weisen Sie der Unternehmensanwendung nur die Gruppen zu, die BasePeak.AI kennen muss. Dann enthält das Token nur diese Gruppen. Gruppen einer Anwendung zuzuweisen setzt Entra ID P1 oder P2 voraus.
Hinweise
- Wann wirken Änderungen? BasePeak.AI gleicht die Mitgliedschaften bei jeder Aktion eines angemeldeten Benutzers mit den Gruppen aus seinem Token ab. Neue oder gelöschte Regeln wirken daher nach spätestens etwa einer Minute. Eine Änderung in Entra wirkt, sobald die Sitzung ihr Token erneuert, also nach spätestens etwa einer Stunde oder bei der nächsten Anmeldung.
- Benutzer ohne Gruppen: Verliert ein Benutzer in Entra alle Gruppen, sendet Entra keinen Gruppen-Claim mehr. Seine bisherigen automatischen Mitgliedschaften bleiben dann bestehen, ebenso die angezeigten OAuth-Claim-Gruppen und die Zählung unter Bei Anmeldungen gesehen. Entfernen Sie ihn in diesem Fall manuell aus den Gruppen. Beachten Sie: Ein manuell entfernter Benutzer wird dieser Gruppe auch später nicht mehr automatisch zugeordnet, bis Sie ihn einmal manuell wieder hinzufügen.
- Groß-/Kleinschreibung spielt beim Vergleich von Regelwerten keine Rolle.
- Eine Regel mit Alle Anbieter greift für jede Anmeldung, auch über andere Anbieter. Für Entra-Gruppen-IDs ist das unkritisch, für Namen wie
adminssollten Sie die Entra-Instanz wählen.