Mit Dienstkonten kannst du Codex-Workflows ohne Benutzeroberfläche in deiner gesamten Organisation ausführen und skalieren, ohne auf das Konto einer beschäftigten Person angewiesen zu sein. Jeder Runner für Continuous Integration (CI), jeder geplante Job und jede gemeinsam genutzte Integration erhält eine eigene Identität im ChatGPT-Workspace. Dafür gelten dieselben Gruppen, Rollen und Zugriffskontrollen wie für persönliche Konten. Auch Aktivitäten lassen sich auf dieselbe Weise nachvollziehen.
Nur Personen mit Eigentümer- oder Adminrechten im Workspace können Dienstkonten erstellen. Sie können anderen Personen oder Gruppen erlauben, ein Konto zu verwalten, Plugins zu konfigurieren oder Zugriffstoken zu erstellen.
Ein Dienstkonto steht für eine technische Identität im Workspace. Ein persönliches Zugriffstoken steht für das Workspace-Mitglied, das es erstellt. Für Projektdienstkonten und API-Schlüssel der API-Plattform werden Zugriff und Abrechnung separat auf Projektebene geregelt.
Dienstkonto erstellen und einrichten
Diese interaktive Anleitung zeigt dir am Beispiel von GitHub, wie du ein Konto erstellst, ein Plugin konfigurierst, ein Token erstellst und Gruppen und Rollen zuweist.
Interactive walkthrough
Select the plus button, name your service account, and select Create.
Service accounts
Create workspace-owned accounts for automated workflows that need their own access.
| Name | Status | Created by | Date added | Actions |
|---|---|---|---|---|
| Active | Alex Kim alex@example.com | Jul 23, 2026 | ||
| Active | Jordan Lee jordan@example.com | Jul 18, 2026 | ||
| Active | Sam Patel sam@example.com | Jul 8, 2026 |
- Öffne in den Einstellungen deines Workspace den Bereich Dienstkonten.
- Wähle die Schaltfläche mit dem Pluszeichen (+) und gib einen aussagekräftigen Namen ein, etwa
release-automation. - Wähle Erstellen.
Plugin verbinden
Konfiguriere Plugins direkt für das Dienstkonto. Es übernimmt weder die Plugins noch die verbundenen Apps der Person, die es erstellt hat.
- Öffne im Konto den Bereich Plugins und wähle Plugin hinzufügen.
- Wähle ein Plugin und prüfe, ob es als konfiguriert oder aktiviert angezeigt wird.
Mit der Rolle Konfigurieren oder Verwalten kannst du Plugins einrichten. Mit der Rolle Nutzen ist das nicht möglich.
Zugriffstoken erstellen
Erstelle das Token auf der Detailseite des Dienstkontos. Es steht für das Dienstkonto und nicht für die Person, die es erstellt.
- Öffne das Konto und wähle Token erstellen im Bereich Zugriffstoken.
- Gib dem Token einen Namen, bestätige den Geltungsbereich Codex und lege fest, wann das Token abläuft.
- Wähle Erstellen und speichere das Token in deinem Secret-Manager.
Das vollständige Token wird nur einmal angezeigt. Welche Laufzeiten du wählen kannst, hängt von den Richtlinien deines Workspace ab.
Rollen und Gruppen zuweisen
Wie jedem anderen Workspace-Mitglied kannst du einem Dienstkonto Workspace-Rollen zuweisen und es zu Gruppen hinzufügen. Weise dem Konto die Zugriffsrechte direkt zu. Es übernimmt keine Berechtigungen von der Person, die es erstellt hat.
Damit andere Personen oder Gruppen das Konto verwalten können, wähle Teilen, dann Personen oder Gruppen hinzufügen und weise eine Rolle zu.
| Rolle für das freigegebene Konto | Konto und zugehörige Plugins konfigurieren | Zugriffstoken für das Dienstkonto erstellen |
|---|---|---|
| Nutzen | Nein | Ja |
| Konfigurieren | Ja | Nein |
| Verwalten | Ja | Ja |
Diese Rollen gelten für Personen, die das Konto verwalten. Sie sind unabhängig von den Workspace-Rollen und Gruppen, die dem Dienstkonto selbst zugewiesen sind.
Mit der Rolle Konfigurieren oder Verwalten kannst du das Konto aktivieren oder deaktivieren. Nur Personen mit Eigentümer- oder Adminrechten im Workspace können Konten erstellen, löschen oder freigeben. Wer ein freigegebenes Konto verwaltet, meldet sich dazu mit dem eigenen ChatGPT-Konto an.
Weitere Informationen zu den Berechtigungen im Workspace findest du im Artikel Rollen und Berechtigungen im Workspace.
Codex ohne Anmeldung ausführen
Für Zugriffstoken von Dienstkonten benötigst du die Codex CLI ab Version 0.142.0. Setze CODEX_ACCESS_TOKEN und führe Codex aus, ohne einen Browser zu öffnen.
export CODEX_ACCESS_TOKEN="<service-account-access-token>"
codex exec --json "Inspect this repository and summarize its current state."
Stelle das Token in CI über einen Secret-Manager oder als Secret des Runners bereit.
Um die Anmeldung auf einem vertrauenswürdigen Rechner zu speichern, übergib das Token über die Standardeingabe.
printf '%s' "$CODEX_ACCESS_TOKEN" | codex login --with-access-token
codex exec "Summarize the changes in the current branch."
Dadurch werden die Anmeldedaten lokal gespeichert. Verwende auf gemeinsam genutzten oder temporären Runnern CODEX_ACCESS_TOKEN, ohne die Anmeldung zu speichern.
Dienstkonten mit SCIM bereitstellen
Wenn dein Workspace die Bereitstellung von Dienstkonten über das Protokoll System for Cross-domain Identity Management (SCIM) unterstützt, setze bei deinem Identitätsanbieter userType auf ServiceAccount.
{
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
"userName": "svc-codex-release@company.example",
"displayName": "Codex release automation",
"active": true,
"userType": "ServiceAccount"
}
Weise die Identität dem Workspace und den erforderlichen Gruppen zu und synchronisiere sie anschließend. Der Identitätsanbieter verwaltet den Namen, die Gruppenmitgliedschaften und den Lebenszyklus des Kontos. Über SCIM verwaltete Konten kannst du in ChatGPT weder umbenennen noch löschen. Weitere Informationen findest du im Artikel Gruppen und Bereitstellung.
Dienstkonten mit der Admin API verwalten
Wenn dein Workspace Zugriff auf die ChatGPT Admin API hat, kannst du mit einem Schlüssel für diese API Konten, Token und Freigaben verwalten. Für Lesezugriffe benötigst du chatgpt.enterprise.service_account.read, für Änderungen chatgpt.enterprise.service_account.write. Mit dem Token eines Dienstkontos kannst du Anfragen an die Admin API nicht authentifizieren.
Die verfügbaren Operationen und aktuellen Anfragepfade findest du in der Referenz zur Admin API.
Konten
| Operation | Methode | Beschreibung |
|---|---|---|
| Konten auflisten | GET |
Gibt die Dienstkonten des Workspace zurück |
| Konto erstellen | POST |
Erstellt ein Dienstkonto mit dem angegebenen Namen |
| Konto abrufen | GET |
Gibt ein einzelnes Dienstkonto zurück |
| Konto aktivieren oder deaktivieren | PATCH |
Aktualisiert den Wert von enabled für das Konto |
| Konto löschen | DELETE |
Entfernt das Konto und widerruft seine Token |
Erstelle Konten mit POST /v1/manage/workspaces/{workspace_id}/service-accounts. Bei einer Kontoaktualisierung lässt sich nur enabled ändern.
Token
| Operation | Methode | Beschreibung |
|---|---|---|
| Token auflisten | GET |
Gibt die Metadaten der Token des Kontos zurück |
| Token erstellen | POST |
Erstellt ein Zugriffstoken mit festgelegtem Geltungsbereich |
| Token widerrufen | DELETE |
Widerruft ein einzelnes Token dauerhaft |
Mit den folgenden Angaben erstellst du beispielsweise ein Codex-Token, das nach 30 Tagen abläuft.
{
"name": "production-release-runner",
"ttl": 2592000,
"scopes": ["chatgpt.workspace.feature.allow-codex-local-access.access"]
}
ttl gibt die Gültigkeitsdauer des Tokens in Sekunden an. Eine begrenzte Laufzeit muss kürzer als ein Jahr sein und den Laufzeitvorgaben deines Workspace entsprechen. Den vollständigen Wert von access_token gibt die API nur beim Erstellen des Tokens zurück.
Über die Admin API kannst du auch Zugriffsrechte für freigegebene Konten auflisten, hinzufügen, aktualisieren und entfernen. Die Rollenwerte lauten manager, configurer und user. Die Rolle configurer wird in ChatGPT als Konfigurieren angezeigt.
Dienstkonten absichern und verwalten
- Weise dem Konto nur die Rollen, Gruppen, Plugins und Verbindungen zu, die der Workflow benötigt.
- Speichere Token in einem Secret-Manager und verwende vertrauenswürdige Runner.
- Halte Anmeldedaten aus Protokollen, Chatnachrichten und der Versionsverwaltung heraus.
- Begrenze die Laufzeit der Token und überprüfe regelmäßig die Zugriffsrechte und Aktivitäten des Kontos.
- Um ein Token zu rotieren, erstelle ein neues Token, aktualisiere den Workflow und prüfe, ob der Zugriff funktioniert. Widerrufe anschließend das alte Token im Workspace oder über die Admin API.
- Widerrufe offengelegte Token sofort und untersuche die jüngsten Aktivitäten des Kontos.
- Deaktiviere oder lösche ungenutzte Konten im Workspace oder über die Admin API. Beide Aktionen widerrufen alle aktiven Token. Deaktivierte Konten kannst du wieder aktivieren und mit neuen Token nutzen. Eine Löschung lässt sich nicht rückgängig machen.
Ausführungen werden dem Dienstkonto zugeordnet. Anhand der verfügbaren Workspace-Analysen und Auditprotokolle lässt sich außerdem nachvollziehen, wer Token erstellt oder Kontoeinstellungen geändert hat. Prüfe in der Referenz zur Admin API, welche Ereignisse erfasst werden.