Sicherheit und Zugriffsüberwachung
Auf dieser Seite
Lektion neu geschrieben am 3. November 2026 basierend auf den Seiten Agent approvals & security, Rules, Compliance API und audit events sowie dem Codex-Handbuch. Die vorherige Version beschrieb eine nicht existierende
.codexignore-Datei, behauptete, Codex führe nur Befehle aus, die in AGENTS.md aufgeführt sind, verwies auf ein Menü „Organization Settings → Audit Logs” und erwähnte eine Codex SOC 2 Type II-Zertifizierung ohne Quelle. Quellen: Agent approvals & security · Rules · Compliance API · Pricing.
Kontrolle darüber, was Codex sehen und tun darf
Sicherheit wird kritisch, sobald ein KI-Agent auf Ihren Quellcode zugreift. Codex verfügt über eingebaute Schutzmechanismen, aber die Konfiguration liegt in Ihrer Verantwortung: Das Produkt stellt die Isolation bereit, Sie definieren den Perimeter. Wenn Sie aus Eile in der Nacht ein Repository verbinden oder ein Geheimnis in einer vergessenen Konfigurationsdatei hinterlassen, schützt die technische Isolation Sie nicht.
Das Sicherheitsmodell von Codex
Zwei komplementäre Einstellungen regeln, was der Agent tun darf: der Sandbox, der definiert, was er technisch berühren kann, und die Genehmigungspolitik, die bestimmt, wann er stoppen und um Erlaubnis bitten muss – beispielsweise beim Verlassen des Sandboxes, beim Nutzen des Netzwerks oder beim Ausführen eines Befehls außerhalb des erlaubten Satzes.
- Lokal (CLI, Erweiterung, Desktop-App) erzwingen OS-Ebene-Mechanismen den Sandbox. Standardmäßig besteht kein Netzwerkzugriff, und Schreiboperationen sind auf den aktiven Arbeitsbereich beschränkt. Mit dem gängigen Preset
--sandbox workspace-write --ask-for-approval on-requestliest, ändert und führt Codex innerhalb des Arbeitsverzeichnisses frei aus, fragt aber vor dem Schreiben an anderer Stelle oder dem Nutzen des Netzwerks. Derread-only-Modus (über den/permissions-Befehl) ermöglicht es Ihnen, zu diskutieren und zu planen, ohne Änderungen vorzunehmen. - In der Cloud läuft jede Codex-Cloud-Aufgabe in einem eigenen Arbeitsbereich innerhalb einer von OpenAI verwalteten Umgebung; Zugangsdaten und Netzwerkzugriff werden pro Umgebung konfiguriert, wobei Netzwerkgeheimnisse auf autorisierte HTTPS-Dienste beschränkt sind.
Im Gegensatz zu dem, was die vorherige Version dieser Lektion behauptete, ist Codex nicht auf Befehle beschränkt, die in AGENTS.md aufgeführt sind: Er kann Befehle ausführen, begrenzt durch das Sandbox/Genehmigung-Paar. Um weiterzugehen, regeln Regeln erlaubte Befehle außerhalb des Sandboxes: Eine Präfixregel kann eine Bestätigung erfordern oder einen Befehl ganz verbieten.
# .rules Datei (Starlark-Syntax)
prefix_rule(
pattern = ["curl"],
decision = "prompt",
justification = "Alle ausgehenden Netzwerk-Anfragen müssen bestätigt werden.",
)
Von der Administratorin oder dem Administrator durchgesetzt, können diese Regeln nur eine Bestätigung erfordern oder Aktionen verbieten; sie können keine automatische Autorisierung gewähren.
Verbergen dessen, was nicht gelesen werden sollte
Es gibt keine .codexignore-Datei. Um zu verhindern, dass Codex sensible Dateien liest, auch wenn sie versioniert sind, verwenden Sie ein Berechtigungsprofil mit deny-Regeln für exakte Pfade oder Muster:
# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3
[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"
Unter :workspace_roots platziert, gilt die Regel für jeden Wurzelordner des Arbeitsbereichs: .env-Dateien werden dort unlesbar, ohne normale Schreibvorgänge an anderer Stelle zu blockieren. Exakte Pfade funktionieren gut für stabile Standorte wie ~/.ssh; Muster eignen sich für Dateien mit variablen Standorten. Eine Administratorin oder ein Administrator kann diese Verbote über die gesamte Organisation hinweg durchsetzen (permissions.filesystem.deny_read).
Die Dokumentation vermerkt zwei Einschränkungen. Auf Linux, WSL und Windows werden Musterabgleichungen zu Beginn jedes Sandbox-Prozesses aufgelöst: Eine nachträglich erstellte, übereinstimmende Datei bleibt für einen bereits laufenden Prozess lesbar. Auch ein unbegrenztes **-Muster erfordert glob_scan_max_depth. Der sicherste Ansatz bleibt, Geheimnisse ganz aus dem Repository herauszuhalten.
Geben Sie dieselbe Vorsicht für AGENTS.md an, den Codex bei jedem Lauf liest. Platzieren Sie niemals echte Geheimnisse dort: Dummy-Werte genügen, um das von Ihren Testbefehlen erwartete Format zu erklären.
## Umgebungsvariablen
Testbefehle verwenden Dummy-Variablen:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only
Verfolgung und Überwachung
In Enterprise- und Edu-Plänen gehen Audit-Logs und Nutzungsnachverfolgungen über die Compliance API. Sie unterstützt Sicherheits-, rechtliche und investigative Zwecke, die nachweisbare Aufzeichnungen erfordern: Exportieren von Ereignissen in ein SIEM oder einen Datensee, Anwenden Ihrer Aufbewahrungsfristen und rechtlichen Sperren sowie Korrelieren von Codex-Aktivitäten mit Ihren Identitätsdaten. Die Dokumentation der Admin API regelt abgedeckte Ereignisse, Filter und Aufbewahrung; testen Sie die Ingestion zunächst auf einem Nicht-Produktionssystem, bevor Sie eine kontinuierliche Sammlung planen.
Dies ist kein Produktivitäts-Dashboard: OpenAI rät davon ab, es zur Beurteilung der Codequalität oder individueller Leistung zu verwenden, und verweist stattdessen auf Workspace-Einblicke und die Analytics API für Adoptionsmetriken. Jemand muss diese Logs tatsächlich über Post-Incident-Reviews hinaus nutzen: Halten Sie sie außerhalb der vom Agent kontrollierten Umgebung und alarmieren Sie bei wiederholten Authentifizierungsfehlern, ungewöhnlichem Zugriff und Konfigurationsänderungen.
Compliance und Regulierung
Wenn Ihr Code europäische personenbezogene Daten verarbeitet, fallen vier Punkte in Ihre Verantwortung, nicht in die des Anbieters. Stellen Sie sicher, dass Ihr OpenAI-Vertrag ein DPA (Data Processing Agreement) enthält; verwenden Sie Steuerungen für Datenhaltung und -residenz, wenn Ihr Plan diese bietet (Enterprise und Edu); dokumentieren Sie die Codex-Nutzung in Ihrem Verzeichnis von Verarbeitungstätigkeiten; und informieren Sie Teams schließlich, dass ihr Code von einem Drittanbieterdienst verarbeitet wird. Im Business-Plan werden Unternehmensdaten standardmäßig nicht zum Training verwendet.
Für eine SOC 2- oder ISO 27001-Audit verlassen Sie sich auf von OpenAI veröffentlichte Dokumente – einschließlich des Codex Security Whitepaper auf dessen Trust-Portal – und überprüfen Sie den Geltungsbereich und das Datum jeder Attestierung: Eine abgelaufene Attestierung oder eine, die den von Ihnen genutzten Dienst nicht abdeckt, hat für eine Prüfstelle kein Gewicht. Compliance-API-Exporte erfüllen Nachvollziehbarkeitsanforderungen, sofern sie kontinuierlich gesammelt und auf Anforderung erstellt werden.
Sicherheitsbest Practices
- - Das Lesen sensibler Dateien verbieten (`deny`-Regeln)
- - Compliance-API-Logs sammeln und überwachen
- - Verbundene Repositories auf das Minimum beschränken
- - SSO mit MFA verwenden
- - Codex-PRs vor dem Merge überprüfen
- - Repositories mit Geheimnissen im Code verbinden
- - Echte Tokens in AGENTS.md ablegen
- - Ohne Überprüfung automatisch mergen
- - Audit-Alarme ignorieren
- - Ein Codex-Konto unter Entwicklern teilen
Die Kontenfreigabe, der letzte Punkt in der rechten Spalte, verdient besondere Erwähnung: Sie macht den gesamten Wert der Audit-Logs sofort zunichte, da keine Handlung einer identifizierbaren Person zugeordnet werden kann.
Kernaussagen
- Der Sandbox begrenzt, was Codex berühren kann (lokal: kein Netzwerk, Schreibvorgänge standardmäßig auf den Arbeitsbereich beschränkt); die Genehmigungspolitik legt fest, wann er fragt
- Regeln regeln Befehle außerhalb des Sandboxes (
promptoderforbidden) .codexignoreexistiert nicht: Verbot des Lesens sensibler Dateien überdeny-Regeln in einem Berechtigungsprofil- Audit-Logs gehen über die Compliance API (Enterprise und Edu)
- GDPR-Compliance überprüfen, wenn europäische Daten verarbeitet werden
- Nie echte Geheimnisse in AGENTS.md ablegen