Configuración de Bedrock GovCloud
Configure flujos de trabajo locales de Codex con Amazon Bedrock en AWS GovCloud
Esta guía explica cómo configurar Codex para realizar inferencias con Amazon Bedrock en GovCloud. Abarcamos el acceso a AWS, la configuración de dispositivos administrados y los controles de red.
Referencia de configuración de Codex
Responsabilidad compartida
Revise el modelo de responsabilidad compartida de AWS y la documentación de los servicios seleccionados para comprender qué controles proporciona AWS. Su organismo es responsable de autorizar su uso.
En una implementación compatible, Codex envía solicitudes de inferencia al punto de conexión de Bedrock configurado mediante autenticación de AWS. Su organización protege los dispositivos que ejecutan Codex, incluidas las credenciales, los repositorios, los registros locales y los servicios de terceros habilitados. Usar GovCloud para las inferencias no garantiza que todo el flujo de trabajo cumpla los requisitos de su organismo.
Lista de verificación · Configuración de funciones
Antes de comenzar
Use la versión 26.1002.51308 o posterior de la aplicación de escritorio, tal como se muestra en Acerca de.
| Preparación | Qué necesita |
|---|---|
| Acceso a AWS | Una cuenta de AWS GovCloud con acceso al modelo de Bedrock que utilizará. |
| Configuración | Un archivo requirements.toml revisado, destinos de red aprobados e instrucciones de reversión. |
| Administración de dispositivos | Acceso a la configuración del sistema o a MDM, con políticas de red para la aplicación, el dispositivo y los comandos del agente. |
1. Implemente los requisitos del dispositivo
Implemente requirements.toml mediante la configuración del sistema o MDM antes de iniciar la aplicación. Consulte Configuración administrada para conocer las ubicaciones de los archivos y la distribución mediante MDM. Proteja la política administrada y verifique sus ajustes en el equipo que ejecuta Codex en el paso 3.
requirements.toml recomendado
El archivo requirements.toml predeterminado que se muestra a continuación es restrictivo de forma intencionada. Los administradores pueden habilitar funciones adicionales si aceptan los riesgos que conllevan. Consulte la documentación de las funciones y la documentación de los controles de red.
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. Configure el enrutamiento del proveedor y los controles de red
Establezca el proveedor, el modelo, la región y el punto de conexión en config.toml o en los valores predeterminados administrados. Los usuarios pueden cambiar estos valores predeterminados dentro de los límites establecidos por requirements.toml.
config.toml recomendado
El siguiente ejemplo utiliza Mantle en us-gov-west-1. Sustituya el ID del modelo y el perfil de AWS por los valores de su implementación. Para usar otra región o punto de conexión compatible, actualice conjuntamente la URL, la región y la política de red.
El ejemplo desactiva los diagnósticos opcionales y el uso compartido de datos. Mantenga las credenciales de AWS fuera del archivo TOML. Mantenga el perfil de AWS, las credenciales y los scripts auxiliares de credenciales fuera de las carpetas que Codex pueda modificar.
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 = falseEste ejemplo utiliza credenciales de AWS con Bedrock Mantle. Para Bedrock Runtime o una puerta de enlace, siga las instrucciones de configuración del proveedor.
Aplique controles de red
Añada los destinos aprobados de la aplicación, incluido Bedrock, a application.network.domains. Añada los destinos aprobados de los comandos a experimental_network.domains.
La configuración de red de Codex no sustituye al firewall de su dispositivo.
3. Verifique la implementación
- Confirme que su política esté activa y que Codex utilice las credenciales de AWS y la configuración de Bedrock previstas.
- Ejecute un flujo de trabajo aprobado con datos de ejemplo.
- Confirme que la configuración del usuario no pueda anular las restricciones administradas.
- Pruebe credenciales no válidas o caducadas y fallos de enrutamiento. Confirme que el contenido no se envíe a un destino no aprobado.
Solucione problemas comunes
| Problema | Qué comprobar |
|---|---|
| Punto de conexión no compatible | Confirme con OpenAI que las versiones instaladas de la aplicación de escritorio y de app-server sean compatibles con el punto de conexión y el modelo. |
| Cuenta o rol de AWS incorrectos | Compruebe las credenciales activas y el perfil de AWS seleccionado. Una API key de Bedrock puede tener prioridad sobre el perfil. |
| No se aplican las restricciones | Confirme que el archivo requirements.toml previsto esté cargado en el equipo que ejecuta Codex. |
| La función sigue sin estar disponible | Consulte la documentación de la función para conocer los ajustes necesarios y la compatibilidad con Bedrock; después, compruebe los controles de red. |
Configuración de funciones
Los usuarios no pueden anular los ajustes de funciones impuestos por requirements.toml.
La tabla resume la configuración anterior. Activado significa que se permite cuando es compatible; los demás permisos y controles de red siguen aplicándose.
Para conocer la compatibilidad del proveedor, consulte Disponibilidad de funciones de Bedrock.
| Función | Valor predeterminado | Notas |
|---|---|---|
| Programación local, archivos, Git y subagentes | Activado | — |
| Tareas programadas locales | Activado | — |
| Navegador | Desactivado | Incluye el navegador integrado, los navegadores conectados, el control del navegador por parte del agente y el modo de desarrollador. |
| Uso del equipo y Appshots | Desactivado | — |
| Memoria e Historial del equipo | Desactivado | — |
| Generación de imágenes | Desactivado | No bloquea las imágenes de entrada ni la lectura de archivos de imagen existentes. |
| Búsqueda web | Desactivado | La búsqueda en caché requiere compatibilidad con su modelo y región de GovCloud. Las reglas de red de los comandos no restringen la búsqueda alojada. |
| Aplicaciones y plugins | Desactivado | — |
| MCP servers configurados | Desactivado | Los administradores pueden habilitar servidores aprobados tras aceptar los riesgos de su caso de uso y configurar los controles de acceso y de red. |
| Aplicaciones MCP interactivas | Desactivado | — |
| Dictado | Desactivado | — |
| Revisión automática de aprobaciones | Desactivado | — |
| Control remoto | Desactivado | Las conexiones SSH son independientes. |
| Actualizaciones de la aplicación | Desactivado | — |
Para habilitar el uso del navegador por parte del agente o el uso del equipo, también se requiere allow_browser_and_computer_use = true.
Lista de verificación · Configuración de funciones
Configure Codex CLI para realizar inferencias con Amazon Bedrock en GovCloud. Las directrices de responsabilidad compartida también se aplican a las implementaciones de CLI.
Antes de comenzar
Instale Codex CLI y compruebe la versión instalada:
codex --versionUtilice Codex CLI 0.162.0 o posterior.
Necesita una cuenta de AWS GovCloud con acceso al modelo de Bedrock que utilizará y acceso de administrador para implementar requirements.toml en el equipo que ejecuta Codex. Para WSL o SSH, aplique la configuración dentro del entorno donde se ejecuta la CLI.
1. Implemente los requisitos del dispositivo
Implemente requirements.toml mediante la configuración del sistema o MDM antes de iniciar la CLI. Siga las indicaciones de Configuración administrada para conocer las ubicaciones de los archivos y la distribución mediante MDM. Proteja la política administrada y verifique sus ajustes en el equipo que ejecuta Codex en el paso 3.
requirements.toml recomendado
El archivo requirements.toml predeterminado que se muestra a continuación es deliberadamente restrictivo. Los administradores pueden habilitar funciones adicionales si aceptan los riesgos que implican. Consulte la documentación de las funciones y la documentación de los controles de red.
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. Configure el enrutamiento del proveedor y los controles de red
Coloque config.toml en ~/.codex/config.toml en Linux o macOS, o en %USERPROFILE%\.codex\config.toml en Windows. Si establece CODEX_HOME, utilice su archivo config.toml. Los usuarios pueden cambiar estos valores predeterminados dentro de los límites establecidos por requirements.toml.
config.toml recomendado
El ejemplo utiliza Mantle en us-gov-west-1. Sustituya el ID del modelo y el perfil de AWS por los valores de su implementación. Para otra región o endpoint compatible, actualice conjuntamente la URL, la región y la política de red.
Mantenga las credenciales de AWS fuera del archivo TOML. Mantenga el perfil de AWS, las credenciales y los scripts auxiliares de credenciales fuera de las carpetas que Codex pueda modificar. La CLI utiliza credenciales de AWS para este proveedor; no se requiere iniciar sesión en ChatGPT ni una API key de OpenAI. Consulte las opciones de autenticación de 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 = falseAplique controles de red
Añada los destinos aprobados de la CLI, incluido Bedrock, a application.network.domains. Añada los destinos aprobados de los comandos a experimental_network.domains. Estos controles son independientes: permitir Bedrock para las solicitudes al modelo no permite que los comandos del agente se conecten a él.
En la CLI 0.162.0, las sesiones interactivas y codex exec aplican application.network a las solicitudes de Codex a modelos y servicios. Esto no cubre la ejecución independiente de codex login ni las descargas de actualizaciones del daemon. Los ajustes de red de Codex no sustituyen al firewall del dispositivo. Utilice el firewall para restringir esos destinos y el tráfico de los scripts auxiliares de credenciales.
3. Verifique la implementación
Inicie un nuevo proceso de la CLI después de cambiar la configuración. Desde un repositorio, ejecute:
codex- Abra
/statusy confirme el modelo y el proveedor. Compruebe que el perfil de AWS configurado utiliza las credenciales previstas. - Ejecute un flujo de trabajo aprobado con datos de ejemplo.
- Confirme que los ajustes del usuario y las opciones de la CLI no pueden anular las restricciones administradas.
- Pruebe con credenciales no válidas o caducadas y con fallos de enrutamiento. Confirme que el contenido no se envía a un destino no aprobado.
Compruebe también el uso no interactivo desde un repositorio:
codex exec --sandbox read-only "Reply with exactly: bedrock-ok"codex exec no solicita aprobación; las acciones que requieren aprobación fallan.
La respuesta esperada es bedrock-ok. Confirme el proveedor y el modelo en la salida de la CLI; la respuesta por sí sola no identifica la ruta. A continuación, ejecute un flujo de trabajo aprobado que lea un archivo de ejemplo y repita las comprobaciones de la política para codex exec.
Solucione problemas comunes
| Problema | Qué comprobar |
|---|---|
| Endpoint no compatible | Confirme con OpenAI que la versión de la CLI instalada es compatible con el endpoint y el modelo. |
| Cuenta o rol de AWS incorrectos | Compruebe el perfil en model_providers.amazon-bedrock.aws y sus credenciales activas. |
| Las restricciones no se aplican | Confirme que requirements.toml está instalado en el equipo que ejecuta la CLI y, a continuación, inicie un nuevo proceso. |
| Un comando no puede acceder a la red | Compruebe el entorno aislado activo, sandbox_workspace_write.network_access y la lista administrada de dominios permitidos para los comandos. El ejemplo no permite ningún destino para los comandos de forma predeterminada. |
| La función sigue sin estar disponible | Consulte la documentación de la función para conocer los ajustes necesarios y la compatibilidad con Bedrock y, a continuación, compruebe los controles de red. |
Ajustes de las funciones
Los usuarios no pueden anular los ajustes de las funciones impuestos por requirements.toml.
La tabla resume la configuración anterior. Activado significa que se permite cuando es compatible; los demás permisos y controles de red siguen aplicándose.
Para conocer la compatibilidad del proveedor, consulte la disponibilidad de funciones de Bedrock.
| Función | Predeterminado | Notas |
|---|---|---|
| Programación local, archivos, Git y subagentes | Activado | — |
| Voz en CLI | Desactivado | — |
| Memoria | Desactivado | — |
| Generación de imágenes | Desactivado | No bloquea las entradas de imágenes ni la lectura de archivos de imagen existentes. |
| Búsqueda web | Desactivado | La búsqueda en caché requiere compatibilidad con su modelo y su región de GovCloud. Las reglas de red para comandos no restringen la búsqueda alojada. |
| Apps y plugins | Desactivado | — |
| MCP servers configurados | Desactivado | Los administradores pueden habilitar servidores aprobados tras aceptar los riesgos de su caso de uso y configurar los controles de acceso y de red. |
| Revisión automática de aprobaciones | Desactivado | — |
| Control remoto | Desactivado | — |