Mit der rollenbasierten Zugriffskontrolle (RBAC) legst du fest, wer in deiner Organisation und deinen Projekten welche Aktionen ausführen darf. Für die API und das Dashboard gelten dieselben Berechtigungen. Wer einen Endpunkt aufrufen darf (zum Beispiel /v1/chat/completions), kann auch die entsprechende Seite im Dashboard nutzen. Fehlt eine Berechtigung, sind die zugehörigen Bedienelemente deaktiviert, etwa die Schaltfläche Upload im Playground. Mit RBAC kannst du:
- Personen in Gruppen zusammenfassen und vielen Personen gleichzeitig Berechtigungen zuweisen
- Eigene Rollen mit genau den Berechtigungen erstellen, die du brauchst
- Den Zugriff auf Organisations- oder Projektebene festlegen
- Einheitliche Berechtigungen im Dashboard und in der API durchsetzen
Grundbegriffe
- Organisation: Dein übergeordnetes Konto. Organisationsrollen können Zugriff auf alle Projekte gewähren.
- Projekt: Ein Workspace für Schlüssel, Dateien und Ressourcen. Projektrollen gewähren Zugriff ausschließlich innerhalb des jeweiligen Projekts.
- Gruppen: In einer Gruppe fasst du Personen zusammen und kannst ihnen gemeinsam Rollen zuweisen. Du kannst Gruppen aus deinem Identitätsanbieter über SCIM synchronisieren. So bleiben die Mitgliedschaften automatisch aktuell.
- Rollen: Eine Rolle bündelt Berechtigungen, etwa für Anfragen an Modelle oder das Schreiben von Dateien. Rollen für die Organisation erstellst du unter Organization settings, Rollen für ein bestimmtes Projekt in dessen Einstellungen. Anschließend kannst du die Organisations- oder Projektrollen einzelnen Personen oder Gruppen zuweisen. Wer mehrere Rollen hat, erhält die Berechtigungen aus allen diesen Rollen.
- Berechtigungen: Die einzelnen Aktionen, die eine Rolle erlaubt, etwa Anfragen an Modelle senden, Dateien lesen oder schreiben und Schlüssel verwalten.
Berechtigungen
Die Tabelle zeigt, welche Berechtigungen verfügbar sind, welche vordefinierten Rollen sie enthalten und ob du sie für eigene Rollen konfigurieren kannst.
| Bereich | Erlaubte Aktionen | Organisationsrolle Owner | Organisationsrolle Reader | Projektrolle Owner | Projektrolle Member | Projektrolle Viewer | Für eigene Rollen verfügbar |
|---|---|---|---|---|---|---|---|
| Modelle auflisten | Modelle auflisten, auf die diese Organisation Zugriff hat | Read |
Read |
Read |
Read |
Read |
✓ |
| Gruppen | Gruppen anzeigen und verwalten | Read, Write |
Read |
Read, Write |
Read, Write |
Read |
|
| Rollen | Rollen anzeigen und verwalten | Read, Write |
Read |
Read, Write |
Read, Write |
Read |
|
| Organisationsverwaltung | Mitglieder, Projekte, Einladungen, Admin-API-Schlüssel und Ratenlimits der Organisation verwalten | Read, Write |
|||||
| Nutzung | Nutzungsdaten im Dashboard anzeigen und exportieren | Read |
✓ | ||||
| Externe Schlüssel | Schlüssel für Enterprise Key Management anzeigen und verwalten | Read, Write |
|||||
| IP-Freigabeliste | Liste der zugelassenen IP-Adressen anzeigen und verwalten | Read, Write |
|||||
| mTLS | Einstellungen für die gegenseitige TLS-Authentifizierung anzeigen und verwalten | Read, Write |
|||||
| OIDC | OIDC-Konfiguration anzeigen und verwalten | Read, Write |
|||||
| Modellfunktionen | Anfragen für Chat Completions, Audio, Embeddings und Bilder senden | Request |
Request |
Request |
Request |
✓ | |
| Assistants | Assistants erstellen und abrufen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Threads | Threads, Nachrichten und Runs erstellen und abrufen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Evals | Evals erstellen, abrufen und löschen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Fine-Tuning | Fine-Tuning-Jobs erstellen und abrufen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Dateien | Dateien erstellen und abrufen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Vektorspeicher | Vektorspeicher erstellen und abrufen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
✓ | |
| Responses API | Antworten erstellen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
✓ | |
| Prompts | Prompts erstellen und abrufen, die als Kontext für die Responses API und die Realtime API dienen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Webhooks | Webhooks in deinem Projekt erstellen und anzeigen | Read, Write |
Read |
Read, Write |
Read, Write |
Read |
✓ |
| Datensätze | Datensätze erstellen und abrufen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Apps | Apps im Dashboard erstellen, verwalten und zur Prüfung einreichen | Read, Write |
✓ | ||||
| Tunnel | Tunnel auf Organisationsebene prüfen, nutzen und verwalten | Read, Use, Manage |
✓ | ||||
| Projekt-API-Schlüssel | Eigene API-Schlüssel verwalten | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
✓ |
| Projektverwaltung | Projektmitglieder, Dienstkonten, API-Schlüssel und Ratenlimits über die Verwaltungs-API verwalten | Read, Write |
Read, Write |
||||
| Batch | Batch-Jobs erstellen und verwalten | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
|
| Dienstkonten | Dienstkonten des Projekts anzeigen und verwalten | Read, Write |
Read, Write |
||||
| Stimmen | Stimmen erstellen und abrufen | Read, Write |
Read, Write |
Read, Write |
Read, Write |
Read |
|
| Agent Builder | Agenten und Workflows in Agent Builder erstellen und verwalten | Read, Write |
Read |
Read, Write |
Read, Write |
Read |
✓ |
Welche zusätzlichen Rechte gewähren Batch-Berechtigungen?
Batch-Berechtigungen umfassen die Zugriffsrechte, die du brauchst, um Eingabedateien für einen Batch vorzubereiten, Anfragen auszuführen und Ergebnisse abzurufen. Welche Endpunkte du innerhalb eines Batches angeben kannst, ist unabhängig von diesen Zugriffsrechten. Die Liste findest du im Leitfaden zur Batch API.
| Batch-Berechtigung | Zusätzliche Zugriffsrechte |
|---|---|
Lesen (api.batch.read) |
Dateien lesen (api.files.read) über /v1/files |
Schreiben (api.batch.write) |
Batches lesen Modelle auflisten ( api.model.read und model.read) über /v1/modelsDateien lesen und schreiben ( api.files.read und api.files.write) über /v1/filesAnfragen an Modellfunktionen senden ( api.model.request und model.request) über /v1/audio, /v1/chat/completions, /v1/embeddings, /v1/images, /v1/moderations, /v1/realtime und /v1/responses |
RBAC einrichten
Es kann bis zu 30 Minuten dauern, bis Rollenänderungen und synchronisierte Gruppenmitgliedschaften überall wirksam sind.
-
Gruppen erstellen Lege Gruppen für Teams an, zum Beispiel Data Science und Support. Wenn du einen Identitätsanbieter (IdP) nutzt, aktiviere die SCIM-Synchronisierung, damit die Gruppenmitgliedschaften aktuell bleiben.
-
Eigene Rollen erstellen Vergib zunächst nur die Berechtigungen, die für die jeweilige Aufgabe nötig sind. Beispiele:
- Model Tester: Modelle auflisten, Anfragen an Modellfunktionen senden, Evals nutzen
- Model Engineer: Anfragen an Modellfunktionen senden, Dateien lesen und schreiben, Fine-Tuning nutzen
- App Publisher: Apps lesen und schreiben
-
Rollen zuweisen
- Rollen auf Organisationsebene gelten in allen Projekten der Organisation.
- Rollen auf Projektebene gelten nur im jeweiligen Projekt. Du kannst Rollen einzelnen Personen und Gruppen zuweisen. Wer mehrere Rollen hat, erhält die Berechtigungen aus allen zugewiesenen Rollen.
-
Zugriff prüfen Prüfe mit einem Konto ohne Owner-Rolle, ob der Zugriff über die API und im Dashboard wie erwartet funktioniert. Passe die Rollen an, wenn Personen mehr sehen können, als sie für ihre Aufgaben brauchen.
Halte dich an das Prinzip der geringsten Rechte. Vergib zunächst nur die Berechtigungen, die für eine Aufgabe erforderlich sind. Ergänze weitere nur bei Bedarf.
Beispiele für die Zugriffskonfiguration
Kleines Team
- Weise dem Kernteam eine Organisationsrolle zu, die Anfragen an Modellfunktionen sowie das Lesen und Schreiben von Dateien erlaubt.
- Erstelle für jede App ein Projekt. Nimm externe Fachkräfte nur in die Projekte auf, an denen sie mitarbeiten, und weise ihnen Rollen auf Projektebene zu.
Größere Organisation
- Synchronisiere Gruppen aus deinem IdP, zum Beispiel Forschung, Support und Finanzen.
- Erstelle für jeden Aufgabenbereich eigene Rollen und weise sie auf Organisationsebene zu. Wenn ein Projekt strengere Zugriffskontrollen erfordert, vergib dafür ausschließlich projektspezifische Rollen.
Externe Fachkräfte und Dienstleister
- Erstelle eine Gruppe „Externe Fachkräfte“ ohne Rollen auf Organisationsebene.
- Nimm die Gruppenmitglieder gezielt in einzelne Projekte auf und vergib eng begrenzte Projektrollen, zum Beispiel ohne Schreibzugriff.
Wie der Zugriff einer Person ermittelt wird
Im Dashboard berücksichtigen wir:
- Rollen aus der Organisation (direkt oder über Gruppen zugewiesen)
- Rollen aus dem Projekt (direkt oder über Gruppen zugewiesen)
Die wirksamen Berechtigungen ergeben sich aus der Vereinigung der Berechtigungen aller zugewiesenen Rollen.
Wenn du in einem Projekt eine Anfrage mit einem API-Schlüssel sendest, prüfen wir die dem Schlüssel zugewiesenen Berechtigungen. Außerdem prüfen wir, ob du eine Projektrolle hast, die dir diese Berechtigungen gewährt. Für eine Anfrage an /v1/models muss dem API-Schlüssel beispielsweise api.model.read zugewiesen sein. Du brauchst außerdem eine Projektrolle mit der Berechtigung api.model.read.
Bewährte Vorgehensweisen
- Teams als Gruppen abbilden: Bilde deine Teams im IdP ab und weise Rollen auf Gruppenebene zu statt einzeln pro Person.
- Aufgaben trennen: Vergib getrennte Zuständigkeiten für das Lesen von Modellinformationen, das Hochladen von Dateien und die Verwaltung von Schlüsseln.
- Projektgrenzen nutzen: Verwende separate Projekte für Experimente, Staging und den Produktivbetrieb.
- Regelmäßig überprüfen: Entferne ungenutzte Rollen und Schlüssel. Tausche sensible Schlüssel regelmäßig aus.
- Mit einem Konto ohne Owner-Rolle testen: Prüfe vor der breiten Einführung, ob der Zugriff deinen Erwartungen entspricht.