Bedrock-GovCloud-Konfiguration

Dieser Leitfaden behandelt Sicherheitseinstellungen für den Betrieb von Codex mit AWS GovCloud im API-Modus. Prüfen Sie diese Einstellungen, bevor Sie sensible Workflows genehmigen.

Prüfcheckliste · Funktionsreferenz · Codex-Konfigurationsreferenz

Gemeinsame Verantwortung

AWS und Ihre Organisation teilen sich die Verantwortung für die Absicherung der Cloud-Bereitstellung. Prüfen Sie das AWS-Modell der gemeinsamen Verantwortung und die Dokumentation der ausgewählten Dienste, um die Schutzmaßnahmen des Anbieters und Ihre Zuständigkeiten zu ermitteln. Ihre Behörde ist dafür verantwortlich, die Nutzung dieser Dienste durch ihr System zu genehmigen.

Bei einer unterstützten Bereitstellung sendet Codex Inferenzanfragen unter Verwendung der AWS-Authentifizierung an den geprüften Amazon-Bedrock-Endpunkt. Anforderungen des ChatGPT-Workspace und RBAC gelten nicht für diesen Zugriffsweg im API-Modus. Konfigurieren Sie die AWS-Identität, den Dienstzugriff und den Arbeitsplatzrechner, auf dem Codex ausgeführt wird.

Die Konfiguration Ihres Arbeitsplatzrechners, einschließlich seiner Codex-TOML-Richtliniendateien, steuert den lokalen Dateizugriff, die Befehlsausführung, den Netzwerkzugriff, Plugins, MCP-Tools und Browserfunktionen. Sie sind für die Absicherung von Arbeitsplatzrechnern, Anmeldeinformationen, Repositorys, lokalen Aufzeichnungen und allen aktivierten Drittanbieterdiensten verantwortlich. Benennen Sie Verantwortliche für Geräterichtlinien, Netzwerkschutzmaßnahmen, Updates und die Validierung der Bereitstellung.

AWS GovCloud und diese Einstellungen allein belegen nicht, dass Ihr gesamter Workflow die Anforderungen Ihrer Behörde erfüllt. Prüfen Sie die konkreten Dienste, Modelle, Regionen, Ziele und Datenflüsse Ihrer Bereitstellung und dokumentieren Sie Ihre Kundenverantwortlichkeiten im Systemsicherheitsplan.

Bevor Sie beginnen

Bestätigen Sie die GovCloud-Unterstützung für Ihre Codex-Version.

1. AWS-Zugriff vorbereiten

Wählen Sie das genehmigte AWS-Konto und die IAM-Identität mit Zugriff auf das ausgewählte Modell und die ausgewählte Region aus. Stellen Sie Anmeldeinformationen über das von Ihrer Organisation genehmigte Verfahren bereit. Speichern Sie keine Anmeldeinformationen in TOML.

Schützen Sie bei einem benannten Profil dessen Konfiguration, die Quelle der Anmeldeinformationen und das Hilfsprogramm für Anmeldeinformationen vor Schreibzugriffen durch Aufgaben.

2. Geräteanforderungen bereitstellen

Stellen Sie die geprüfte Bedrock-Datei requirements.toml vor dem Start der App oder der Authentifizierung über die Systemkonfiguration oder MDM bereit. Sitzungen im API-Modus erhalten keine Anforderungen des ChatGPT-Workspace und kein RBAC.

Verwenden Sie die vollständigen Anforderungen unten als Grundlage für Ihre unterstützte Bedrock-Bereitstellung. Prüfen Sie die Funktionsreferenz, lokale skills und den Befehlszugriff für den genehmigten Workflow.

Befolgen Sie die Hinweise unter Verwaltete Konfiguration zu den Speicherorten der Systemdateien und zur Bereitstellung über MDM. Schützen Sie die verwaltete Richtlinie und überprüfen Sie ihre tatsächlich wirksamen Einstellungen auf dem Ausführungshost in Schritt 4.

Empfohlene requirements.toml

Diese Konfiguration schränkt Funktionen bewusst ein. Sie wird für GovCloud empfohlen, sofern Ihre Organisation keine anderen Einschränkungen durchsetzt. Einzelheiten zu den einzelnen Einstellungen finden Sie in der Konfigurationsreferenz.

Die abschließende Tabelle [windows] gilt nur für Windows. Bestätigen Sie die Unterstützung für sandbox_private_desktop in Ihrer genehmigten Laufzeitumgebung.

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. Anbieter-Routing und Netzwerkschutzmaßnahmen konfigurieren

Legen Sie Anbieter, Modell, Region und Endpunkt in config.toml oder in verwalteten Standardwerten fest, getrennt von requirements.toml. Benutzer können Anbieterstandardwerte ändern, sofern die verwaltete Richtlinie sie nicht einschränkt.

