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 = false

Cet 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

  1. Vérifiez que votre politique est active et que Codex utilise les identifiants AWS et les paramètres Bedrock prévus.
  2. Exécutez un workflow approuvé avec des données d’exemple.
  3. Vérifiez que les paramètres utilisateur ne peuvent pas contourner les restrictions gérées.
  4. 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.