Benutzer
Die Benutzer-Seite (/admin/users) ermöglicht es Ihnen, die in BasePeak.AI registrierten Benutzer einzusehen und zu verwalten. Zugriff haben Benutzer mit der Rolle Administrator oder Benutzerverwaltung sowie Benutzer mit einer eigenen Rolle, die die Berechtigung user:manage enthält.
Die Seiten Benutzer und Gruppen erscheinen nur, wenn ein Authentifizierungsanbieter konfiguriert ist. Weitere Informationen finden Sie unter Authentifizierungsanbieter.
Benutzerliste
Die Übersicht zeigt alle registrierten Benutzer in einer Tabelle mit folgenden Spalten:
| Spalte | Beschreibung |
|---|---|
| Die E-Mail-Adresse des Benutzers | |
| Rollen | Alle Rollen des Benutzers, direkt zugewiesene und über Gruppen erhaltene (filterbar) |
| Threads | Anzahl der Threads des Benutzers |
| Erstellt | Datum der Registrierung |
| Letzte Aktivität | Datum der letzten Aktivität |
Alle Spalten lassen sich durch Klick auf die Spaltenüberschrift sortieren. Standardmäßig stehen die zuletzt registrierten Benutzer oben. Über das Suchfeld filtern Sie die Liste nach E-Mail-Adresse, Benutzername, Anzeigename oder Rolle. Über den Filter der Spalte Rollen zeigen Sie nur Benutzer mit bestimmten Rollen an.
Oben rechts zeigt eine Anzeige die Anzahl der registrierten Benutzer an (sofern ein Limit gesetzt ist, im Format „aktuell / maximal"). Support-Konten zählen dabei nicht mit.
Um die Detailansicht zu öffnen, klicken Sie auf eine Zeile. Über das Aktionsmenü (⋮) am Zeilenende können Sie einen Benutzer löschen; dabei ist eine Bestätigung erforderlich.
Zugriffsprüfung exportieren
Mit Zugriffsprüfung exportieren (CSV) laden Sie eine CSV-Datei mit allen Benutzern herunter. Sie enthält je Benutzer eine Zeile mit Benutzer-ID, E-Mail-Adresse, Benutzername, direkt zugewiesenen Rollen, Gruppen und effektiven Berechtigungen. Rollen und Gruppen stehen dort mit ihren internen Namen (z. B. user-manager), mehrere Einträge durch ; getrennt. Die Datei eignet sich für die regelmäßige Überprüfung und Rezertifizierung von Zugriffsrechten.
Rollen
Eine Rolle ist eine benannte Sammlung von Berechtigungen. Sie legt fest, was ein Benutzer auf der Plattform tun darf. Ein Benutzer kann mehrere Rollen haben; er erhält dann alle Berechtigungen dieser Rollen zusammen.
Integrierte Rollen
BasePeak.AI bringt folgende Rollen mit. Sie können nicht geändert oder gelöscht werden.
| Rolle | Beschreibung |
|---|---|
| Administrator | Voller Systemzugriff einschließlich aller Verwaltungsfunktionen. |
| Creator | Kann Agenten erstellen und die eigenen oder freigegebenen bearbeiten, Provider verwalten und eigene Agenten-Teams bauen. |
| Creator+ | Alles, was ein Creator kann, und zusätzlich jeden Agenten bearbeiten, der nicht administrativ eingeschränkt ist. |
| Basis | Standardbenutzer; nutzt Agenten und eigene Ressourcen. |
| Prüfer | Nur-Lese-Überwachung: alle Threads sowie Zugriffsprüfung von Benutzern, Rollen und Berechtigungen. |
| Benutzerverwaltung | Benutzer, Gruppen und Rollen verwalten, ohne Systemadministration. |
Creator bearbeiten nur Agenten, die ihnen gehören oder für die sie freigegeben wurden. Wer jeden nicht eingeschränkten Agenten bearbeiten muss, erhält die Rolle Creator+.
Benutzerdefinierte Rollen
Unter Rollen (/admin/roles) sehen Sie alle Rollen mit Name, Anzeigename, Typ (Integriert oder Benutzerdefiniert), Anzahl der Mitglieder und Anzahl der Berechtigungen (bei Rollen mit instance:admin steht dort Alle). Über Rolle erstellen legen Sie eine eigene Rolle an: Pflichtfeld ist Name; Anzeigename und Beschreibung sind optional. Unter Berechtigungen wählen Sie aus, was die Rolle erlaubt. An einer eigenen Rolle können Sie später Anzeigename, Beschreibung und Berechtigungen ändern, der Name bleibt. Bearbeiten oder löschen dürfen Sie eine Rolle nur, wenn Sie alle ihre Berechtigungen selbst besitzen. Eine Rolle, die dem letzten Administrator seine Rechte gibt, lässt sich nicht löschen.
Die Detailansicht einer Rolle zeigt unter Mitglieder alle Benutzer, die die Rolle haben, und woher: Direkt oder über eine Gruppe (z. B. über Amt 10). Darunter stehen die Gruppen mit dieser Rolle und die Berechtigungen der Rolle.
Sie können nur Berechtigungen vergeben, die Sie selbst besitzen. Das gilt auch beim Zuweisen und Entfernen von Rollen.
Wie ein Benutzer eine Rolle erhält
- Direkt: auf der Detailseite des Benutzers über Rolle zuweisen (siehe unten).
- Über eine Gruppe: Hat eine Gruppe eine Rolle, erhalten alle Mitglieder der Gruppe diese Rolle. Rollen einer Gruppe weisen Sie in der Detailansicht der Gruppe unter Zugewiesene Rollen zu (siehe Gruppen).
- Neue Benutzer erhalten bei der Registrierung keine Rolle. Sie haben damit dieselben Rechte wie mit der Rolle Basis: Sie nutzen Agenten und ihre eigenen Ressourcen. Ausnahmen: Systemadministratoren (siehe Hinweise) erhalten bei der ersten Anmeldung die Rolle Administrator, und wer über eine Zuweisungsregel einer Gruppe mit Rollen beitritt, erhält deren Rollen.
Benutzerdetails
Die Detailseite eines Benutzers gliedert sich in folgende Karten:
- Benutzerinfo — zeigt E-Mail, Erstellt und Letzte Aktivität. Ist für den Benutzer noch die frühere Einzelberechtigung Prüfer gesetzt, wird sie hier als zusätzliches Kennzeichen angezeigt. Neu vergeben Sie diese Rechte über die Rolle Prüfer.
- Zugewiesene Rollen — listet die Rollen, die dem Benutzer direkt zugewiesen sind. Rollen, die er über eine Gruppe erhält, stehen hier nicht; sie erscheinen in der Spalte Rollen der Benutzerliste und in der Detailansicht der Rolle.
- Effektive Berechtigungen — zeigt alle Berechtigungen, die der Benutzer aus seinen direkt zugewiesenen Rollen und den Rollen seiner Gruppen zusammen besitzt, z. B.
agent:create. - Gruppen — listet die Gruppen auf, denen der Benutzer angehört. Jede Gruppe ist mit ihrer Detailseite verknüpft (siehe Gruppen). Unter Erweiterte Details lassen sich zusätzlich die OAuth-Claim-Gruppen des Benutzers einsehen.
- Token-Nutzung — zeigt die verbrauchten Prompt-Token, Completion-Token und Gesamt-Token für diesen Benutzer.
Die Karten Gruppen und Token-Nutzung sowie die Schaltflächen Gruppen verwalten und Löschen sehen nur Administratoren, also Benutzer mit der Rolle Administrator (direkt oder über eine Gruppe) oder einer anderen Rolle mit der Berechtigung instance:admin.
Rollen zuweisen und entfernen
So weisen Sie einem Benutzer eine Rolle zu:
- Klicken Sie auf der Detailseite in der Karte Zugewiesene Rollen auf Rolle zuweisen
- Wählen Sie im Dialog die gewünschte Rolle aus; hat die Rolle eine Beschreibung, wird sie angezeigt
Die Rolle wird sofort zugewiesen. Rollen mit Berechtigungen, die Sie selbst nicht besitzen, sind im Dialog deaktiviert.
Um eine Rolle zu entfernen, klicken Sie neben der Rolle auf das Papierkorb-Symbol. Eine Rolle, die der Benutzer über eine Gruppe erhält, entfernen Sie in der Gruppe oder indem Sie den Benutzer aus der Gruppe nehmen.
Gruppen verwalten
So passen Sie die Gruppenmitgliedschaft eines Benutzers an:
- Klicken Sie auf der Detailseite auf Gruppen verwalten
- Aktivieren oder deaktivieren Sie die Kontrollkästchen der Gruppen, um den Benutzer hinzuzufügen oder zu entfernen
- Schließen Sie den Dialog; die Mitgliedschaft wird sofort aktualisiert
Die Verwaltung der Gruppen selbst ist unter Gruppen beschrieben.
Hinweise
- Benutzer, die explizit auf Systemebene als Administrator festgelegt sind, sind auf ihrer Detailseite durch ein Schild-Symbol gekennzeichnet. Sie lassen sich in der Oberfläche nicht löschen, und sie erhalten die Rolle Administrator bei jeder Anmeldung erneut, auch wenn sie ihnen entzogen wurde.
- Einen Administrator kann nur ein Administrator löschen. Mit der Rolle Benutzerverwaltung allein ist das nicht möglich.
- Support-Konten sind mit einem Kennzeichen markiert, standardmäßig Support.
- BasePeak.AI behält immer mindestens einen Administrator. Den letzten Administrator können Sie nicht löschen, und Sie können ihm die Rolle Administrator nicht entziehen.
- Das Löschen eines Benutzers kann nicht rückgängig gemacht werden.