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

Zusammenarbeiten und teilen

Zugriffstoken

Erstelle und verwalte Zugriffstoken für programmgesteuerte Codex-Workflows

Codex-Zugriffstoken sind Zugangsdaten für einen ChatGPT-Workspace. Ihr Geltungsbereich ist auf Codex-Berechtigungen beschränkt. Mit ihnen authentifizieren sich vertrauenswürdige, nicht interaktive lokale Workflows mit einer Identität aus dem ChatGPT-Workspace. Dazu gehören Workflows mit der Codex CLI und Automatisierungen über den App Server. Verwende Zugriffstoken, wenn ein Skript, ein geplanter Job oder ein CI-Runner wiederholt lokalen Zugriff benötigt.

Codex-Zugriffstoken werden derzeit in Workspaces von ChatGPT Business und ChatGPT Enterprise unterstützt.

Persönliche Zugriffstoken erstellst du in der ChatGPT-Administrationskonsole auf der Seite Zugriffstoken. Jedes Token ist der Person, die es erstellt hat, und ihrem ChatGPT-Workspace zugeordnet. In programmgesteuerten lokalen Workflows dienen Token als Agentenidentitäten. Wie du Token auf der Detailseite einer eigens für Dienste angelegten Workspace-Identität erstellst, erfährst du im Artikel Dienstkonten.

Wenn ein API-Schlüssel der OpenAI-Plattform für deine Automatisierung ausreicht, verwende ihn weiterhin zur Authentifizierung. Verwende Codex-Zugriffstoken, wenn ein vertrauenswürdiger lokaler Workflow Zugriff auf den ChatGPT-Workspace, dort verwaltete Nutzungsrechte oder Kontrollfunktionen für Unternehmen benötigt.

Möchtest du einen in deinem ChatGPT-Workspace veröffentlichten Agenten aus deinem eigenen System heraus starten? Dafür benötigt dein Workflow Zugriff auf Workspace-Agenten. Mit einem reinen Codex-Token kannst du Aufrufe zum Starten von Workspace-Agenten nicht authentifizieren. Wenn der Token-Dialog die Auswahl Geltungsbereiche anbietet, wähle Workspace-Agenten zum Starten eines Agenten und Codex für die Codex-Automatisierung. Gib mehrere Geltungsbereiche nur dann frei, wenn der Workflow jeden einzelnen benötigt. Weitere Informationen findest du im Artikel Authentifizierung mit Zugriffstoken für Workspace-Agenten.

So funktionieren Zugriffstoken

Verwende ein Zugriffstoken, wenn die Codex CLI oder ein Client für den App Server ohne manuelle Anmeldung im Browser laufen soll. Das Token steht für das Mitglied des ChatGPT-Workspace, das es erstellt hat. Dadurch können Läufe die Zugriffsrechte dieses Mitglieds nutzen und in den Governance-Daten des Workspace erscheinen.

Der Client prüft das Token zu Beginn eines Laufs und ordnet den Lauf der zugehörigen Workspace-Identität zu. Schütze das Token wie andere Secrets für die Automatisierung. Speichere es in einem Secret Manager, achte darauf, dass es nicht in Logs erscheint, und rotiere es gemäß den Richtlinien deiner Organisation.

Verwende Zugriffstoken für folgende Aufgaben:

  • codex exec-Jobs, die eine vertrauenswürdige Automatisierung startet.
  • Lokale Skripte, die wiederholt nicht interaktive Läufe mit der Codex CLI ausführen müssen.
  • Vertrauenswürdige Automatisierungen über den App Server.
  • Unternehmensworkflows, bei denen die Nutzung einem Mitglied des ChatGPT-Workspace statt einem API-Schlüssel der Organisation zugeordnet wird.

