Konfigurasi Bedrock GovCloud

Konfigurasikan alur kerja Codex lokal dengan Amazon Bedrock di AWS GovCloud

Panduan ini menjelaskan cara mengonfigurasi Codex untuk melakukan inferensi menggunakan Amazon Bedrock di GovCloud. Kami membahas akses AWS, pengaturan perangkat terkelola, dan kontrol jaringan.

Referensi konfigurasi Codex

Tanggung jawab bersama

Tinjau model tanggung jawab bersama AWS dan dokumentasi layanan yang Anda pilih untuk memahami kontrol yang disediakan AWS. Instansi Anda bertanggung jawab untuk mengotorisasi penggunaannya.

Dalam penerapan yang didukung, Codex mengirim permintaan inferensi ke endpoint Bedrock yang dikonfigurasi menggunakan autentikasi AWS. Organisasi Anda mengamankan perangkat yang menjalankan Codex, termasuk kredensial, repositori, catatan lokal, dan layanan pihak ketiga yang diaktifkan. Penggunaan GovCloud untuk inferensi tidak membuktikan bahwa seluruh alur kerja memenuhi persyaratan instansi Anda.

Daftar periksa verifikasi · Pengaturan fitur

Sebelum memulai

Gunakan aplikasi desktop versi 26.1002.51308 atau yang lebih baru, sebagaimana ditampilkan di Tentang.

Persiapan Yang Anda perlukan
Akses AWS Akun AWS GovCloud dengan akses ke model Bedrock yang akan Anda gunakan.
Konfigurasi requirements.toml yang telah ditinjau, tujuan jaringan yang disetujui, dan petunjuk pemulihan ke kondisi sebelumnya.
Pengelolaan perangkat Akses konfigurasi sistem atau MDM, beserta kebijakan jaringan untuk aplikasi, perangkat, dan perintah agen.

1. Terapkan persyaratan perangkat

Terapkan requirements.toml melalui konfigurasi sistem atau MDM sebelum aplikasi diluncurkan. Ikuti Konfigurasi terkelola untuk mengetahui lokasi file dan distribusi melalui MDM. Lindungi kebijakan terkelola dan verifikasi pengaturannya pada mesin yang menjalankan Codex di langkah 3.

requirements.toml yang direkomendasikan

requirements.toml default di bawah ini sengaja dibuat ketat. Administrator dapat mengaktifkan fitur tambahan jika mereka menerima risiko yang ditimbulkannya. Lihat dokumentasi fitur dan dokumentasi kontrol jaringan.

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. Konfigurasikan perutean penyedia dan kontrol jaringan

Tetapkan penyedia, model, Region, dan endpoint di config.toml atau pengaturan default terkelola. Pengguna dapat mengubah pengaturan default ini dalam batas yang ditetapkan oleh requirements.toml.

config.toml yang direkomendasikan

Contoh di bawah ini menggunakan Mantle di us-gov-west-1. Ganti ID model dan profil AWS dengan nilai untuk penerapan Anda. Untuk Region atau endpoint lain yang didukung, perbarui URL, Region, dan kebijakan jaringan secara bersamaan.

Contoh ini menonaktifkan diagnostik opsional dan berbagi data. Simpan kredensial AWS di luar file TOML. Simpan profil AWS, kredensial, dan skrip pembantu kredensial di luar folder yang dapat diubah oleh 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

Contoh ini menggunakan kredensial AWS dengan Bedrock Mantle. Untuk Bedrock Runtime atau gateway, ikuti petunjuk penyiapan penyedia.

Terapkan kontrol jaringan

Tambahkan tujuan aplikasi yang disetujui, termasuk Bedrock, ke application.network.domains. Tambahkan tujuan perintah yang disetujui ke experimental_network.domains.

Pengaturan jaringan Codex tidak menggantikan firewall perangkat Anda.

3. Verifikasi penerapan

  1. Pastikan kebijakan Anda aktif dan Codex menggunakan kredensial AWS serta pengaturan Bedrock yang dimaksud.
  2. Jalankan alur kerja yang disetujui dengan data sampel.
  3. Pastikan pengaturan pengguna tidak dapat mengesampingkan pembatasan terkelola.
  4. Uji kredensial yang tidak valid atau kedaluwarsa serta kegagalan perutean. Pastikan konten tidak dikirim ke tujuan yang tidak disetujui.

Atasi masalah umum

Masalah Yang perlu diperiksa
Endpoint tidak didukung Konfirmasikan kepada OpenAI bahwa versi aplikasi desktop dan app-server yang terinstal mendukung endpoint dan model tersebut.
Akun atau peran AWS salah Periksa kredensial aktif dan profil AWS yang dipilih. API key Bedrock dapat diprioritaskan daripada profil tersebut.
Pembatasan tidak diterapkan Pastikan requirements.toml yang dimaksud dimuat pada mesin yang menjalankan Codex.
Fitur masih tidak tersedia Periksa dokumentasi fitur untuk mengetahui pengaturan yang diperlukan dan dukungan Bedrock, lalu periksa kontrol jaringan Anda.

Pengaturan fitur

Pengguna tidak dapat mengesampingkan pengaturan fitur yang diberlakukan oleh requirements.toml.

Tabel ini merangkum konfigurasi di atas. Aktif berarti diizinkan jika didukung; izin lain dan kontrol jaringan tetap berlaku.

Untuk dukungan penyedia, lihat Ketersediaan fitur Bedrock.

Fitur Default Catatan
Pemrograman lokal, file, Git, dan subagen Aktif —
Tugas terjadwal lokal Aktif —
Browser Nonaktif Mencakup browser bawaan, browser yang terhubung, kontrol browser oleh agen, dan mode Pengembang.
Computer Use dan Appshots Nonaktif —
Memori dan Riwayat Komputer Nonaktif —
Pembuatan gambar Nonaktif Tidak memblokir masukan gambar atau pembacaan file gambar yang sudah ada.
Pencarian web Nonaktif Pencarian dalam cache memerlukan dukungan dari model dan Region GovCloud Anda. Aturan jaringan perintah tidak membatasi pencarian yang dihosting.
Aplikasi dan plugin Nonaktif —
MCP server yang dikonfigurasi Nonaktif Administrator dapat mengaktifkan server yang disetujui setelah menerima risiko untuk kasus penggunaan mereka serta mengonfigurasi kontrol akses dan jaringan.
Aplikasi MCP interaktif Nonaktif —
Dikte Nonaktif —
Peninjauan persetujuan otomatis Nonaktif —
Kontrol jarak jauh Nonaktif Koneksi SSH diatur secara terpisah.
Pembaruan aplikasi Nonaktif —

Mengaktifkan penggunaan browser oleh agen atau Computer Use juga memerlukan allow_browser_and_computer_use = true.