Codex-Konfiguration für Ihr Team selbst hosten
Stellen Sie Codex Standardwerte und erforderliche Einstellungen über einen von Ihnen betriebenen HTTPS-Endpunkt bereit.
Wenn sich Ihre Benutzer nicht mit ChatGPT bei Codex anmelden, können Sie die Konfiguration über einen von Ihnen betriebenen HTTPS-Server an Codex CLI und die Desktop-App verteilen. Codex lädt Ihre Einstellungen beim Start – unabhängig davon, ob sich Benutzer direkt oder über ein Gateway mit ihrem Modellanbieter verbinden.
Einschränkungen der Clients
Die Desktop-App kann Sie nicht zur Anmeldung beim Konfigurationsserver auffordern. Wenn Ihr Server eine erneute Anmeldung verlangt, führen Sie codex login in einem Terminal auf demselben Computer aus und öffnen Sie anschließend die App erneut. Wenn die App die erforderlichen Einstellungen nicht laden kann, wird der Start angehalten.
Codex für die Verwendung des Servers konfigurieren
Erstellen oder aktualisieren Sie auf einem Testcomputer die systemweite requirements.toml. Fügen Sie eine [config_server]-Tabelle mit der Basis-URL Ihres Konfigurationsservers hinzu. Verwenden Sie unter Linux und macOS /etc/codex/requirements.toml und unter Windows %ProgramData%\OpenAI\Codex\requirements.toml. Unter macOS können Sie die Tabelle auch über verwaltete Einstellungen verteilen.
[config_server]
base_url = "https://codex-config.example.com/team"Nur lokale, von Administratoren kontrollierte Anforderungen können den Server auswählen. Behalten Sie diese Tabelle auf dem Computer bei, wenn Sie den Rest Ihrer Richtlinie auf den Endpunkt verlagern.
Beim Konfigurationsserver authentifizieren (optional)
Standardmäßig versucht Codex, die Konfiguration ohne Anmeldedaten abzurufen. Wenn Ihr Server eine Anmeldung verlangt, fügen Sie [config_server.oauth] derselben requirements.toml-Datei hinzu. Codex verwendet den OAuth-Autorisierungscode-Flow mit Proof Key for Code Exchange (PKCE).
[config_server.oauth]
authorization_url = "https://login.example.com/oauth/authorize"
token_url = "https://login.example.com/oauth/token"
client_id = "codex-policy"
redirect_port = 43127Die Weiterleitungs-URI für dieses Beispiel lautet http://127.0.0.1:43127/callback. Sie können redirect_port weglassen, wenn Ihr Anbieter einen Loopback-Callback auf einem beliebigen verfügbaren Port akzeptiert. Codex sendet das Zugriffstoken im Authorization-Header. Ihr Server muss es überprüfen, bevor er das Paket zurückgibt.
Codex-Konfiguration bereitstellen
Hosten Sie Ihre verwaltete Konfiguration an einem HTTPS-Endpunkt. Wenn Codex CLI das Paket abruft, sendet es eine GET-Anfrage mit der Basis-URL aus der lokalen requirements.toml:
GET {config_server.base_url}/codex/config/bundleMit der base_url aus dem obigen Beispiel für die Erstkonfiguration sendet Codex diese Anfrage:
GET https://codex-config.example.com/team/codex/config/bundleAntworten Sie mit 200 OK und einem JSON-Konfigurationspaket im Antworttext.
Format des Konfigurationspakets
Das Paket fasst TOML-Einträge in zwei Arrays zusammen:
config_toml.enterprise_managedenthält die anzuwendenden Standardwerte. Das Feldcontentsjedes Eintrags enthältconfig.toml-Text.requirements_toml.enterprise_managedenthält die durchzusetzenden Anforderungen. Das Feldcontentsjedes Eintrags enthältrequirements.toml-Text.
Jeder Array-Eintrag hat drei Zeichenfolgenfelder: id, name (ein Anzeigename) und contents. Verwenden Sie für eine Kategorie, die Sie nicht benötigen, ein leeres Array.
Dieses Beispiel legt den Standardwert für die Websuche auf disabled fest und setzt diesen Wert mit allowed_web_search_modes durch.
{
"config_toml": {
"enterprise_managed": [
{
"id": "search-default",
"name": "Default web search",
"contents": "web_search = 'disabled'"
}
]
},
"requirements_toml": {
"enterprise_managed": [
{
"id": "search-policy",
"name": "Allowed web search modes",
"contents": "allowed_web_search_modes = ['disabled']"
}
]
}
}Konfiguration in Codex überprüfen
- Öffnen Sie auf einem Testcomputer ein Terminal in Ihrem Projektverzeichnis und führen Sie
codexaus. Schließen Sie bei entsprechender Aufforderung die Unternehmensanmeldung ab. - Geben Sie an der interaktiven Eingabeaufforderung von Codex CLI
/debug-configein und drücken Sie die Eingabetaste. - Wenn Sie Standardwerte bereitstellen, suchen Sie unter Konfigurationsebenen nach deren Namen und IDs. Suchen Sie beim obigen Beispiel nach
enterprise-managed (Default web search, search-default) (enabled). - Wenn Sie Anforderungen bereitstellen, suchen Sie unter Anforderungen nach einer von Ihnen durchgesetzten Einstellung und prüfen Sie die daneben aufgeführte Richtlinienquelle.
Codex kann mit zwischengespeicherten Einstellungen starten und sie im Hintergrund aktualisieren. Nachdem Sie eine Richtlinie auf dem Server geändert haben, warten Sie, bis Codex sie aktualisiert hat. Starten Sie dann eine neue Sitzung und wiederholen Sie die Prüfung, bevor Sie die Richtlinie auf weiteren Computern ausrollen.