Configuração do Bedrock GovCloud

Este guia aborda as definições de segurança para executar o Codex com o AWS GovCloud em modo API. Reveja estas definições antes de autorizar fluxos de trabalho sensíveis.

Lista de verificação · Referência de capacidades · Referência de configuração do Codex

Responsabilidade partilhada

A AWS e a sua organização partilham a responsabilidade pela segurança da implementação na nuvem. Reveja o modelo de responsabilidade partilhada da AWS e a documentação dos serviços selecionados para identificar os controlos do fornecedor e as suas responsabilidades. O seu organismo é responsável por autorizar a utilização desses serviços pelo respetivo sistema.

Numa implementação suportada, o Codex envia pedidos de inferência para o endpoint do Amazon Bedrock revisto, utilizando autenticação AWS. Os requisitos do espaço de trabalho do ChatGPT e o RBAC não se aplicam a esta via em modo API. Configure a identidade AWS, o acesso aos serviços e a estação de trabalho onde o Codex é executado.

A configuração da sua estação de trabalho, incluindo os ficheiros de políticas TOML do Codex, rege o acesso a ficheiros locais, a execução de comandos, o acesso à rede, os plugins, as ferramentas MCP e as capacidades do navegador. É responsável pela segurança das estações de trabalho, credenciais, repositórios, registos locais e quaisquer serviços de terceiros ativados. Designe responsáveis pela política de dispositivos, pelos controlos de rede, pelas atualizações e pela validação da implementação.

O AWS GovCloud e estas definições, por si só, não garantem que o seu fluxo de trabalho completo cumpra os requisitos do organismo. Reveja os serviços, modelos, regiões, destinos e fluxos de dados exatos da sua implementação e documente as suas responsabilidades enquanto cliente no plano de segurança do sistema.

Antes de começar

Confirme o suporte do GovCloud na sua versão do Codex.

1. Prepare o acesso à AWS

Selecione a conta AWS e a identidade IAM aprovadas, com acesso ao modelo e à região selecionados. Provisione as credenciais através do mecanismo aprovado pela sua organização. Mantenha as credenciais fora do TOML.

Se utilizar um perfil com nome, proteja a respetiva configuração, origem das credenciais e auxiliar de credenciais contra escritas efetuadas por tarefas.

2. Implemente os requisitos dos dispositivos

Implemente o requirements.toml do Bedrock revisto através da configuração do sistema ou de MDM antes de iniciar a aplicação ou efetuar a autenticação. As sessões em modo API não recebem os requisitos do espaço de trabalho do ChatGPT nem o RBAC.

Utilize os requisitos completos abaixo como base para a sua implementação suportada do Bedrock. Reveja a referência de capacidades, as skills locais e o acesso a comandos para o fluxo de trabalho aprovado.

Siga as instruções de Configuração gerida para as localizações dos ficheiros de sistema e a distribuição por MDM. Proteja a política gerida e verifique as suas definições efetivas no anfitrião de execução no passo 4.

requirements.toml recomendado

Esta configuração restringe intencionalmente as funcionalidades. É recomendada para o GovCloud, salvo se a sua organização impuser outras restrições. Consulte a referência de configuração para obter detalhes sobre cada definição.

A tabela final [windows] aplica-se apenas ao Windows. Confirme o suporte de sandbox_private_desktop no seu ambiente de execução aprovado.

requirements.toml

allowed_login_methods = ["api"]
allowed_sandbox_modes = ["read-only", "workspace-write"]
allowed_approvals_reviewers = ["user"]
allowed_approval_policies = [
  { granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } },
]
allowed_web_search_modes = ["disabled", "cached"]
allow_browser_and_computer_use = false
allow_appshots = false
allow_remote_control = false
allow_login_shell = false
allow_managed_hooks_only = true
check_for_update_on_startup = false
mcp_servers = {}

[feedback]
enabled = false

[features]
network_proxy = true
in_app_chat = false
in_app_dictation = false
in_app_browser = false
browser_use = false
browser_use_external = false
browser_use_full_cdp_access = false
computer_use = false
in_app_updates = false
image_generation = false
memories = false
chronicle = false
external_agent_memory_import = false
guardian_approval = false
guardianv2 = false
guardian_ext = false
apps = false
enable_mcp_apps = false
plugins = false
remote_plugin = false
plugin_sharing = false
recommended_plugins = false
skill_mcp_dependency_install = false
skill_search = false
workspace_dependencies = false
hooks = false
standalone_web_search = false

[experimental_network]
enabled = true
managed_allowed_domains_only = true
domains = {}
unix_sockets = {}
allow_upstream_proxy = false
dangerously_allow_non_loopback_proxy = false
dangerously_allow_all_unix_sockets = false
allow_local_binding = false

# Application destinations

[application.network]
enabled = true

[application.network.domains]
"bedrock-mantle.us-gov-west-1.api.aws" = "allow"

# OpenAI / ChatGPT, including auth and telemetry.

"api.openai.com" = "deny"
"chat.openai.com" = "deny"
"chatgpt.com" = "deny"
"ab.chatgpt.com" = "deny"
"platform.openai.com" = "deny"
"auth.openai.com" = "deny"

