Настройка Bedrock в GovCloud

Настройте локальные рабочие процессы Codex с Amazon Bedrock в AWS GovCloud

В этом руководстве описано, как настроить Codex для выполнения инференса через Amazon Bedrock в GovCloud. Мы рассмотрим доступ к AWS, настройки управляемых устройств и средства сетевого контроля.

Справочник по конфигурации Codex

Совместная ответственность

Изучите модель совместной ответственности AWS и документацию выбранных сервисов, чтобы понять, какие средства контроля предоставляет AWS. За разрешение на их использование отвечает ваше ведомство.

В поддерживаемом развёртывании Codex отправляет запросы инференса на настроенную конечную точку Bedrock с использованием аутентификации AWS. Ваша организация обеспечивает безопасность устройств, на которых работает Codex, включая учётные данные, репозитории, локальные записи и включённые сторонние сервисы. Использование GovCloud для инференса само по себе не подтверждает соответствие всего рабочего процесса требованиям вашего ведомства.

Контрольный список проверки · Настройки функций

Перед началом работы

Используйте настольное приложение версии 26.1002.51308 или новее; версия указана в разделе О приложении.

Подготовка Что потребуется
Доступ к AWS Учётная запись AWS GovCloud с доступом к модели Bedrock, которую вы будете использовать.
Конфигурация Проверенный файл requirements.toml, одобренные сетевые адреса назначения и инструкции по откату.
Управление устройствами Доступ к системной конфигурации или MDM, а также сетевые политики для приложения, устройства и команд агента.

1. Разверните требования для устройства

Разверните requirements.toml через системную конфигурацию или MDM до запуска приложения. Сведения о расположении файлов и доставке через MDM см. в разделе Управляемая конфигурация. Защитите управляемую политику и проверьте её настройки на компьютере, где работает Codex, на шаге 3.

Рекомендуемый requirements.toml

Приведённый ниже файл requirements.toml по умолчанию намеренно задаёт строгие ограничения. Администраторы могут включить дополнительные функции, если принимают связанные с ними риски. См. документацию по функциям и документацию по сетевым ограничениям.

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. Настройте маршрутизацию к провайдеру и сетевые ограничения

Задайте провайдера, модель, регион и конечную точку в config.toml или в управляемых настройках по умолчанию. Пользователи могут изменять эти настройки в пределах ограничений, заданных в requirements.toml.

Рекомендуемый config.toml

В примере ниже используется Mantle в us-gov-west-1. Замените идентификатор модели и профиль AWS значениями для вашего развёртывания. При использовании другого поддерживаемого региона или конечной точки обновите URL, регион и сетевую политику вместе.

В этом примере отключены необязательная диагностика и обмен данными. Храните учётные данные AWS вне файла TOML. Храните профиль AWS, учётные данные и вспомогательные скрипты для работы с ними вне папок, которые Codex может изменять.

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

В этом примере для Bedrock Mantle используются учётные данные AWS. Для Bedrock Runtime или шлюза следуйте инструкциям по настройке провайдера.

Примените сетевые ограничения

Добавьте одобренные адреса назначения приложения, включая Bedrock, в application.network.domains. Добавьте одобренные адреса назначения команд в experimental_network.domains.

Сетевые настройки Codex не заменяют межсетевой экран вашего устройства.

3. Проверьте развёртывание

  1. Убедитесь, что ваша политика действует и Codex использует нужные учётные данные AWS и настройки Bedrock.
  2. Выполните одобренный рабочий процесс с тестовыми данными.
  3. Убедитесь, что пользовательские настройки не могут переопределить управляемые ограничения.
  4. Проверьте поведение при недействительных или просроченных учётных данных и сбоях маршрутизации. Убедитесь, что содержимое не отправляется по неодобренному адресу назначения.

Устранение распространённых проблем

Проблема Что проверить
Неподдерживаемая конечная точка Уточните у OpenAI, поддерживают ли установленные версии настольного приложения и app-server эту конечную точку и модель.
Неверная учётная запись или роль AWS Проверьте активные учётные данные и выбранный профиль AWS. API key Bedrock может иметь приоритет над профилем.
Ограничения не применяются Убедитесь, что на компьютере, где работает Codex, загружен нужный файл requirements.toml.
Функция по-прежнему недоступна Проверьте в документации по функции необходимые настройки и поддержку Bedrock, затем проверьте сетевые ограничения.

Настройки функций

Пользователи не могут переопределять настройки функций, принудительно заданные в requirements.toml.

В таблице приведена сводка конфигурации выше. Вкл. означает, что функция разрешена там, где она поддерживается; остальные разрешения и сетевые ограничения продолжают действовать.

Сведения о поддержке со стороны провайдера см. в разделе Доступность функций Bedrock.

Функция По умолчанию Примечания
Локальная работа с кодом, файлами, Git и субагентами Вкл. —
Локальные задачи по расписанию Вкл. —
Браузер Выкл. Включает встроенный браузер, подключённые браузеры, управление браузером агентом и режим разработчика.
Computer Use и Appshots Выкл. —
Память и История работы на компьютере Выкл. —
Генерация изображений Выкл. Не блокирует ввод изображений или чтение существующих файлов изображений.
Поиск в интернете Выкл. Поиск по кешу требует поддержки со стороны модели и региона GovCloud. Сетевые правила для команд не ограничивают поиск на стороне сервиса.
Приложения и плагины Выкл. —
Настроенные серверы MCP Выкл. Администраторы могут включить одобренные серверы, приняв риски для своего сценария использования и настроив доступ и сетевые ограничения.
Интерактивные приложения MCP Выкл. —
Диктовка Выкл. —
Автоматическая проверка запросов на одобрение Выкл. —
Удалённое управление Выкл. Подключения SSH настраиваются отдельно.
Обновления приложения Выкл. —

Для включения использования браузера агентом или Computer Use также требуется allow_browser_and_computer_use = true.