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

Este 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

  1. Confirme que a política está ativa e que o Codex está a utilizar as credenciais AWS e as definições do Bedrock pretendidas.
  2. Execute um fluxo de trabalho aprovado com dados de exemplo.
  3. Confirme que as definições do utilizador não podem sobrepor-se às restrições geridas.
  4. 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.