Configuração do Bedrock GovCloud
Configure fluxos de trabalho locais do Codex com o Amazon Bedrock no AWS GovCloud
Este guia explica como configurar Codex para realizar inferência através de Amazon Bedrock em GovCloud. Abordamos o acesso à AWS, as definições de dispositivos geridos e os controlos de rede.
Referência de configuração de Codex
Responsabilidade partilhada
Consulte o modelo de responsabilidade partilhada da AWS e a documentação dos serviços selecionados para compreender os controlos fornecidos pela AWS. A sua agência é responsável por autorizar a utilização desses serviços.
Numa implementação suportada, Codex envia pedidos de inferência para o endpoint Bedrock configurado, utilizando autenticação AWS. A sua organização protege os dispositivos que executam Codex, incluindo credenciais, repositórios, registos locais e serviços de terceiros ativados. A utilização de GovCloud para inferência não demonstra que todo o fluxo de trabalho cumpre os requisitos da sua agência.
Lista de verificação · Definições de funcionalidades
Antes de começar
Use a versão 26.1002.51308 ou posterior da aplicação de computador, conforme indicado em Acerca de.
| Preparação | O que é necessário |
|---|---|
| Acesso à AWS | Uma conta AWS GovCloud com acesso ao modelo Bedrock que irá utilizar. |
| Configuração | Um requirements.toml revisto, destinos de rede aprovados e instruções de reversão. |
| Gestão de dispositivos | Acesso à configuração do sistema ou à MDM, com políticas de rede para a aplicação, o dispositivo e os comandos do agente. |
1. Implemente os requisitos do dispositivo
Implemente requirements.toml através da configuração do sistema ou da MDM antes de iniciar a aplicação. Siga as instruções em Configuração gerida para saber onde colocar os ficheiros e como os distribuir por MDM. Proteja a política gerida e verifique as respetivas definições na máquina que executa o Codex no passo 3.
requirements.toml recomendado
O requirements.toml predefinido abaixo é intencionalmente restritivo. Os administradores podem ativar funcionalidades adicionais se aceitarem os riscos que estas representam. Consulte a documentação das funcionalidades e a documentação dos controlos de rede.
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 o encaminhamento para o fornecedor e os controlos de rede
Defina o fornecedor, o modelo, a região e o endpoint em config.toml ou nas predefinições geridas. Os utilizadores podem alterar estas predefinições dentro dos limites estabelecidos por requirements.toml.
config.toml recomendado
O exemplo abaixo utiliza o Mantle em us-gov-west-1. Substitua o ID do modelo e o perfil AWS pelos valores da sua implementação. Para utilizar outra região ou endpoint suportado, atualize em conjunto o URL, a região e a política de rede.
O exemplo desativa os diagnósticos opcionais e a partilha de dados. Mantenha as credenciais AWS fora do ficheiro TOML. Mantenha o perfil AWS, as credenciais e os scripts auxiliares de credenciais fora das pastas que o Codex pode 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 exemplo utiliza credenciais AWS com o Bedrock Mantle. Para o Bedrock Runtime ou um gateway, siga as instruções de configuração do fornecedor.
Aplique controlos de rede
Adicione os destinos aprovados para a aplicação, incluindo o Bedrock, a application.network.domains. Adicione os destinos aprovados para os comandos a experimental_network.domains.
As definições de rede do Codex não substituem a firewall do dispositivo.
3. Verifique a implementação
- Confirme que a política está ativa e que o Codex está a utilizar as credenciais AWS e as definições do Bedrock pretendidas.
- Execute um fluxo de trabalho aprovado com dados de exemplo.
- Confirme que as definições do utilizador não podem sobrepor-se às restrições geridas.
- Teste credenciais inválidas ou expiradas e falhas de encaminhamento. Confirme que o conteúdo não é enviado para um destino não aprovado.
Resolução de problemas comuns
| Problema | O que verificar |
|---|---|
| Endpoint não suportado | Confirme com a OpenAI que as versões instaladas da aplicação de ambiente de trabalho e do app-server suportam o endpoint e o modelo. |
| Conta ou função AWS incorreta | Verifique as credenciais ativas e o perfil AWS selecionado. Uma API key do Bedrock pode ter precedência sobre o perfil. |
| As restrições não são aplicadas | Confirme que o requirements.toml pretendido está carregado na máquina que executa o Codex. |
| Funcionalidade ainda indisponível | Consulte a documentação da funcionalidade para verificar as definições necessárias e o suporte do Bedrock e, em seguida, verifique os controlos de rede. |
Definições das funcionalidades
Os utilizadores não podem sobrepor-se às definições das funcionalidades impostas por requirements.toml.
A tabela resume a configuração acima. Ativado significa permitido quando suportado; as restantes permissões e controlos de rede continuam a aplicar-se.
Para saber mais sobre o suporte do fornecedor, consulte a Disponibilidade de funcionalidades do Bedrock.
| Funcionalidade | Predefinição | Notas |
|---|---|---|
| Programação local, ficheiros, Git e subagentes | Ativado | — |
| Tarefas agendadas locais | Ativado | — |
| Navegador | Desativado | Inclui o navegador integrado, os navegadores ligados, o controlo do navegador pelo agente e o modo de programador. |
| Computer Use e Appshots | Desativado | — |
| Memória e Histórico do computador | Desativado | — |
| Geração de imagens | Desativado | Não bloqueia a introdução de imagens nem a leitura de ficheiros de imagem existentes. |
| Pesquisa na Web | Desativado | A pesquisa em cache requer suporte do modelo e da região GovCloud. As regras de rede dos comandos não restringem a pesquisa alojada. |
| Aplicações e plugins | Desativado | — |
| MCP servers configurados | Desativado | Os administradores podem ativar servidores aprovados após aceitarem os riscos do respetivo caso de utilização e configurarem os controlos de acesso e de rede. |
| Aplicações MCP interativas | Desativado | — |
| Ditado | Desativado | — |
| Revisão automática de aprovações | Desativado | — |
| Controlo remoto | Desativado | As ligações SSH são independentes. |
| Atualizações da aplicação | Desativado | — |
A ativação da utilização do navegador pelo agente ou do Computer Use também requer allow_browser_and_computer_use = true.
Lista de verificação · Definições das funcionalidades
Configure o Codex CLI para executar inferências através do Amazon Bedrock no GovCloud. As orientações sobre responsabilidade partilhada também se aplicam às implementações da CLI.
Antes de começar
Instale o Codex CLI e verifique a versão instalada:
codex --versionUtilize o Codex CLI 0.162.0 ou posterior.
É necessária uma conta AWS GovCloud com acesso ao modelo Bedrock que irá utilizar e acesso de administrador para implementar requirements.toml na máquina que executa o Codex. No caso de WSL ou SSH, aplique a configuração dentro do ambiente onde a CLI é executada.
1. Implementar os requisitos do dispositivo
Implemente requirements.toml através da configuração do sistema ou de MDM antes de iniciar a CLI. Siga a documentação de Configuração gerida para obter as localizações dos ficheiros e instruções de distribuição por MDM. Proteja a política gerida e verifique as respetivas definições na máquina que executa o Codex no passo 3.
requirements.toml recomendado
O ficheiro requirements.toml predefinido abaixo é intencionalmente restritivo. Os administradores podem ativar funcionalidades adicionais se aceitarem os riscos que estas representam. Consulte a documentação das funcionalidades e a documentação dos controlos de rede.
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. Configurar o encaminhamento para o fornecedor e os controlos de rede
Coloque config.toml em ~/.codex/config.toml no Linux ou macOS, ou em %USERPROFILE%\.codex\config.toml no Windows. Se definir CODEX_HOME, utilize o respetivo config.toml. Os utilizadores podem alterar estas predefinições dentro dos limites estabelecidos por requirements.toml.
config.toml recomendado
O exemplo utiliza Mantle em us-gov-west-1. Substitua o ID do modelo e o perfil AWS pelos valores da sua implementação. Para outra região ou outro endpoint compatível, atualize o URL, a região e a política de rede em conjunto.
Mantenha as credenciais AWS fora do ficheiro TOML. Mantenha o perfil AWS, as credenciais e os scripts auxiliares de credenciais fora das pastas que o Codex pode modificar. A CLI utiliza credenciais AWS para este fornecedor; não é necessário iniciar sessão no ChatGPT nem ter uma API key da OpenAI. Consulte as opções de autenticação do 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 = falseAplicar controlos de rede
Adicione os destinos aprovados da CLI, incluindo o Bedrock, a application.network.domains. Adicione os destinos aprovados dos comandos a experimental_network.domains. Estes controlos são independentes: permitir o Bedrock para pedidos ao modelo não permite que os comandos do agente comuniquem com ele.
Na CLI 0.162.0, as sessões interativas e codex exec aplicam application.network aos pedidos do Codex a modelos e serviços. Este controlo não abrange a execução autónoma de codex login nem as transferências de atualizações do daemon. As definições de rede do Codex não substituem a firewall do dispositivo. Utilize a firewall para restringir esses destinos e o tráfego dos auxiliares de credenciais.
3. Verificar a implementação
Inicie um novo processo da CLI depois de alterar a configuração. A partir de um repositório, execute:
codex- Abra
/statuse confirme o modelo e o fornecedor. Verifique se o perfil AWS configurado utiliza as credenciais pretendidas. - Execute um fluxo de trabalho aprovado com dados de exemplo.
- Confirme que as definições do utilizador e as opções da CLI não podem sobrepor-se às restrições geridas.
- Teste credenciais inválidas ou expiradas e falhas de encaminhamento. Confirme que o conteúdo não é enviado para um destino não aprovado.
Verifique também a utilização não interativa a partir de um repositório:
codex exec --sandbox read-only "Reply with exactly: bedrock-ok"codex exec não solicita aprovação; as ações que exigem aprovação falham.
A resposta esperada é bedrock-ok. Confirme o fornecedor e o modelo na saída da CLI; a resposta, por si só, não identifica a rota. Em seguida, execute um fluxo de trabalho aprovado que leia um ficheiro de exemplo e repita as verificações da política para codex exec.
Resolver problemas comuns
| Problema | O que verificar |
|---|---|
| Endpoint não suportado | Confirme com a OpenAI que a versão instalada da CLI suporta o endpoint e o modelo. |
| Conta ou função AWS incorreta | Verifique o perfil em model_providers.amazon-bedrock.aws e as respetivas credenciais ativas. |
| As restrições não são aplicadas | Confirme que requirements.toml está instalado na máquina que executa a CLI e, em seguida, inicie um novo processo. |
| Um comando não consegue aceder à rede | Verifique a sandbox ativa, sandbox_workspace_write.network_access e a lista gerida de domínios permitidos para comandos. Por predefinição, o exemplo não permite quaisquer destinos para comandos. |
| A funcionalidade continua indisponível | Consulte a documentação da funcionalidade para verificar as definições necessárias e o suporte do Bedrock e, em seguida, verifique os controlos de rede. |
Definições das funcionalidades
Os utilizadores não podem sobrepor-se às definições das funcionalidades impostas por requirements.toml.
A tabela resume a configuração acima. Ativado significa permitido quando suportado; as restantes permissões e os controlos de rede continuam a aplicar-se.
Para obter informações sobre o suporte do fornecedor, consulte a disponibilidade de funcionalidades do Bedrock.
| Funcionalidade | Predefinição | Notas |
|---|---|---|
| Programação local, ficheiros, Git e subagentes | Ativado | — |
| Voz na CLI | Desativado | — |
| Memória | Desativado | — |
| Geração de imagens | Desativado | Não bloqueia a introdução de imagens nem a leitura de ficheiros de imagem existentes. |
| Pesquisa na Web | Desativado | A pesquisa em cache requer suporte no seu modelo e na sua região GovCloud. As regras de rede dos comandos não restringem a pesquisa alojada. |
| Aplicações e plugins | Desativado | — |
| MCP servers configurados | Desativado | Os administradores podem ativar servidores aprovados após aceitarem os riscos do respetivo caso de utilização e configurarem os controlos de acesso e de rede. |
| Revisão automática de aprovações | Desativado | — |
| Controlo remoto | Desativado | — |