Achte besonders auf folgende Risiken:

  • Offengelegte Zugangsdaten: Wer das Token besitzt, kann über die Codex CLI oder einen Client für den App Server lokale Läufe unter der Identität der Person starten, die das Token erstellt hat. Speichere Token in einem Secret Manager, achte darauf, dass sie nicht in Logs erscheinen, und rotiere sie gemäß den Richtlinien deiner Organisation.
  • Nicht vertrauenswürdige Runner: In öffentlichen CI-Umgebungen, bei Pull Requests aus Forks oder auf gemeinsam genutzten Rechnern können Token für Personen außerhalb deines Workspace zugänglich werden. Verwende Zugriffstoken nur auf vertrauenswürdigen Runnern.
  • Gemeinsam genutzte Identitäten: Wenn voneinander unabhängige Teams dasselbe persönliche Token verwenden, lässt sich schwerer nachvollziehen, wer verantwortlich ist und wer welche Aktionen ausgeführt hat. Erstelle Token für die jeweils für den Workflow verantwortliche Person.
  • Veraltete Zugangsdaten: Token mit langer Laufzeit können nach einer Änderung des Workflows aktiv bleiben. Bevorzuge zeitlich begrenzte Token und widerrufe Token, die nicht mehr verwendet werden.
  • Falscher Geltungsbereich oder falsche Zugangsdaten: Codex-Automatisierungen benötigen Zugriff auf Codex. Zum Starten von Workspace-Agenten ist Zugriff auf Workspace-Agenten erforderlich. Für allgemeine Aufrufe der OpenAI-API brauchst du API-Schlüssel der Plattform. Wenn die Auswahl Geltungsbereiche angezeigt wird, erteile nur die Berechtigungen, die der Workflow benötigt.

Erstellung von Zugriffstoken aktivieren

Über die Berechtigung für Zugriffstoken in den Workspace-Einstellungen legst du fest, welche Mitglieder Zugriffstoken erstellen dürfen.

Diese Berechtigung regelt die Erstellung von Token. Sie gewährt keinen Zugriff auf die ChatGPT-Desktop-App, die Codex CLI oder die IDE-Erweiterung. Auch der Lizenztyp, die integrierte Workspace-Rolle und das Berechtigungsprofil für die lokale Laufzeitumgebung des Mitglieds bleiben unverändert. Für Workflows mit der Codex CLI oder dem App Server, die sich per Token authentifizieren, benötigt das Mitglied zusätzlich die Berechtigung zur lokalen Nutzung von Codex.

Wie diese Berechtigungen zusammenhängen, erfährst du im Artikel Rollen und Workspace-Berechtigungen.

  1. Bitte eine Person mit der Inhaberrolle im Workspace, Workspace-Einstellungen > Berechtigungen und Rollen zu öffnen.
  2. Wenn der Abschnitt Zugriffstoken angezeigt wird, aktiviere Nutzenden erlauben, persönliche Zugriffstoken zu erstellen. Falls der Abschnitt fehlt, aktiviere Mitgliedern erlauben, Codex-Zugriffstoken zu verwenden unter Codex und Work lokal oder Codex lokal.
  3. Aktiviere für die Person, die den Workflow verantwortet, die passende Berechtigung zur lokalen Nutzung von Codex: Mitgliedern erlauben, Codex und Work lokal zu verwenden unter Codex und Work lokal oder Mitgliedern erlauben, Codex lokal zu verwenden unter Codex lokal. Wenn Work lokal einen eigenen Abschnitt hat, regelt Work lokal verwenden den Zugriff auf Work. Für Codex-Token ist diese Berechtigung nicht erforderlich.

Erlaube die Erstellung von Zugriffstoken nur Personen oder Dienstverantwortlichen, die wissen, wo das Token gespeichert wird, für welche Automatisierung es vorgesehen ist und wann es rotiert werden muss.

Wenn du die Berechtigung zur lokalen Nutzung von Codex deaktivierst, werden aktive Codex-Token der betroffenen Mitglieder vorübergehend gesperrt. Die Token werden dabei nicht widerrufen. Sobald du den lokalen Codex-Zugriff wiederherstellst, sind die Token wieder aktiv. Widerrufe die Token, wenn der Zugriff dauerhaft enden soll.

Maximale Gültigkeitsdauer für Zugriffstoken festlegen

