Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Berechtigungen auf der OpenAI-Plattform verwalten

Verwalte Berechtigungen in deiner Organisation und deinen Projekten mit der rollenbasierten Zugriffskontrolle (RBAC).

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/models
Dateien lesen und schreiben (api.files.read und api.files.write) über /v1/files
Anfragen 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.

  1. 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.

  2. 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
  3. 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.
  4. 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.