Bedrock-GovCloud-Konfiguration

Konfigurieren Sie lokale Codex-Workflows mit Amazon Bedrock in AWS GovCloud

Diese Anleitung erläutert, wie Sie Codex so konfigurieren, dass Inferenzanfragen über Amazon Bedrock in GovCloud ausgeführt werden. Sie behandelt den AWS-Zugriff, Einstellungen für verwaltete Geräte und Netzwerkkontrollen.

Codex-Konfigurationsreferenz

Gemeinsame Verantwortung

Lesen Sie das AWS-Modell der geteilten Verantwortung und die Dokumentation der ausgewählten Dienste, um zu verstehen, welche Kontrollen AWS bereitstellt. Ihre Behörde ist dafür verantwortlich, deren Nutzung zu genehmigen.

In einer unterstützten Bereitstellung sendet Codex Inferenzanfragen mit AWS-Authentifizierung an den konfigurierten Bedrock-Endpunkt. Ihre Organisation sichert die Geräte, auf denen Codex ausgeführt wird, einschließlich Zugangsdaten, Repositorys, lokaler Aufzeichnungen und aktivierter Drittanbieterdienste. Die Nutzung von GovCloud für die Inferenz belegt nicht, dass der gesamte Workflow die Anforderungen Ihrer Behörde erfüllt.

Checkliste zur Überprüfung · Funktionseinstellungen

Bevor Sie beginnen

Verwenden Sie die Desktop-App in Version 26.1002.51308 oder höher, wie unter Info angezeigt.

Vorbereitung Was Sie benötigen
AWS-Zugriff Ein AWS GovCloud-Konto mit Zugriff auf das Bedrock-Modell, das Sie verwenden werden.
Konfiguration Eine geprüfte requirements.toml, genehmigte Netzwerkziele und Anweisungen zum Zurücksetzen.
Geräteverwaltung Zugriff auf die Systemkonfiguration oder MDM sowie Netzwerkrichtlinien für App, Gerät und Agentenbefehle.

1. Geräteanforderungen bereitstellen

Stellen Sie requirements.toml vor dem App-Start über die Systemkonfiguration oder MDM bereit. Informationen zu Dateispeicherorten und zur Bereitstellung über MDM finden Sie unter Verwaltete Konfiguration. Schützen Sie die verwaltete Richtlinie und überprüfen Sie ihre Einstellungen in Schritt 3 auf dem Rechner, auf dem Codex ausgeführt wird.

Empfohlene requirements.toml

Die folgende Standardkonfiguration in requirements.toml ist bewusst restriktiv. Administratoren können zusätzliche Funktionen aktivieren, wenn sie die damit verbundenen Risiken akzeptieren. Weitere Informationen finden Sie in der Funktionsdokumentation und der Dokumentation zu Netzwerkkontrollen.

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. Anbieterrouting und Netzwerkkontrollen konfigurieren

Legen Sie Anbieter, Modell, Region und Endpunkt in config.toml oder in den verwalteten Standardwerten fest. Benutzer können diese Standardwerte innerhalb der durch requirements.toml gesetzten Grenzen ändern.

Empfohlene config.toml

Das folgende Beispiel verwendet Mantle in us-gov-west-1. Ersetzen Sie die Modell-ID und das AWS-Profil durch die Werte Ihrer Bereitstellung. Wenn Sie eine andere unterstützte Region oder einen anderen unterstützten Endpunkt verwenden, aktualisieren Sie URL, Region und Netzwerkrichtlinie gemeinsam.

Das Beispiel deaktiviert optionale Diagnosefunktionen und die Datenfreigabe. Bewahren Sie AWS-Anmeldedaten außerhalb der TOML-Datei auf. Bewahren Sie das AWS-Profil, die Anmeldedaten und Hilfsskripte für Anmeldedaten außerhalb von Ordnern auf, die Codex ändern kann.

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

