Configuration de Bedrock GovCloud
Configurez les workflows locaux de Codex avec Amazon Bedrock dans AWS GovCloud
Ce guide explique comment configurer Codex pour effectuer des inférences avec Amazon Bedrock dans GovCloud. Il couvre l’accès à AWS, les paramètres des appareils gérés et les contrôles réseau.
Référence de configuration de Codex
Responsabilité partagée
Consultez le modèle de responsabilité partagée d’AWS et la documentation des services sélectionnés pour comprendre quels contrôles AWS fournit. Votre organisme est responsable de l’autorisation de leur utilisation.
Dans un déploiement pris en charge, Codex envoie les requêtes d’inférence au point de terminaison Bedrock configuré en utilisant l’authentification AWS. Votre organisation sécurise les appareils exécutant Codex, y compris les identifiants, les dépôts, les enregistrements locaux et les services tiers activés. L’utilisation de GovCloud pour l’inférence ne permet pas d’établir que l’ensemble du flux de travail répond aux exigences de votre organisme.
Liste de vérification · Paramètres des fonctionnalités
Avant de commencer
Utilisez la version 26.1002.51308 ou ultérieure de l’application de bureau, indiquée dans À propos.
| Préparation | Éléments nécessaires |
|---|---|
| Accès AWS | Un compte AWS GovCloud ayant accès au modèle Bedrock que vous utiliserez. |
| Configuration | Un fichier requirements.toml vérifié, des destinations réseau approuvées et des instructions de retour arrière. |
| Gestion des appareils | Un accès à la configuration système ou au MDM, avec des politiques réseau pour l’application, l’appareil et les commandes de l’agent. |
1. Déployer les exigences sur les appareils
Déployez requirements.toml via la configuration système ou le MDM avant de lancer l’application. Consultez la configuration gérée pour connaître les emplacements des fichiers et les modalités de déploiement par MDM. Protégez la politique gérée et vérifiez ses paramètres sur la machine exécutant Codex à l’étape 3.
Configuration recommandée pour requirements.toml
Le fichier requirements.toml par défaut ci-dessous est volontairement restrictif. Les administrateurs peuvent activer des fonctionnalités supplémentaires s’ils acceptent les risques qu’elles présentent. Consultez la documentation des fonctionnalités et la documentation des contrôles réseau.
requirements.toml
# Disable ChatGPT sign-in.
allowed_login_methods = ["api"]
# https://learn.chatgpt.com/docs/agent-approvals-security#common-sandbox-and-approval-combinations
allowed_sandbox_modes = ["read-only", "workspace-write"]
# Approval prompts are reviewed by the user.
allowed_approvals_reviewers = ["user"]
allowed_approval_policies = [
{ granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } },
]
# Allow cached search only if your AWS GovCloud Region supports web search.
allowed_web_search_modes = ["disabled", "cached"]
# Block agent browser use and native-app control.
allow_browser_and_computer_use = false
# Appshots: https://learn.chatgpt.com/docs/appshots
allow_appshots = false
# Remote control: https://learn.chatgpt.com/docs/remote-connections#pick-up-work-from-another-device
allow_remote_control = false
# Managed hooks: https://learn.chatgpt.com/docs/enterprise/managed-configuration#enforce-managed-hooks-from-requirements
allow_managed_hooks_only = true
check_for_update_on_startup = false
# MCP servers, apps, and plugins are disabled by default.
# Admins can enable supported integrations after accepting the risks
# for their use case and configuring access and network controls.
# https://learn.chatgpt.com/docs/enterprise/managed-configuration
mcp_servers = {}
[features]
apps = false
enable_mcp_apps = false
plugins = false
# Enable the network proxy for sandboxed commands.
# https://learn.chatgpt.com/docs/agent-approvals-security#network-isolation
network_proxy = true
in_app_dictation = false
realtime_conversation = false
# Browser controls: https://learn.chatgpt.com/docs/enterprise/managed-configuration#disable-codex-feature-surfaces
# Note that both browser use and computer use are up to your organization's risk appetite.
# An agent using your browser or computer may navigate to any websites or applications that the
# computer has access to. OpenAI does not currently provide additional protections restricting
# the network paths that browser use and computer use may exercise.
in_app_browser = false
browser_use = false
browser_use_external = false
browser_use_full_cdp_access = false
# Computer Use: https://learn.chatgpt.com/docs/computer-use
# Enable after accepting the risks and configuring app and network access.
computer_use = false
# Set to true to let users update through the app.
# App-store, package-manager, and MDM updates are controlled separately.
# https://learn.chatgpt.com/docs/enterprise/manage-app-updates#turn-off-in-app-updates
in_app_updates = false
image_generation = false
# Memories: https://learn.chatgpt.com/docs/customization/memories
memories = false
# Computer History: https://learn.chatgpt.com/docs/customization/computer-history
chronicle = false
external_agent_memory_import = false
# We recommend that users review approval requests themselves.
# Admins can enable automatic review after accepting the risks for their use case.
# https://learn.chatgpt.com/docs/agent-approvals-security#automatic-approval-reviews
guardian_approval = false
guardianv2 = false
# Disable background skill-search experiments.
skill_search = false
# Hooks: https://learn.chatgpt.com/docs/hooks
hooks = false
# If you enable web search, use cached search through Bedrock Mantle
# where supported by your AWS GovCloud Region.
standalone_web_search = false
# Disable feedback submissions to OpenAI.
[feedback]
enabled = false
# Network controls for agent commands:
# https://learn.chatgpt.com/docs/enterprise/managed-configuration#configure-network-access-requirements
[experimental_network]
enabled = true
managed_allowed_domains_only = true
# No domains allowed by default. Add destinations approved for your use case.
domains = {}
# Add approved Unix socket paths here.
unix_sockets = {}
# Set to true when using an organization-approved upstream proxy.
allow_upstream_proxy = false
# Keep the command proxy bound to localhost.
dangerously_allow_non_loopback_proxy = false
dangerously_allow_all_unix_sockets = false
# Local/private networking: https://learn.chatgpt.com/docs/agent-approvals-security#local-and-private-destinations
allow_local_binding = false
# App network controls: https://learn.chatgpt.com/docs/enterprise/managed-configuration#control-desktop-app-network-destinations
[application.network]
enabled = true
# Example: Bedrock Mantle in us-gov-west-1.
# Replace this hostname with the Bedrock endpoint configured in config.toml.
[application.network.domains]
"bedrock-mantle.us-gov-west-1.api.aws" = "allow"
# OpenAI and ChatGPT endpoints.
# We recommend denying these endpoints to avoid any risk that user data is sent to commercial OpenAI infrastructure.
"api.openai.com" = "deny"
"chat.openai.com" = "deny"
"chatgpt.com" = "deny"
"ab.chatgpt.com" = "deny"
"platform.openai.com" = "deny"
"auth.openai.com" = "deny"
"gov.api.openai.com" = "deny"
"gov.chatgpt.com" = "deny"
"sdfedpreastus2.oaiusercontent.com" = "deny"
"o33249.ingest.us.sentry.io" = "deny"
"persistent.oaistatic.com" = "deny"
"oaisidekickupdates.blob.core.windows.net" = "deny"
# Windows only: https://learn.chatgpt.com/docs/config-file/config-reference#requirementstoml
[windows]
allowed_sandbox_implementations = ["elevated"]2. Configurer le routage vers le fournisseur et les contrôles réseau
Définissez le fournisseur, le modèle, la région et le point de terminaison dans config.toml ou dans les valeurs par défaut gérées. Les utilisateurs peuvent modifier ces valeurs par défaut dans les limites fixées par requirements.toml.
Configuration recommandée pour config.toml
L’exemple ci-dessous utilise Mantle dans us-gov-west-1. Remplacez l’identifiant du modèle et le profil AWS par les valeurs de votre déploiement. Pour utiliser une autre région ou un autre point de terminaison pris en charge, mettez à jour conjointement l’URL, la région et la politique réseau.
L’exemple désactive les diagnostics facultatifs et le partage de données. Conservez les identifiants AWS en dehors du fichier TOML. Conservez le profil AWS, les identifiants et les scripts d’aide à l’authentification en dehors des dossiers que Codex peut modifier.
config.toml
# Replace with your approved Bedrock model ID.
model = "openai.gpt-5.6-terra"
model_provider = "amazon-bedrock"
approval_policy = { granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } }
sandbox_mode = "workspace-write"
# Set to "cached" only when supported by your model and GovCloud Region
# and approved for your deployment.
# https://docs.aws.amazon.com/bedrock/latest/userguide/web-search.html
web_search = "disabled"
# Example: Bedrock Mantle in us-gov-west-1.
[model_providers.amazon-bedrock]
base_url = "https://bedrock-mantle.us-gov-west-1.api.aws/openai/v1"
wire_api = "responses"
requires_openai_auth = false
[model_providers.amazon-bedrock.aws]
region = "us-gov-west-1"
# Replace with your AWS profile name.
profile = "codex-govcloud"
[sandbox_workspace_write]
# Command destinations are controlled by requirements.toml.
network_access = true
# Disable sending Codex usage analytics to OpenAI.
[analytics]
enabled = false
# OpenTelemetry exports are off by default.
# Admins can configure an approved collector for logs, traces, and metrics.
# https://learn.chatgpt.com/docs/config-file/config-advanced#observability-and-telemetry
[otel]
exporter = "none"
trace_exporter = "none"
metrics_exporter = "none"
log_user_prompt = falseCet exemple utilise des identifiants AWS avec Bedrock Mantle. Pour Bedrock Runtime ou une passerelle, suivez les instructions de configuration du fournisseur.
Appliquer les contrôles réseau
Ajoutez les destinations approuvées pour l’application, y compris Bedrock, à application.network.domains. Ajoutez les destinations approuvées pour les commandes à experimental_network.domains.
Les paramètres réseau de Codex ne remplacent pas le pare-feu de votre appareil.
3. Vérifier le déploiement
- Vérifiez que votre politique est active et que Codex utilise les identifiants AWS et les paramètres Bedrock prévus.
- Exécutez un workflow approuvé avec des données d’exemple.
- Vérifiez que les paramètres utilisateur ne peuvent pas contourner les restrictions gérées.
- Testez les identifiants non valides ou expirés ainsi que les échecs de routage. Vérifiez qu’aucun contenu n’est envoyé vers une destination non approuvée.
Résoudre les problèmes courants
| Problème | Points à vérifier |
|---|---|
| Point de terminaison non pris en charge | Vérifiez auprès d’OpenAI que les versions installées de l’application de bureau et d’app-server prennent en charge le point de terminaison et le modèle. |
| Compte ou rôle AWS incorrect | Vérifiez les identifiants actifs et le profil AWS sélectionné. Une API key Bedrock peut avoir priorité sur le profil. |
| Restrictions non appliquées | Vérifiez que le fichier requirements.toml prévu est chargé sur la machine exécutant Codex. |
| Fonctionnalité toujours indisponible | Consultez la documentation de la fonctionnalité pour connaître les paramètres requis et sa prise en charge par Bedrock, puis vérifiez vos contrôles réseau. |
Paramètres des fonctionnalités
Les utilisateurs ne peuvent pas modifier les paramètres des fonctionnalités imposés par requirements.toml.
Le tableau résume la configuration ci-dessus. Activé signifie que la fonctionnalité est autorisée lorsqu’elle est prise en charge ; les autres autorisations et contrôles réseau restent applicables.
Pour connaître la prise en charge par le fournisseur, consultez la disponibilité des fonctionnalités de Bedrock.
| Fonctionnalité | Par défaut | Remarques |
|---|---|---|
| Développement local, fichiers, Git et sous-agents | Activé | — |
| Tâches planifiées locales | Activé | — |
| Navigateur | Désactivé | Comprend le navigateur intégré, les navigateurs connectés, le contrôle du navigateur par l’agent et le mode développeur. |
| Computer Use et Appshots | Désactivé | — |
| Mémoire et historique de l’ordinateur | Désactivé | — |
| Génération d’images | Désactivé | Ne bloque ni les images fournies en entrée ni la lecture des fichiers image existants. |
| Recherche web | Désactivé | La recherche en cache doit être prise en charge par votre modèle et votre région GovCloud. Les règles réseau des commandes ne restreignent pas la recherche hébergée. |
| Applications et plugins | Désactivé | — |
| MCP servers configurés | Désactivé | Les administrateurs peuvent activer des serveurs approuvés après avoir accepté les risques liés à leur cas d’usage et configuré les contrôles d’accès et réseau. |
| Applications MCP interactives | Désactivé | — |
| Dictée | Désactivé | — |
| Examen automatique des demandes d’approbation | Désactivé | — |
| Contrôle à distance | Désactivé | Les connexions SSH sont distinctes. |
| Mises à jour de l’application | Désactivé | — |
L’activation de l’utilisation du navigateur par l’agent ou de Computer Use nécessite également allow_browser_and_computer_use = true.
Liste de vérification · Paramètres des fonctionnalités
Configurez Codex CLI pour effectuer l’inférence via Amazon Bedrock dans GovCloud. Les consignes sur la responsabilité partagée s’appliquent également aux déploiements CLI.
Avant de commencer
Installez Codex CLI et vérifiez la version installée :
codex --versionUtilisez Codex CLI 0.162.0 ou une version ultérieure.
Vous devez disposer d’un compte AWS GovCloud ayant accès au modèle Bedrock que vous utiliserez, ainsi que d’un accès administrateur pour déployer requirements.toml sur la machine exécutant Codex. Pour WSL ou SSH, appliquez la configuration dans l’environnement où s’exécute la CLI.
1. Déployer les exigences sur l’appareil
Déployez requirements.toml via la configuration système ou la MDM avant de lancer la CLI. Consultez la configuration gérée pour connaître les emplacements des fichiers et les modalités de déploiement par MDM. Protégez la politique gérée et vérifiez ses paramètres sur la machine qui exécute Codex à l’étape 3.
Fichier requirements.toml recommandé
Le fichier requirements.toml par défaut ci-dessous est volontairement restrictif. Les administrateurs peuvent activer des fonctionnalités supplémentaires s’ils acceptent les risques qu’elles présentent. Consultez la documentation des fonctionnalités et la documentation des contrôles réseau.
requirements.toml
# Disable ChatGPT sign-in.
allowed_login_methods = ["api"]
# https://learn.chatgpt.com/docs/agent-approvals-security#common-sandbox-and-approval-combinations
allowed_sandbox_modes = ["read-only", "workspace-write"]
# Approval prompts are reviewed by the user.
allowed_approvals_reviewers = ["user"]
allowed_approval_policies = [
{ granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } },
]
# Allow cached search only if your AWS GovCloud Region supports web search.
allowed_web_search_modes = ["disabled", "cached"]
# Remote control: https://learn.chatgpt.com/docs/cli/reference#codex-remote-control
allow_remote_control = false
# Managed hooks: https://learn.chatgpt.com/docs/enterprise/managed-configuration#enforce-managed-hooks-from-requirements
allow_managed_hooks_only = true
check_for_update_on_startup = false
# MCP servers, apps, and plugins are disabled by default.
# Admins can enable supported integrations after accepting the risks
# for their use case and configuring access and network controls.
# https://learn.chatgpt.com/docs/enterprise/managed-configuration
mcp_servers = {}
[features]
apps = false
plugins = false
# Enable the network proxy for sandboxed commands.
# https://learn.chatgpt.com/docs/agent-approvals-security#network-isolation
network_proxy = true
realtime_conversation = false
image_generation = false
# Memories: https://learn.chatgpt.com/docs/customization/memories
memories = false
external_agent_memory_import = false
# We recommend that users review approval requests themselves.
# Admins can enable automatic review after accepting the risks for their use case.
# https://learn.chatgpt.com/docs/agent-approvals-security#automatic-approval-reviews
guardian_approval = false
guardianv2 = false
# Disable background skill-search experiments.
skill_search = false
# Hooks: https://learn.chatgpt.com/docs/hooks
hooks = false
# If you enable web search, use cached search through Bedrock Mantle
# where supported by your AWS GovCloud Region.
standalone_web_search = false
# Disable feedback submissions to OpenAI.
[feedback]
enabled = false
# Network controls for agent commands:
# https://learn.chatgpt.com/docs/enterprise/managed-configuration#configure-network-access-requirements
[experimental_network]
enabled = true
managed_allowed_domains_only = true
# No domains allowed by default. Add destinations approved for your use case.
domains = {}
# Add approved Unix socket paths here.
unix_sockets = {}
# Set to true when using an organization-approved upstream proxy.
allow_upstream_proxy = false
# Keep the command proxy bound to localhost.
dangerously_allow_non_loopback_proxy = false
dangerously_allow_all_unix_sockets = false
# Local/private networking: https://learn.chatgpt.com/docs/agent-approvals-security#local-and-private-destinations
allow_local_binding = false
# Application network controls: https://learn.chatgpt.com/docs/config-file/config-reference#requirementstoml
[application.network]
enabled = true
# Example: Bedrock Mantle in us-gov-west-1.
# Replace this hostname with the Bedrock endpoint configured in config.toml.
[application.network.domains]
"bedrock-mantle.us-gov-west-1.api.aws" = "allow"
# OpenAI and ChatGPT endpoints.
# We recommend denying these endpoints to avoid any risk that user data is sent to commercial OpenAI infrastructure.
"api.openai.com" = "deny"
"chat.openai.com" = "deny"
"chatgpt.com" = "deny"
"ab.chatgpt.com" = "deny"
"platform.openai.com" = "deny"
"auth.openai.com" = "deny"
"gov.api.openai.com" = "deny"
"gov.chatgpt.com" = "deny"
"sdfedpreastus2.oaiusercontent.com" = "deny"
"o33249.ingest.us.sentry.io" = "deny"
"persistent.oaistatic.com" = "deny"
"oaisidekickupdates.blob.core.windows.net" = "deny"
# Windows only: https://learn.chatgpt.com/docs/config-file/config-reference#requirementstoml
[windows]
allowed_sandbox_implementations = ["elevated"]2. Configurer le routage vers le fournisseur et les contrôles réseau
Placez config.toml dans ~/.codex/config.toml sous Linux ou macOS, ou dans %USERPROFILE%\.codex\config.toml sous Windows. Si vous définissez CODEX_HOME, utilisez plutôt le fichier config.toml qui s’y trouve. Les utilisateurs peuvent modifier ces valeurs par défaut dans les limites fixées par requirements.toml.
Fichier config.toml recommandé
Cet exemple utilise Mantle dans us-gov-west-1. Remplacez l’identifiant du modèle et le profil AWS par les valeurs de votre déploiement. Pour une autre région ou un autre point de terminaison pris en charge, mettez à jour simultanément l’URL, la région et la politique réseau.
Conservez les identifiants AWS en dehors du fichier TOML. Conservez le profil AWS, les identifiants et les scripts d’aide à l’authentification en dehors des dossiers que Codex peut modifier. La CLI utilise les identifiants AWS pour ce fournisseur ; la connexion à ChatGPT et une API key OpenAI ne sont pas nécessaires. Consultez les options d’authentification Bedrock.
config.toml
# Replace with your approved Bedrock model ID.
model = "openai.gpt-5.6-terra"
model_provider = "amazon-bedrock"
approval_policy = { granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } }
sandbox_mode = "workspace-write"
# Set to "cached" only when supported by your model and GovCloud Region
# and approved for your deployment.
# https://docs.aws.amazon.com/bedrock/latest/userguide/web-search.html
web_search = "disabled"
# Example: Bedrock Mantle in us-gov-west-1.
[model_providers.amazon-bedrock]
base_url = "https://bedrock-mantle.us-gov-west-1.api.aws/openai/v1"
wire_api = "responses"
requires_openai_auth = false
[model_providers.amazon-bedrock.aws]
region = "us-gov-west-1"
# Replace with your AWS profile name.
profile = "codex-govcloud"
[sandbox_workspace_write]
# Command destinations are controlled by requirements.toml.
network_access = true
# Disable sending Codex usage analytics to OpenAI.
[analytics]
enabled = false
# OpenTelemetry exports are off by default.
# Admins can configure an approved collector for logs, traces, and metrics.
# https://learn.chatgpt.com/docs/config-file/config-advanced#observability-and-telemetry
[otel]
exporter = "none"
trace_exporter = "none"
metrics_exporter = "none"
log_user_prompt = falseAppliquer les contrôles réseau
Ajoutez les destinations approuvées pour la CLI, dont Bedrock, à application.network.domains. Ajoutez les destinations approuvées pour les commandes à experimental_network.domains. Ces contrôles sont distincts : autoriser Bedrock pour les requêtes au modèle n’autorise pas les commandes de l’agent à le contacter.
Dans la CLI 0.162.0, les sessions interactives et codex exec appliquent application.network aux requêtes de Codex destinées aux modèles et aux services. Ce contrôle ne couvre pas l’exécution autonome de codex login ni les téléchargements de mises à jour du démon. Les paramètres réseau de Codex ne remplacent pas le pare-feu de votre appareil. Utilisez le pare-feu pour restreindre l’accès à ces destinations et le trafic des outils d’aide à l’authentification.
3. Vérifier le déploiement
Démarrez un nouveau processus CLI après avoir modifié la configuration. Depuis un dépôt, exécutez :
codex- Ouvrez
/statuset vérifiez le modèle et le fournisseur. Vérifiez que le profil AWS configuré utilise les identifiants prévus. - Exécutez un workflow approuvé avec des données d’exemple.
- Vérifiez que les paramètres utilisateur et les options de la CLI ne peuvent pas contourner les restrictions gérées.
- Testez les identifiants invalides ou expirés et les échecs de routage. Vérifiez qu’aucun contenu n’est envoyé vers une destination non approuvée.
Vérifiez également l’utilisation non interactive depuis un dépôt :
codex exec --sandbox read-only "Reply with exactly: bedrock-ok"codex exec ne demande pas d’approbation ; les actions qui nécessitent une approbation échouent.
La réponse attendue est bedrock-ok. Vérifiez le fournisseur et le modèle dans la sortie de la CLI ; la réponse seule ne permet pas d’identifier le routage. Exécutez ensuite un workflow approuvé qui lit un fichier d’exemple, puis répétez les vérifications de la politique pour codex exec.
Résoudre les problèmes courants
| Problème | Points à vérifier |
|---|---|
| Point de terminaison non pris en charge | Confirmez auprès d’OpenAI que la version de la CLI installée prend en charge le point de terminaison et le modèle. |
| Compte ou rôle AWS incorrect | Vérifiez le profil dans model_providers.amazon-bedrock.aws et ses identifiants actifs. |
| Les restrictions ne sont pas appliquées | Vérifiez que requirements.toml est installé sur la machine qui exécute la CLI, puis démarrez un nouveau processus. |
| Une commande ne peut pas accéder au réseau | Vérifiez le bac à sable actif, sandbox_workspace_write.network_access et la liste gérée des domaines autorisés pour les commandes. L’exemple n’autorise aucune destination pour les commandes par défaut. |
| Fonctionnalité toujours indisponible | Consultez la documentation de la fonctionnalité pour vérifier les paramètres requis et sa prise en charge par Bedrock, puis vérifiez vos contrôles réseau. |
Paramètres des fonctionnalités
Les utilisateurs ne peuvent pas modifier les paramètres des fonctionnalités imposés par requirements.toml.
Le tableau résume la configuration ci-dessus. Activé signifie que la fonctionnalité est autorisée lorsqu’elle est prise en charge ; les autres autorisations et contrôles réseau restent applicables.
Pour connaître la prise en charge par le fournisseur, consultez la disponibilité des fonctionnalités Bedrock.
| Fonctionnalité | Par défaut | Remarques |
|---|---|---|
| Développement local, fichiers, Git et sous-agents | Activé | — |
| Voix dans la CLI | Désactivé | — |
| Mémoire | Désactivé | — |
| Génération d’images | Désactivé | Ne bloque pas les images en entrée ni la lecture de fichiers image existants. |
| Recherche web | Désactivé | La recherche en cache doit être prise en charge par votre modèle et votre région GovCloud. Les règles réseau des commandes ne limitent pas la recherche hébergée. |
| Applications et plugins | Désactivé | — |
| MCP servers configurés | Désactivé | Les administrateurs peuvent activer les serveurs approuvés après avoir accepté les risques liés à leur cas d’usage et configuré les contrôles d’accès et réseau. |
| Examen automatique des approbations | Désactivé | — |
| Contrôle à distance | Désactivé | — |