Wer die Inhaberrolle im Workspace hat, kann festlegen, welche Gültigkeitsdauer Mitglieder für neue Zugriffstoken höchstens wählen dürfen. Öffne Workspace-Einstellungen > Berechtigungen und Rollen. Wenn der Abschnitt Zugriffstoken angezeigt wird, lege dort die Maximale Gültigkeitsdauer für Zugriffstoken fest. Andernfalls findest du die Einstellung unter Codex und Work lokal oder Codex lokal.

Die Begrenzung gilt für neue Zugriffstoken. Bereits erstellte Token behalten ihre bisherige Gültigkeitsdauer.

Zugriffstoken erstellen

Auf der Seite „Zugriffstoken“ kannst du dem Token einen Namen geben, die verfügbaren Geltungsbereiche für einzelne Produkte prüfen und eine passende Gültigkeitsdauer wählen.

  1. Öffne die Seite Zugriffstoken.
  2. Wähle Erstellen.
  1. Gib einen aussagekräftigen Namen ein, etwa release-ci oder nightly-docs-check.
  1. Wenn der Dialog Geltungsbereiche anzeigt, wähle Codex. Wähle Workspace-Agenten nur dann, wenn derselbe Workflow auch einen Workspace-Agenten starten muss. Bietet der Dialog keine Auswahl für den Geltungsbereich an, erstellt er ein Token ausschließlich für Codex.
  2. Wähle eine begrenzte Gültigkeitsdauer, etwa 7, 30, 60 oder 90 Tage. Persönliche Zugriffstoken mit festgelegten Geltungsbereichen müssen ein Ablaufdatum haben. Eine ältere Version des Dialogs für reine Codex-Token bietet möglicherweise Kein Ablaufdatum an. Verwende diese Option nur, wenn deine Organisation sie genehmigt und das Token nach einem festgelegten Zeitplan rotiert.
  3. Wähle Erstellen.
  4. Kopiere das generierte Zugriffstoken sofort. Sobald du den Dialog schließt, kannst du es nicht mehr anzeigen.
  5. Speichere das Token in deinem Secret Manager oder im Secret-Speicher deiner CI-Umgebung.

Die kürzeste frei wählbare Gültigkeitsdauer beträgt einen Tag. Mit widerrufenen oder abgelaufenen Token kannst du keine neuen authentifizierten Läufe starten.

Zugriffstoken mit der Codex CLI verwenden

Wenn der Dialog zum Erstellen des Tokens eine erforderliche Version der Codex CLI angibt, aktualisiere die CLI auf diese oder eine neuere Version, bevor du das Token verwendest.

Für Automatisierungen in kurzlebigen Umgebungen speicherst du das Token in CODEX_ACCESS_TOKEN und führst die Codex CLI wie gewohnt aus:

export CODEX_ACCESS_TOKEN="<access-token>"
codex exec --json "review this repository and summarize the top risks"

Für eine dauerhafte lokale Anmeldung übergibst du das Token per Pipe an codex login --with-access-token:

printf '%s' "$CODEX_ACCESS_TOKEN" | codex login --with-access-token
codex exec "summarize the last release diff"

codex login --with-access-token speichert die Zugangsdaten einer Agentenidentität im Anmeldedatenspeicher der Codex CLI. Wenn du die Zugangsdaten nicht dauerhaft auf dem Rechner speichern möchtest, verwende die Umgebungsvariable CODEX_ACCESS_TOKEN.

codex app-server kann dieselben Zugangsdaten über CODEX_ACCESS_TOKEN oder eine mit codex login --with-access-token erstellte Anmeldung verwenden, um seine Anfragen an OpenAI zu authentifizieren. Die Authentifizierung der Transportverbindung zwischen Client und App Server verwendet separate Zugangsdaten. Konfiguriere für eine WebSocket-Verbindung zu einem entfernten Server ein separates Bearer- oder Capability-Token, wie im Artikel App Server beschrieben. Verwende das Codex-Zugriffstoken nicht als Transport-Token. Weitere Informationen findest du im Artikel Umgebungsvariablen für Authentifizierung und Netzwerk.