# FedRAMP OpenAI endpoints are also outside this Bedrock profile.

"gov.api.openai.com" = "deny"
"gov.chatgpt.com" = "deny"
"sdfedpreastus2.oaiusercontent.com" = "deny"

# Crash reporting and distribution.

"o33249.ingest.us.sentry.io" = "deny"
"persistent.oaistatic.com" = "deny"
"oaisidekickupdates.blob.core.windows.net" = "deny"

# Windows only

[windows]
allowed_sandbox_implementations = ["elevated"]
sandbox_private_desktop = true

3. 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, separadamente de requirements.toml. Os utilizadores podem alterar as predefinições do fornecedor, salvo se a política gerida as restringir.

config.toml recomendado

Para uma implementação Mantle confirmada em us-gov-west-1, substitua o ID do modelo e o perfil por valores aprovados. Se o endpoint ou a região aprovados forem diferentes, atualize em conjunto o URL, a região e a política de rede.

Estas predefinições estabelecem a rota de inferência, correspondem à política de aprovação gerida e desativam o diagnóstico opcional e a partilha de dados. Os utilizadores podem alterar as predefinições dentro dos limites dos requisitos geridos. Mantenha as credenciais AWS fora do ficheiro TOML. A tabela final [windows] aplica-se apenas ao Windows e tem de corresponder ao seu ambiente de execução aprovado.

config.toml

model = "REPLACE_WITH_APPROVED_MODEL_ID"
model_provider = "amazon-bedrock"
forced_login_method = "api"
approval_policy = { granular = { sandbox_approval = false, rules = true, mcp_elicitations = false, request_permissions = false, skill_approval = true } }
approvals_reviewer = "user"
sandbox_mode = "workspace-write"
web_search = "cached"
allow_login_shell = false
check_for_update_on_startup = false

[model_providers.amazon-bedrock]
base_url = "https://bedrock-mantle.us-gov-west-1.api.aws/openai/v1"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
supports_standalone_web_search = false

[model_providers.amazon-bedrock.aws]
region = "us-gov-west-1"
profile = "codex-il5"

[sandbox_workspace_write]
network_access = false

[features]
network_proxy = true

[analytics]
enabled = false

[feedback]
enabled = false

[otel]
exporter = "none"
trace_exporter = "none"
metrics_exporter = "none"
log_user_prompt = false

[memories]
generate_memories = false
use_memories = false

[skills.bundled]
enabled = false

[apps._default]
enabled = false

# Windows only

[windows]
sandbox = "elevated"

A autenticação AWS continua a ser necessária quando requires_openai_auth = false. O Bedrock Runtime e os gateways com tokens de portador necessitam das suas próprias configurações aprovadas de fornecedor e autenticação; não reutilize este URL do Mantle nem este serviço de assinatura.

Aplique controlos de rede

Aplique as políticas de rede revistas da aplicação e do dispositivo, juntamente com a política separada para comandos do agente. Abranja a inferência, a obtenção e renovação de credenciais, a telemetria, o armazenamento e as atualizações. Encaminhar a inferência através do Bedrock não faz com que todo o tráfego da aplicação de ambiente de trabalho se limite à AWS.

A política de rede da aplicação abrange os pedidos suportados da aplicação e do app-server incluído. É distinta dos controlos da sandbox do agente e não é uma firewall do sistema operativo. O tráfego do atualizador nativo, o Git, o SSH, as aplicações externas, os auxiliares de credenciais e o acesso à rede dos subprocessos exigem controlos separados.

O exemplo seleciona a pesquisa em cache em us-gov-west-1. Verifique a disponibilidade regional na documentação de pesquisa na Web do AWS Bedrock e utilize a pesquisa em cache apenas quando o responsável pela implementação aprovar o serviço. Caso contrário, defina web_search = "disabled".

4. Verifique a implementação

1. Reinicie a aplicação. No anfitrião de execução, confirme os requisitos efetivos, a identidade AWS, o fornecedor, o modelo, a região e o endpoint.

2. Execute um fluxo de trabalho aprovado com dados de exemplo.

3. Confirme que as restrições de capacidades exigidas produzem efeito. Teste definições de utilizador em conflito, credenciais inválidas ou expiradas e falhas de encaminhamento; o conteúdo não pode ser encaminhado para um destino não aprovado como alternativa.

Registe as versões da aplicação de ambiente de trabalho e do app-server, a configuração efetiva, os resultados e o procedimento de reversão. Resolva as verificações falhadas ou bloqueadas antes de alargar o acesso.

Resolução de problemas comuns

Referência: restrições de capacidades do Bedrock

Estas definições descrevem o perfil de implementação inicial do Bedrock. Aplique a política completa fornecida para a sua versão suportada, incluindo os controlos de rede AWS. A automatização local e a voz em tempo real exigem controlos adicionais: in_app_local_automation e realtime_conversation não estão definidos na configuração de base acima. Reveja estas restrições para a sua implementação.

Os valores abaixo são requisitos geridos, não predefinições do utilizador. Definir uma funcionalidade como true não contorna as restrições da conta, do espaço de trabalho, do fornecedor ou do sistema operativo. Omitir um requisito mantém as verificações normais de configuração e disponibilidade.

Controlos adicionais da implementação