Bedrock GovCloud の設定

AWS GovCloud の Amazon Bedrock を使用するローカル Codex ワークフローを設定します

このガイドでは、GovCloud の Amazon Bedrock で推論を実行するための Codex の設定方法を説明します。AWS へのアクセス、管理対象デバイスの設定、ネットワーク制御を取り上げます。

Codex 設定リファレンス

責任共有

AWS 責任共有モデルと、選択したサービスのドキュメントを確認し、AWS が提供する制御を把握してください。それらの利用を認可する責任は、所属機関にあります。

サポート対象のデプロイ構成では、Codex は AWS 認証を使用して、設定された Bedrock エンドポイントに推論リクエストを送信します。Codex を実行するデバイスのセキュリティ確保は、認証情報、リポジトリ、ローカルの記録、有効になっているサードパーティサービスも含め、組織の責任です。推論に GovCloud を使用しても、ワークフロー全体が所属機関の要件を満たすことが保証されるわけではありません。

検証チェックリスト · 機能設定

始める前に

デスクトップアプリの バージョン 26.1002.51308 以降 を使用してください。バージョンは バージョン情報 で確認できます。

準備項目 必要なもの
AWS アクセス 使用する Bedrock モデルにアクセスできる AWS GovCloud アカウント。
構成 レビュー済みの requirements.toml、承認済みのネットワーク接続先、ロールバック手順。
デバイス管理 システム構成または MDM へのアクセス権と、アプリ、デバイス、エージェントのコマンドに適用するネットワークポリシー。

1. デバイス要件をデプロイする

アプリの起動前に、システム構成または MDM を通じて requirements.toml をデプロイします。ファイルの配置場所と MDM による配布については、管理対象の構成に従ってください。管理対象ポリシーを保護し、手順 3で Codex を実行するマシン上の設定を検証します。

推奨の 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

以下の例では、us-gov-west-1 の Mantle を使用しています。モデル ID と 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. 無効または期限切れの認証情報と、ルーティングの障害をテストします。未承認の接続先にコンテンツが送信されないことを確認します。

よくある問題のトラブルシューティング

問題 確認事項
サポートされていないエンドポイント インストール済みのデスクトップアプリと app-server のバージョンが、そのエンドポイントとモデルをサポートしているか OpenAI に確認してください。
AWS アカウントまたはロールが正しくない 現在使用中の認証情報と、選択されている AWS プロファイルを確認してください。Bedrock API key がプロファイルより優先される場合があります。
制限が適用されない Codex を実行するマシンで、意図した requirements.toml が読み込まれていることを確認してください。
機能が引き続き利用できない 機能のドキュメントで必要な設定と Bedrock のサポート状況を確認し、その後ネットワーク制御を確認してください。

機能の設定

ユーザーは、requirements.toml によって強制される機能設定を上書きできません。

次の表は、上記の構成をまとめたものです。オン は、サポートされている場合に使用が許可されることを意味します。その他の権限やネットワーク制御は引き続き適用されます。

プロバイダーのサポート状況については、Bedrock の機能の利用可否を参照してください。

機能 デフォルト 注記
ローカルでのコーディング、ファイル、Git、サブエージェント オン —
ローカルのスケジュール済みタスク オン —
ブラウザー オフ 内蔵ブラウザー、接続済みブラウザー、エージェントによるブラウザー制御、開発者モードが含まれます。
Computer Use と Appshots オフ —
メモリとコンピューター履歴 オフ —
画像生成 オフ 画像の入力や既存の画像ファイルの読み取りはブロックされません。
ウェブ検索 オフ キャッシュ検索には、モデルと GovCloud リージョンでのサポートが必要です。コマンドのネットワークルールは、ホスト型検索を制限しません。
アプリとプラグイン オフ —
構成済みの MCP server オフ 管理者は、ユースケースに伴うリスクを受け入れ、アクセス制御とネットワーク制御を構成したうえで、承認済みのサーバーを有効にできます。
対話型 MCP アプリ オフ —
音声入力 オフ —
承認の自動レビュー オフ —
リモート制御 オフ SSH 接続は別扱いです。
アプリの更新 オフ —

エージェントによるブラウザーの使用または Computer Use を有効にするには、allow_browser_and_computer_use = true も必要です。