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

Este 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

  1. Confirme que su política esté activa y que Codex utilice las credenciales de AWS y la configuración de Bedrock previstas.
  2. Ejecute un flujo de trabajo aprobado con datos de ejemplo.
  3. Confirme que la configuración del usuario no pueda anular las restricciones administradas.
  4. 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.