Empfohlene config.toml

Ersetzen Sie für eine bestätigte Mantle-Bereitstellung in us-gov-west-1 die Modell-ID und das Profil durch genehmigte Werte. Falls der genehmigte Endpunkt oder die Region abweicht, aktualisieren Sie URL, Region und Netzwerkrichtlinie gemeinsam.

Diese Standardwerte legen den Inferenzweg fest, entsprechen der verwalteten Genehmigungsrichtlinie und deaktivieren optionale Diagnosen und die Datenweitergabe. Benutzer können Standardwerte innerhalb der verwalteten Anforderungen ändern. Bewahren Sie AWS-Anmeldeinformationen außerhalb der TOML-Datei auf. Die abschließende Tabelle [windows] gilt nur für Windows und muss Ihrer genehmigten Laufzeitumgebung entsprechen.

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"

Die AWS-Authentifizierung ist auch bei requires_openai_auth = false erforderlich. Bedrock Runtime und Bearer-Token-Gateways benötigen eine eigene genehmigte Anbieter- und Authentifizierungskonfiguration; verwenden Sie diese Mantle-URL oder diesen Signierdienst dafür nicht erneut.

Netzwerkschutzmaßnahmen anwenden

Wenden Sie die geprüften Netzwerkrichtlinien für Anwendungen und Geräte sowie die separate Richtlinie für Agentenbefehle an. Berücksichtigen Sie Inferenz, Beschaffung und Erneuerung von Anmeldeinformationen, Telemetrie, Speicherung und Updates. Wenn Inferenz über Bedrock geleitet wird, bedeutet das nicht, dass der gesamte Desktop-Datenverkehr ausschließlich über AWS läuft.

Die Anwendungsnetzwerkrichtlinie deckt unterstützte Anwendungsanfragen und Anfragen des mitgelieferten app-server ab. Sie ist von den Schutzmaßnahmen der Agenten-Sandbox getrennt und keine Betriebssystem-Firewall. Datenverkehr des nativen Aktualisierungsprogramms, Git, SSH, externe Apps, Hilfsprogramme für Anmeldeinformationen und Netzwerkzugriffe von Unterprozessen erfordern separate Schutzmaßnahmen.

Das Beispiel wählt in us-gov-west-1 die Suche im Cache aus. Prüfen Sie die regionale Verfügbarkeit in der Dokumentation zur AWS-Bedrock-Websuche und verwenden Sie die Suche im Cache nur, wenn der Bereitstellungsverantwortliche den Dienst genehmigt. Setzen Sie andernfalls web_search = "disabled".

4. Bereitstellung überprüfen

1. Starten Sie die App neu. Bestätigen Sie auf dem Ausführungshost die tatsächlich wirksamen Anforderungen, die AWS-Identität, den Anbieter, das Modell, die Region und den Endpunkt.

2. Führen Sie einen genehmigten Workflow mit Beispieldaten aus.

3. Bestätigen Sie, dass die erforderlichen Funktionseinschränkungen wirksam sind. Testen Sie widersprüchliche Benutzereinstellungen, ungültige oder abgelaufene Anmeldeinformationen und Routingfehler; Inhalte dürfen bei Fehlern nicht an ein nicht genehmigtes Ziel geleitet werden.

Dokumentieren Sie die Desktop- und app-server-Versionen, die tatsächlich wirksame Konfiguration, die Ergebnisse und das Rollback-Verfahren. Klären Sie fehlgeschlagene oder blockierte Prüfungen, bevor Sie den Zugriff erweitern.

Häufige Probleme beheben

Referenz: Bedrock-Funktionseinschränkungen

Diese Einstellungen beschreiben das anfängliche Bedrock-Bereitstellungsprofil. Wenden Sie die vollständige Richtlinie an, die für Ihre unterstützte Version bereitgestellt wurde, einschließlich der AWS-Netzwerkschutzmaßnahmen. Lokale Automatisierung und Echtzeit-Sprachkommunikation erfordern zusätzliche Schutzmaßnahmen: in_app_local_automation und realtime_conversation sind in der obigen Basiskonfiguration nicht festgelegt. Prüfen Sie diese Einschränkungen für Ihre Bereitstellung.

Die folgenden Werte sind verwaltete Anforderungen, keine Benutzerstandardwerte. Das Setzen einer Funktion auf true umgeht keine Einschränkungen des Kontos, des Workspace, des Anbieters oder des Betriebssystems. Wird eine Anforderung weggelassen, bleiben die normalen Konfigurations- und Verfügbarkeitsprüfungen bestehen.

Zusätzliche Schutzmaßnahmen für die Bereitstellung