Auto-héberger la configuration Codex de votre équipe
Fournissez à Codex des paramètres par défaut et des paramètres obligatoires depuis un point de terminaison HTTPS que vous exploitez.
Si vos utilisateurs ne se connectent pas à Codex avec ChatGPT, vous pouvez distribuer la configuration à Codex CLI et à l’application de bureau depuis un serveur HTTPS que vous exploitez. Codex charge vos paramètres au démarrage, que les utilisateurs se connectent directement à leur fournisseur de modèles ou par l’intermédiaire d’une passerelle.
Limites des clients
L’application de bureau ne peut pas vous inviter à vous connecter au serveur de configuration. Si votre serveur exige une nouvelle connexion, exécutez codex login dans un terminal sur le même ordinateur, puis rouvrez l’application. Si l’application ne peut pas charger les paramètres obligatoires, le démarrage est suspendu.
Configurer Codex pour utiliser le serveur
Sur un ordinateur de test, créez ou mettez à jour le fichier système requirements.toml. Ajoutez une table [config_server] contenant l’URL de base de votre serveur de configuration. Utilisez /etc/codex/requirements.toml sous Linux et macOS, ou %ProgramData%\OpenAI\Codex\requirements.toml sous Windows. Sous macOS, vous pouvez également distribuer la table au moyen des préférences gérées.
[config_server]
base_url = "https://codex-config.example.com/team"Seules les exigences locales contrôlées par un administrateur peuvent sélectionner le serveur. Conservez cette table sur l’ordinateur lorsque vous déplacez le reste de votre politique vers le point de terminaison.
S’authentifier auprès du serveur de configuration (facultatif)
Par défaut, Codex tente de récupérer la configuration sans identifiants. Si votre serveur exige une connexion, ajoutez [config_server.oauth] au même fichier requirements.toml. Codex utilise le flux de code d’autorisation OAuth avec 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 = 43127L’URI de redirection de cet exemple est http://127.0.0.1:43127/callback. Vous pouvez omettre redirect_port si votre fournisseur accepte un rappel sur l’interface de bouclage sur n’importe quel port disponible. Codex envoie le jeton d’accès dans l’en-tête Authorization. Votre serveur doit le vérifier avant de renvoyer le bundle.
Fournir la configuration Codex
Hébergez votre configuration gérée sur un point de terminaison HTTPS. Lorsque Codex CLI récupère le bundle, il envoie une requête GET en utilisant l’URL de base du fichier local requirements.toml :
GET {config_server.base_url}/codex/config/bundleAvec la valeur base_url de l’exemple d’amorçage ci-dessus, Codex envoie cette requête :
GET https://codex-config.example.com/team/codex/config/bundleRépondez avec 200 OK et un bundle de configuration JSON dans le corps de la réponse.
Format du bundle de configuration
Le bundle regroupe les entrées TOML dans deux tableaux :
config_toml.enterprise_managedcontient les valeurs par défaut à appliquer. Le champcontentsde chaque entrée contient du texteconfig.toml.requirements_toml.enterprise_managedcontient les exigences à imposer. Le champcontentsde chaque entrée contient du texterequirements.toml.
Chaque entrée de tableau comporte trois champs de type chaîne : id, name (un nom d’affichage) et contents. Utilisez un tableau vide pour une catégorie dont vous n’avez pas besoin.
Cet exemple définit la valeur par défaut de la recherche web sur disabled et impose cette valeur avec allowed_web_search_modes.
{
"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']"
}
]
}
}Vérifier la configuration dans Codex
- Sur un ordinateur de test, ouvrez un terminal dans le répertoire de votre projet et exécutez
codex. Connectez-vous à votre entreprise si vous y êtes invité. - À l’invite interactive de Codex CLI, saisissez
/debug-configet appuyez sur Entrée. - Si vous fournissez des valeurs par défaut, recherchez leurs noms et leurs identifiants sous Pile des couches de configuration. Avec l’exemple ci-dessus, recherchez
enterprise-managed (Default web search, search-default) (enabled). - Si vous fournissez des exigences, recherchez un paramètre que vous imposez sous Exigences et vérifiez la source de la politique indiquée à côté.
Codex peut démarrer avec des paramètres mis en cache et les actualiser en arrière-plan. Après avoir modifié une politique sur le serveur, attendez que Codex l’actualise, puis démarrez une nouvelle session et répétez la vérification avant de la déployer sur d’autres machines.