Bedrock GovCloud 設定

本指南介紹在 AWS GovCloud 中以 API 模式執行 Codex 時的安全設定。授權敏感工作流程之前，請先稽核這些設定。

驗證清單 · 功能參考 · Codex 設定參考

共同責任

AWS 與你的組織共同負責雲部署的安全。請查閱 AWS 共同責任模型以及所選服務的文件，明確供應商的控制措施和你的責任。你的機構負責授權其系統使用這些服務。

在受支援的部署中，Codex 使用 AWS 身分驗證，向已稽核的 Amazon Bedrock 端點傳送推理請求。ChatGPT 工作區要求和 RBAC 不適用於這條 API 模式路徑。請設定 AWS 身分、服務存取權限，以及執行 Codex 的工作站。

工作站設定（包括 Codex TOML 策略檔案）控制本機檔案存取、命令執行、網路存取、外掛、MCP 工具和瀏覽器功能。你負責保護工作站、憑證、儲存庫、本機記錄，以及任何已啟用的第三方服務。請為裝置策略、網路控制、更新和部署驗證指定負責人。

僅使用 AWS GovCloud 和這些設定，並不能證明完整工作流程滿足機構要求。請稽核部署中實際使用的服務、模型、區域、目標地址和資料流，並在系統安全計畫中記錄客戶方責任。

開始之前

確認當前 Codex 版本支援 GovCloud。

1. 準備 AWS 存取

選擇已核准的 AWS 帳戶和 IAM 身分，確保其能夠存取所選模型和區域。通過組織核准的機制提供憑證。不要將憑證寫入 TOML。

使用命名設定檔時，請保護其設定、憑證來源和憑證輔助程式，防止任務修改這些內容。

2. 部署裝置要求

在啟動應用或進行身分驗證之前，通過系統設定或 MDM 部署已稽核的 Bedrock requirements.toml。API 模式會話不會獲得 ChatGPT 工作區要求或 RBAC。

請以下面的完整要求作為受支援 Bedrock 部署的基線。針對已核准的工作流程，稽核功能參考、本機技能和命令存取權限。

系統檔案位置和 MDM 下發方式請參閱託管設定。保護託管策略，並按第 4 步在執行主機上驗證實際生效的設定。

建議的 requirements.toml

此設定有意限制功能。除非組織實施了其他限制，否則建議 GovCloud 使用此設定。各項設定的詳情請參閱設定參考。

最後的 [windows] 表僅適用於 Windows。請確認已核准的執行時支援 sandbox_private_desktop。

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. 設定供應商路由和網路控制

在 config.toml 或託管預設設定中設定供應商、模型、區域和端點，與 requirements.toml 分開管理。除非託管策略加以限制，否則使用者可以更改供應商預設值。

建議的 config.toml

對於已確認位於 us-gov-west-1 的 Mantle 部署，請將模型 ID 和設定檔替換為已核准的值。如果已核准的端點或區域不同，請同時更新 URL、區域和網路策略。

這些預設值設定推理路由，與託管審批策略保持一致，並關閉可選的診斷和資料共享。使用者可以在託管要求允許的範圍內更改預設值。不要將 AWS 憑證寫入 TOML 檔案。最後的 [windows] 表僅適用於 Windows，必須與你已核准的執行時一致。

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"

即使 requires_openai_auth = false，仍然需要 AWS 身分驗證。Bedrock Runtime 和使用 bearer token 的閘道器需要各自已核准的供應商和身分驗證設定；不要複用此 Mantle URL 或簽名服務。

應用網路控制

實施已稽核的應用和裝置網路策略，以及獨立的智能體命令網路策略。覆蓋推理、憑證取得與重新整理、遙測、儲存和更新。通過 Bedrock 路由推理，並不意味著桌面客戶端的所有流量都只會傳送到 AWS。

應用網路策略覆蓋受支援的應用請求和隨附 app-server 請求。它與智能體沙箱控制分開，也不是作業系統防火牆。原生更新程式流量、Git、SSH、外部應用程式、憑證輔助程式和子程序網路存取，都需要獨立的控制措施。

範例在 us-gov-west-1 中選擇快取搜尋。請查閱 AWS Bedrock 網頁搜尋文件，檢查區域可用性；只有部署負責人核准該服務後，才能使用快取搜尋。否則，設定 web_search = "disabled"。

4. 驗證部署

1. 重啟應用。在執行主機上確認實際生效的要求、AWS 身分、供應商、模型、區域和端點。

2. 使用範例資料執行已核准的工作流程。

3. 確認所需的功能限制已經生效。測試使用者設定衝突、憑證無效或過期，以及路由失敗的情況；內容不得回退到未經核准的目標地址。

記錄桌面客戶端和 app-server 版本、實際生效的設定、結果和回退流程。擴大存取範圍之前，先解決失敗或受阻的檢查。

常見問題排查

參考：Bedrock 功能限制

這些設定描述初始 Bedrock 部署設定檔。請應用受支援版本提供的完整策略，包括 AWS 網路控制。本機自動化和即時語音需要額外的控制措施：上面的基線沒有設定 in_app_local_automation 和 realtime_conversation。請稽核部署所需的這些限制。

以下值屬於託管要求，而不是使用者預設值。將某項功能設為 true，不會繞過帳戶、工作區、供應商或作業系統的限制。不指定某項要求時，仍會執行通常的設定和可用性檢查。

其他部署控制