Bedrock GovCloud yapılandırması

AWS GovCloud üzerinde Amazon Bedrock ile yerel Codex iş akışlarını yapılandırın

Bu kılavuz, GovCloud'daki Amazon Bedrock üzerinden çıkarım yapmak için Codex'in nasıl yapılandırılacağını açıklar. AWS erişimini, yönetilen cihaz ayarlarını ve ağ kontrollerini ele alır.

Codex yapılandırma başvurusu

Paylaşılan sorumluluk

AWS'nin hangi kontrolleri sağladığını anlamak için AWS ortak sorumluluk modelini ve seçtiğiniz hizmetlerin belgelerini inceleyin. Bu hizmetlerin kullanımını yetkilendirmek kurumunuzun sorumluluğundadır.

Desteklenen bir dağıtımda Codex, AWS kimlik doğrulamasını kullanarak çıkarım isteklerini yapılandırılmış Bedrock uç noktasına gönderir. Kuruluşunuz; kimlik bilgileri, depolar, yerel kayıtlar ve etkinleştirilmiş üçüncü taraf hizmetler dahil olmak üzere Codex'i çalıştıran cihazların güvenliğini sağlar. Çıkarım için GovCloud kullanılması, iş akışının tamamının kurumunuzun gereksinimlerini karşıladığını göstermez.

Doğrulama kontrol listesi · Özellik ayarları

Başlamadan önce

Hakkında bölümünde gösterilen masaüstü uygulama sürümünün 26.1002.51308 veya üzeri olduğundan emin olun.

Hazırlık Gerekenler
AWS erişimi Kullanacağınız Bedrock modeline erişimi olan bir AWS GovCloud hesabı.
Yapılandırma Gözden geçirilmiş bir requirements.toml, onaylanmış ağ hedefleri ve geri alma talimatları.
Cihaz yönetimi Uygulama, cihaz ve ajan komutlarına yönelik ağ ilkeleriyle birlikte sistem yapılandırması veya MDM erişimi.

1. Cihaz gereksinimlerini dağıtın

Uygulama başlatılmadan önce requirements.toml dosyasını sistem yapılandırması veya MDM aracılığıyla dağıtın. Dosya konumları ve MDM aracılığıyla dağıtım için Yönetilen yapılandırma bölümünü izleyin. Yönetilen ilkeyi koruyun ve 3. adımda ayarlarını Codex'i çalıştıran makinede doğrulayın.

Önerilen requirements.toml

Aşağıdaki varsayılan requirements.toml bilerek kısıtlayıcı tutulmuştur. Yöneticiler, ek özelliklerin oluşturduğu riskleri kabul ediyorlarsa bu özellikleri etkinleştirebilir. Özellik belgelerine ve ağ kontrolü belgelerine başvurun.

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. Sağlayıcı yönlendirmesini ve ağ kontrollerini yapılandırın

Sağlayıcıyı, modeli, bölgeyi ve uç noktayı config.toml dosyasında veya yönetilen varsayılan ayarlarda belirleyin. Kullanıcılar bu varsayılanları requirements.toml tarafından belirlenen sınırlar içinde değiştirebilir.

Önerilen config.toml

Aşağıdaki örnekte us-gov-west-1 bölgesindeki Mantle kullanılır. Model kimliğini ve AWS profilini dağıtımınızın değerleriyle değiştirin. Desteklenen başka bir bölge veya uç nokta için URL'yi, bölgeyi ve ağ ilkesini birlikte güncelleyin.

Örnek, isteğe bağlı tanılama ve veri paylaşımını kapatır. AWS kimlik bilgilerini TOML dosyasının dışında tutun. AWS profilini, kimlik bilgilerini ve kimlik bilgisi yardımcı betiklerini Codex'in değiştirebileceği klasörlerin dışında tutun.

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

Bu örnekte Bedrock Mantle ile AWS kimlik bilgileri kullanılır. Bedrock Runtime veya bir ağ geçidi için sağlayıcı kurulum talimatlarını izleyin.

Ağ kontrollerini uygulayın

Bedrock dahil olmak üzere onaylanmış uygulama hedeflerini application.network.domains alanına ekleyin. Onaylanmış komut hedeflerini experimental_network.domains alanına ekleyin.

Codex'in ağ ayarları, cihazınızın güvenlik duvarının yerini almaz.

3. Dağıtımı doğrulayın

  1. İlkenizin etkin olduğunu ve Codex'in amaçlanan AWS kimlik bilgilerini ve Bedrock ayarlarını kullandığını doğrulayın.
  2. Örnek verilerle onaylanmış bir iş akışı çalıştırın.
  3. Kullanıcı ayarlarının yönetilen kısıtlamaları geçersiz kılamadığını doğrulayın.
  4. Geçersiz veya süresi dolmuş kimlik bilgilerini ve yönlendirme hatalarını test edin. İçeriğin onaylanmamış bir hedefe gönderilmediğini doğrulayın.

Yaygın sorunları giderme

Sorun Kontrol edilecekler
Desteklenmeyen uç nokta Yüklü masaüstü ve app-server sürümlerinizin uç noktayı ve modeli desteklediğini OpenAI ile doğrulayın.
Yanlış AWS hesabı veya rolü Etkin kimlik bilgilerini ve seçilen AWS profilini kontrol edin. Bir Bedrock API key, profile göre öncelikli olabilir.
Kısıtlamalar uygulanmıyor Amaçlanan requirements.toml dosyasının Codex'i çalıştıran makinede yüklendiğini doğrulayın.
Özellik hâlâ kullanılamıyor Gerekli ayarlar ve Bedrock desteği için özellik belgelerini inceleyin, ardından ağ kontrollerinizi kontrol edin.

Özellik ayarları

Kullanıcılar, requirements.toml tarafından zorunlu kılınan özellik ayarlarını geçersiz kılamaz.

Tablo, yukarıdaki yapılandırmayı özetler. Açık, desteklenen durumlarda izin verildiği anlamına gelir; diğer izinler ve ağ denetimleri geçerliliğini korur.

Sağlayıcı desteği için Bedrock özellik kullanılabilirliği bölümüne bakın.

Özellik Varsayılan Notlar
Yerel kodlama, dosyalar, Git ve alt ajanlar Açık —
Yerel zamanlanmış görevler Açık —
Tarayıcı Kapalı Yerleşik tarayıcıyı, bağlı tarayıcıları, ajanın tarayıcı denetimini ve Geliştirici modunu kapsar.
Bilgisayar Kullanımı ve Appshots Kapalı —
Bellek ve Bilgisayar Geçmişi Kapalı —
Görsel oluşturma Kapalı Görsel girdilerini veya mevcut görsel dosyalarının okunmasını engellemez.
Web araması Kapalı Önbelleğe alınmış arama, modelinizde ve GovCloud bölgenizde desteklenmelidir. Komut ağı kuralları, barındırılan aramayı kısıtlamaz.
Uygulamalar ve eklentiler Kapalı —
Yapılandırılmış MCP server'lar Kapalı Yöneticiler, kullanım senaryolarına ilişkin riskleri kabul edip erişim ve ağ denetimlerini yapılandırdıktan sonra onaylı sunucuları etkinleştirebilir.
Etkileşimli MCP uygulamaları Kapalı —
Dikte Kapalı —
Otomatik onay incelemesi Kapalı —
Uzaktan denetim Kapalı SSH bağlantıları ayrıdır.
Uygulama güncellemeleri Kapalı —

Ajanın tarayıcı kullanımını veya Bilgisayar Kullanımını etkinleştirmek için ayrıca allow_browser_and_computer_use = true ayarı gerekir.