Gruppen
Die Gruppen-Seite (/admin/groups) fasst Benutzer zu Gruppen zusammen. Hat eine Gruppe Rollen, erhalten alle Mitglieder diese Rollen. Über Auto-Zuweisungsregeln nimmt BasePeak.AI Benutzer beim Anmelden zudem automatisch anhand von Werten aus ihrem Identitätsanbieter in eine Gruppe auf.
Zugriff haben Benutzer mit der Rolle Administrator oder Benutzerverwaltung sowie Benutzer mit einer eigenen Rolle, die die Berechtigung group:manage enthält. Die Rollen einer Gruppe verwalten Sie nur mit der Berechtigung user:manage; die Rollen Administrator und Benutzerverwaltung enthalten beide. Eine eigene Rolle mit group:manage, aber ohne user:manage, öffnet die Gruppen, kann aber weder Rollen verwalten noch Mitglieder aus der Benutzerliste auswählen.
Die Seiten Benutzer und Gruppen erscheinen nur, wenn ein Authentifizierungsanbieter konfiguriert ist. Weitere Informationen finden Sie unter Authentifizierungsanbieter.
Gruppenliste
Die Übersicht zeigt alle Gruppen in einer Tabelle mit folgenden Spalten:
| Spalte | Beschreibung |
|---|---|
| Name | Der eindeutige interne Name der Gruppe |
| Anzeigename | Der für die Anzeige verwendete Name |
| Erstellt | Das Erstellungsdatum der Gruppe |
Alle Spalten lassen sich durch Klick auf die Spaltenüberschrift sortieren. Standardmäßig stehen die zuletzt erstellten Gruppen oben. Über das Suchfeld filtern Sie die Liste nach Name oder Anzeigename.
Um die Detailansicht zu öffnen, klicken Sie auf eine Zeile. Sind noch keine Gruppen vorhanden, erscheint der Hinweis Keine Gruppen gefunden.
Gruppe erstellen
- Klicken Sie auf Gruppe erstellen
- Geben Sie unter Name einen eindeutigen Namen ein (Pflichtfeld)
- Optional: Geben Sie einen Anzeigename und eine Beschreibung an
- Klicken Sie auf Gruppe erstellen
Danach öffnet sich die Detailansicht der neuen Gruppe. Dort weisen Sie der Gruppe Rollen zu und nehmen Mitglieder auf.
Gruppendetails
Die Detailansicht einer Gruppe gliedert sich in folgende Karten:
| Karte | Inhalt |
|---|---|
| Mitglieder | Die Benutzer der Gruppe mit ihrer E-Mail-Adresse |
| Zugewiesene Rollen | Die Rollen, die alle Mitglieder der Gruppe erhalten |
| Auto-Zuweisungsregeln | Die Regeln, nach denen Benutzer beim Anmelden automatisch in die Gruppe kommen |
Über die Schaltflächen oben rechts können Sie die Gruppe Bearbeiten oder Löschen.
Mitglieder
So nehmen Sie einen Benutzer in die Gruppe auf:
- Klicken Sie in der Karte Mitglieder auf Mitglied hinzufügen
- Suchen Sie über das Feld Benutzer suchen... nach einem bestehenden Benutzer (nach E-Mail-Adresse oder Benutzername)
- Klicken Sie auf den gewünschten Benutzer
Um ein Mitglied zu entfernen, klicken Sie neben dem Eintrag auf das Papierkorb-Symbol und bestätigen mit Entfernen. Enthält die Gruppe keine Mitglieder, erscheint der Hinweis Keine Mitglieder in dieser Gruppe.
Entfernen Sie ein Mitglied, das über eine Auto-Zuweisungsregel in die Gruppe kam, nimmt BasePeak.AI es bei späteren Anmeldungen nicht wieder automatisch auf. Fügen Sie es von Hand wieder hinzu, gilt diese Sperre nicht mehr.
Die Gruppen eines einzelnen Benutzers können Sie auch auf dessen Detailseite über Gruppen verwalten ändern (siehe Benutzer).
Rollen zuweisen und entfernen
Alle Mitglieder einer Gruppe erhalten die Rollen der Gruppe, auch Mitglieder, die über eine Auto-Zuweisungsregel aufgenommen wurden. Eine Gruppe kann mehrere Rollen haben; ihre Mitglieder erhalten dann alle Berechtigungen dieser Rollen zusammen. Welche Rollen es gibt und was sie erlauben, beschreibt Benutzer.
So weisen Sie der Gruppe eine Rolle zu:
- Klicken Sie in der Karte Zugewiesene Rollen auf Rolle zuweisen
- Wählen Sie im Dialog die gewünschte Rolle aus; eine kurze Beschreibung erläutert die jeweilige Rolle
Die Rolle wird sofort zugewiesen. Sie können nur Rollen zuweisen und entfernen, deren Berechtigungen Sie selbst besitzen. Andere Rollen sind im Dialog und in der Karte deaktiviert.
Um eine Rolle zu entfernen, klicken Sie neben der Rolle auf das Papierkorb-Symbol. Hat die Gruppe keine Rollen, erscheint der Hinweis Keine Rollen zugewiesen.
Welche Benutzer eine Rolle über welche Gruppe erhalten, zeigt die Detailansicht der Rolle unter Rollen (/admin/roles).
Gruppe bearbeiten
Über Bearbeiten öffnen Sie den Dialog Gruppe bearbeiten. Dort ändern Sie Anzeigename und Beschreibung. Bestätigen Sie mit Speichern. Der Name einer Gruppe lässt sich hier nicht ändern.
Gruppe löschen
Über Löschen entfernen Sie die Gruppe nach einer Sicherheitsabfrage. Die Benutzerkonten der Mitglieder bleiben erhalten; die Mitglieder verlieren aber die Rollen der Gruppe und die Freigaben, die über die Gruppe liefen.
BasePeak.AI lehnt das Löschen ab, wenn die Gruppe der einzige Besitzer eines beschränkten Agenten ist. Tragen Sie dort zuerst einen weiteren Besitzer ein (siehe Agenten).
Auto-Zuweisungsregeln
Mit Auto-Zuweisungsregeln kommen Benutzer beim Anmelden automatisch in die Gruppe, sobald ein Wert aus ihrem Identitätsanbieter zu einer Regel passt. So steuern Sie die Gruppenmitgliedschaft und damit die Rollen zentral über den Auth-Anbieter, statt jeden Benutzer von Hand hinzuzufügen.
Jede Regel besteht aus einer Liste von Werten (z. B. Gruppenangaben aus dem Identitätsanbieter) und einer Angabe, für welchen Auth-Anbieter sie gilt. Liefert der Identitätsanbieter eines Benutzers einen der hinterlegten Werte, wird der Benutzer Mitglied der Gruppe. Groß- und Kleinschreibung spielen beim Vergleich keine Rolle. Passt später kein Wert mehr, entfernt BasePeak.AI die automatische Mitgliedschaft wieder.
So fügen Sie eine Regel hinzu:
- Klicken Sie in der Karte Auto-Zuweisungsregeln auf Regel hinzufügen
- Wählen Sie unter Auth-Anbieter entweder Alle Anbieter oder eine bestimmte konfigurierte Anbieter-Instanz
- Klicken Sie unter Bei Anmeldungen gesehen auf die Gruppenwerte, die Benutzer dieses Anbieters bisher bei der Anmeldung mitgebracht haben (mit der Anzahl der Benutzer). Weitere Werte geben Sie unter Werte (kommagetrennt) ein, getrennt durch Kommas (z. B.
Wert1, Wert2, ...) - Klicken Sie auf Erstellen
Jede Regel wird mit ihren Werten und dem zugehörigen Auth-Anbieter angezeigt. Mit Alle Anbieter greift die Regel unabhängig davon, über welche Anbieter-Instanz sich ein Benutzer anmeldet; mit einer bestimmten Instanz greift sie nur für Anmeldungen über diese Instanz. Um eine Regel zu löschen, klicken Sie auf das Papierkorb-Symbol und bestätigen mit Löschen. Sind keine Regeln vorhanden, erscheint der Hinweis Keine Auto-Zuweisungsregeln.
Auto-Zuweisungsregeln werden bei jeder Aktion eines angemeldeten Benutzers gegen die Gruppen aus seiner Sitzung ausgewertet. Neue oder geänderte Regeln wirken nach spätestens etwa einer Minute. Änderungen an den Gruppen im Identitätsanbieter wirken, sobald die Sitzung ihr Token erneuert, spätestens bei der nächsten Anmeldung.
Hinweise
- Welche Werte ein Benutzer mitbringt, hängt davon ab, welche Angaben sein Identitätsanbieter beim Anmelden übermittelt. Microsoft Entra ID sendet Gruppen-Objekt-IDs, solange die App-Registrierung nicht auf Namen umgestellt ist. Die Anbieter-Instanzen konfigurieren Sie unter Auth-Anbieter.
- Wie Sie Gruppen aus Microsoft Entra ID übernehmen, beschreibt Gruppen aus Microsoft Entra ID.
- Erhält der letzte Administrator diese Rolle über eine Gruppe, lehnt BasePeak.AI ab, ihn aus der Gruppe zu entfernen, der Gruppe die Rolle Administrator zu entziehen oder die Gruppe zu löschen.
- Einzelne Benutzer, ihre direkt zugewiesenen Rollen und eigene Rollen verwalten Sie unter Benutzer.