Token rotieren oder widerrufen

Rotiere Zugriffstoken wie andere Secrets für die Automatisierung:

  1. Erstelle ein Ersatz-Token.
  2. Aktualisiere das Secret im Runner, im Scheduler oder im Secret Manager.
  3. Führe mit dem neuen Token einen Smoke-Test durch.
  4. Widerrufe das alte Token auf der Seite Zugriffstoken.

Auf der Seite „Zugriffstoken“ können Personen mit Inhaber- oder Adminrolle jedes Token im Workspace widerrufen. Mitglieder mit der Berechtigung für Zugriffstoken können nur selbst erstellte Token widerrufen.

Berechtigungsmodell

Die Workspace-Berechtigung für Zugriffstoken regelt, wer Token erstellen darf. Je nach Aufbau der Workspace-Einstellungen regelt Mitgliedern erlauben, Codex und Work lokal zu verwenden unter Codex und Work lokal oder Mitgliedern erlauben, Codex lokal zu verwenden unter Codex lokal den lokalen Zugriff auf Codex. Wenn Work lokal einen eigenen Abschnitt hat, regelt Work lokal verwenden den Zugriff auf Work und gewährt keinen Zugriff auf Codex. Für Codex-Workflows mit Token-Authentifizierung benötigt ein Mitglied sowohl lokalen Codex-Zugriff als auch die Berechtigung für Zugriffstoken. Ein Mitglied kann Codex lokal verwenden, ohne Zugriffstoken erstellen zu dürfen.

Aktion Personen mit Inhaber- oder Adminrolle im Workspace Mitglied mit Berechtigung für Zugriffstoken Mitglied ohne Berechtigung für Zugriffstoken
Seite Zugriffstoken öffnen Ja Ja Nein
Zugriffstoken erstellen Ja, für die eigene Identität im ChatGPT-Workspace Ja, für die eigene Identität im ChatGPT-Workspace Nein
Zugriffstoken auflisten Alle Token im Workspace mit Angabe der Person, die das jeweilige Token erstellt hat Nur selbst erstellte Token Nein
Zugriffstoken auf der Seite „Zugriffstoken“ widerrufen Jedes Token im Workspace Nur selbst erstellte Token Kein Zugriff auf die Seite
Berechtigung für Zugriffstoken erteilen oder entziehen Nur mit Inhaberrolle im Workspace Nein Nein
Andere Einstellungen für lokale Clients oder Codex Cloud verwalten Ja, je nach Adminberechtigungen im Workspace Nur wenn eine Person mit Inhaberrolle Zugriff gewährt Nein

Personen mit Inhaber- oder Adminrolle verwalten den Zugriff für den gesamten Workspace. Mitglieder benötigen die Berechtigung für Zugriffstoken, um eigene Token zu erstellen und zu verwalten. Diese Berechtigung gewährt weder Adminrechte noch Zugriff auf Token anderer Mitglieder.

Fehlerbehebung

Die Seite „Zugriffstoken“ meldet 404 oder verweigert den Zugriff

Bitte eine Person mit Inhaberrolle im Workspace, zu prüfen, ob deine Rolle je nach Oberfläche die Berechtigung Nutzenden erlauben, persönliche Zugriffstoken zu erstellen oder Mitgliedern erlauben, Codex-Zugriffstoken zu verwenden umfasst. Prüfe für einen Codex-Workflow mit Token-Authentifizierung außerdem, ob Mitgliedern erlauben, Codex und Work lokal zu verwenden oder Mitgliedern erlauben, Codex lokal zu verwenden aktiviert ist.

codex login --with-access-token schlägt fehl

Vergewissere dich, dass du das generierte Zugriffstoken kopiert hast. Ein Browser-Sitzungstoken oder ein API-Schlüssel der Plattform eignet sich für diese Anmeldung nicht. Prüfe außerdem, ob das Token aktiv und noch gültig ist und einem Mitglied mit der erforderlichen Berechtigung zur lokalen Nutzung von Codex gehört.

Weiterführende Dokumentation