Настройка 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. Проверьте развёртывание
- Убедитесь, что ваша политика действует и Codex использует нужные учётные данные AWS и настройки Bedrock.
- Выполните одобренный рабочий процесс с тестовыми данными.
- Убедитесь, что пользовательские настройки не могут переопределить управляемые ограничения.
- Проверьте поведение при недействительных или просроченных учётных данных и сбоях маршрутизации. Убедитесь, что содержимое не отправляется по неодобренному адресу назначения.
Устранение распространённых проблем
| Проблема | Что проверить |
|---|---|
| Неподдерживаемая конечная точка | Уточните у 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.
Контрольный список проверки · Настройки функций
Настройте Codex CLI для выполнения инференса через Amazon Bedrock в GovCloud. Рекомендации по разделению ответственности также применяются к развёртываниям CLI.
Перед началом работы
Установите Codex CLI и проверьте установленную версию:
codex --versionИспользуйте Codex CLI 0.162.0 или новее.
Вам потребуются учётная запись AWS GovCloud с доступом к модели Bedrock, которую вы будете использовать, и права администратора для развёртывания requirements.toml на компьютере, где работает Codex. При использовании WSL или SSH примените конфигурацию внутри среды, в которой запускается CLI.
1. Разверните требования к устройству
Разверните requirements.toml через системную конфигурацию или MDM до запуска CLI. Сведения о расположении файлов и доставке через 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"]
# 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. Настройте маршрутизацию к провайдеру и управление сетевым доступом
Разместите config.toml по пути ~/.codex/config.toml в Linux или macOS либо %USERPROFILE%\.codex\config.toml в Windows. Если задана переменная CODEX_HOME, используйте вместо этого config.toml из указанного в ней каталога. Пользователи могут изменять эти настройки по умолчанию в пределах ограничений, заданных в requirements.toml.
Рекомендуемый config.toml
В примере используется Mantle в регионе us-gov-west-1. Замените идентификатор модели и профиль AWS значениями для вашего развёртывания. Для другого поддерживаемого региона или конечной точки одновременно обновите URL, регион и сетевую политику.
Храните учётные данные AWS вне файла TOML. Храните профиль AWS, учётные данные и вспомогательные скрипты для работы с ними вне папок, которые Codex может изменять. Для этого провайдера CLI использует учётные данные AWS; вход в ChatGPT и OpenAI API key не требуются. См. Варианты аутентификации в 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 = falseПримените правила сетевого доступа
Добавьте разрешённые адреса назначения для CLI, включая Bedrock, в application.network.domains. Добавьте разрешённые адреса назначения для команд в experimental_network.domains. Это независимые настройки: разрешение запросов к модели через Bedrock не позволяет командам агента обращаться к нему.
В CLI 0.162.0 интерактивные сеансы и codex exec применяют application.network к запросам Codex к моделям и сервисам. Эти правила не распространяются на отдельный запуск codex login или загрузку обновлений демона. Сетевые настройки Codex не заменяют межсетевой экран устройства. Используйте межсетевой экран, чтобы ограничить доступ к этим адресам назначения и трафик вспомогательных программ для работы с учётными данными.
3. Проверьте развёртывание
После изменения конфигурации запустите новый процесс CLI. В каталоге репозитория выполните:
codex- Откройте
/statusи проверьте модель и провайдера. Убедитесь, что настроенный профиль AWS использует нужные учётные данные. - Выполните разрешённый рабочий процесс с тестовыми данными.
- Убедитесь, что пользовательские настройки и флаги CLI не позволяют обойти управляемые ограничения.
- Проверьте поведение при недействительных или просроченных учётных данных и сбоях маршрутизации. Убедитесь, что содержимое не отправляется по неразрешённому адресу назначения.
Также проверьте неинтерактивное использование из каталога репозитория:
codex exec --sandbox read-only "Reply with exactly: bedrock-ok"codex exec не запрашивает одобрение; действия, требующие одобрения, завершаются ошибкой.
Ожидаемый ответ — bedrock-ok. Проверьте провайдера и модель в выводе CLI; сам по себе ответ не позволяет определить маршрут. Затем выполните разрешённый рабочий процесс, который читает тестовый файл, и повторите проверки политик для codex exec.
Устранение распространённых проблем
| Проблема | Что проверить |
|---|---|
| Конечная точка не поддерживается | Уточните у OpenAI, поддерживает ли установленная версия CLI эту конечную точку и модель. |
| Неверная учётная запись или роль AWS | Проверьте профиль в model_providers.amazon-bedrock.aws и его действующие учётные данные. |
| Ограничения не применяются | Убедитесь, что requirements.toml установлен на компьютере, где работает CLI, затем запустите новый процесс. |
| Команда не может получить доступ к сети | Проверьте активную песочницу, sandbox_workspace_write.network_access и управляемый список разрешённых доменов для команд. В примере по умолчанию не разрешён ни один адрес назначения для команд. |
| Функция по-прежнему недоступна | Проверьте в документации по функции необходимые настройки и поддержку в Bedrock, затем проверьте правила сетевого доступа. |
Настройки функций
Пользователи не могут переопределить настройки функций, принудительно заданные в requirements.toml.
В таблице приведена сводка конфигурации выше. Вкл. означает, что функция разрешена там, где она поддерживается; остальные разрешения и правила сетевого доступа продолжают действовать.
Сведения о поддержке со стороны провайдера см. в разделе Доступность функций Bedrock.
| Функция | По умолчанию | Примечания |
|---|---|---|
| Локальная работа с кодом, файлами, Git и субагентами | Вкл. | — |
| Голосовой ввод в CLI | Выкл. | — |
| Память | Выкл. | — |
| Генерация изображений | Выкл. | Не блокирует передачу изображений на вход или чтение существующих файлов изображений. |
| Веб-поиск | Выкл. | Поиск с кэшированием требует поддержки со стороны вашей модели и региона GovCloud. Правила сетевого доступа для команд не ограничивают поиск на стороне сервиса. |
| Приложения и плагины | Выкл. | — |
| Настроенные серверы MCP | Выкл. | Администраторы могут включить одобренные серверы, приняв риски для своего сценария использования и настроив контроль доступа и сетевые ограничения. |
| Автоматическая проверка разрешений | Выкл. | — |
| Удалённое управление | Выкл. | — |