Dieses Beispiel verwendet AWS-Anmeldedaten mit Bedrock Mantle. Befolgen Sie für Bedrock Runtime oder ein Gateway die Anweisungen zur Anbietereinrichtung.

Netzwerkschutzmaßnahmen anwenden

Fügen Sie genehmigte App-Ziele, einschließlich Bedrock, zu application.network.domains hinzu. Fügen Sie genehmigte Befehlsziele zu experimental_network.domains hinzu.

Die Netzwerkeinstellungen von Codex ersetzen nicht die Firewall Ihres Geräts.

3. Bereitstellung überprüfen

  1. Vergewissern Sie sich, dass Ihre Richtlinie aktiv ist und Codex die vorgesehenen AWS-Anmeldedaten und Bedrock-Einstellungen verwendet.
  2. Führen Sie einen genehmigten Workflow mit Beispieldaten aus.
  3. Vergewissern Sie sich, dass Benutzereinstellungen die verwalteten Einschränkungen nicht außer Kraft setzen können.
  4. Testen Sie ungültige oder abgelaufene Anmeldedaten sowie Routingfehler. Vergewissern Sie sich, dass keine Inhalte an ein nicht genehmigtes Ziel gesendet werden.

Häufige Probleme beheben

Problem Was Sie überprüfen sollten
Nicht unterstützter Endpunkt Klären Sie mit OpenAI, ob Ihre installierten Desktop-App- und App-Server-Versionen den Endpunkt und das Modell unterstützen.
Falsches AWS-Konto oder falsche Rolle Überprüfen Sie die aktiven Anmeldedaten und das ausgewählte AWS-Profil. Ein Bedrock API key kann Vorrang vor dem Profil haben.
Einschränkungen werden nicht angewendet Vergewissern Sie sich, dass die vorgesehene requirements.toml auf dem Rechner geladen ist, auf dem Codex ausgeführt wird.
Funktion weiterhin nicht verfügbar Prüfen Sie in der Funktionsdokumentation die erforderlichen Einstellungen und die Bedrock-Unterstützung und überprüfen Sie anschließend Ihre Netzwerkkontrollen.

Funktionseinstellungen

Benutzer können Funktionseinstellungen, die durch requirements.toml erzwungen werden, nicht außer Kraft setzen.

Die Tabelle fasst die obige Konfiguration zusammen. Ein bedeutet, dass die Funktion zulässig ist, sofern sie unterstützt wird; andere Berechtigungen und Netzwerkkontrollen gelten weiterhin.

Informationen zur Anbieterunterstützung finden Sie unter Verfügbarkeit von Bedrock-Funktionen.

Funktion Standard Hinweise
Lokale Programmierung, Dateien, Git und Subagenten Ein —
Lokale geplante Aufgaben Ein —
Browser Aus Umfasst den integrierten Browser, verbundene Browser, die Browsersteuerung durch Agenten und den Entwicklermodus.
Computer Use und Appshots Aus —
Erinnerungen und Computerverlauf Aus —
Bildgenerierung Aus Blockiert weder Bildeingaben noch das Lesen vorhandener Bilddateien.
Websuche Aus Die Suche im Cache erfordert Unterstützung durch Ihr Modell und Ihre GovCloud-Region. Netzwerkregeln für Befehle schränken die gehostete Suche nicht ein.
Apps und Plugins Aus —
Konfigurierte MCP-Server Aus Administratoren können genehmigte Server aktivieren, nachdem sie die Risiken für ihren Anwendungsfall akzeptiert und Zugriffs- und Netzwerkkontrollen konfiguriert haben.
Interaktive MCP-Apps Aus —
Diktierfunktion Aus —
Automatische Prüfung von Genehmigungsanfragen Aus —
Fernsteuerung Aus SSH-Verbindungen sind davon unabhängig.
App-Updates Aus —

Zum Aktivieren der Browsernutzung durch Agenten oder von Computer Use ist außerdem allow_browser_and_computer_use = true erforderlich.