Codex CLI-Sandbox und Sicherheit
Codex CLI verfügt über integrierte Sandboxing-Mechanismen und Sicherheitsrichtlinien, um die System- und Datensicherheit zu schützen und dir gleichzeitig beim Programmieren zu helfen. In diesem Abschnitt werden diese Sicherheitsmechanismen und ihre Konfiguration ausführlich beschrieben.
Sandbox-Mechanismus
Codex führt Befehle aus und arbeitet mit Dateien in einer isolierten Sandbox-Umgebung. Dieses Design stellt sicher:
- Änderungen an Ihren Projektdateien sind kontrollierbar
- Potenziell gefährliche Befehle erfordern Ihre Bestätigung
- Sensible Daten werden nicht versehentlich offengelegt
Die Sandbox ist die erste Verteidigungslinie in der Sicherheitsrichtlinie von Codex und stellt sicher, dass die Operationen der KI nicht über Ihren erwarteten Rahmen hinausgehen können.
Ausführungsstrategie
Codex verwendet eine Ausführungsrichtlinie, um das Verhalten verschiedener Arten von Operationen zu steuern:
Richtlinientypen
| Policy | Verhalten | Anwendbare Szenarien |
|---|---|---|
ask | Vor jeder Ausführung um Bestätigung bitten | Tägliche Entwicklung (Standard) |
approve | Ausführung automatisch genehmigen | Vollständig vertrauenswürdige Umgebung |
deny | Alle Operationen ablehnen, die Nebenwirkungen haben können | Nur-Lese-Modus |
Operationen, die eine Bestätigung erfordern
Die folgenden Arten von Vorgängen lösen Bestätigungsanfragen aus:
- Ausführen von Shell-Befehlen (insbesondere
rm、killusw.) - Dateien ändern oder löschen
- Neue Datei erstellen
- Zugriff auf sensible Verzeichnisse (z. B.
~/.ssh/、/etc/) - Netzwerkanfragen (in bestimmten Fällen)
Ausführungsrichtlinie konfigurieren
Ausführungsrichtlinie in der Konfiguration festlegen
default_policy = "ask"
Aus Sicherheitsgründen wird nicht empfohlen, die Standardrichtlinie auf
approve, es sei denn, Sie verstehen die potenziellen Risiken vollständig.
Bestätigungsdialog
Wenn Codex sensible Vorgänge ausführen muss, wird ein Bestätigungsdialog angezeigt:
══════════════════════════════════════════════════════ 确认执行 ══════════════════════════════════════════════════════ Codex 计划执行以下操作: 命令: rm -rf node_modules/ 目录: /path/to/project 这将永久删除目录及其所有内容 [Y] 确认执行 [N] 取消 [A] 始终允许此类操作 ══════════════════════════════════════════════════════
Beschreibung der Optionen
| Optionen | Beschreibung |
|---|---|
Y | Nur einmal ausführen |
N | Vorgang abbrechen |
A | Regeln hinzufügen, dann automatisch genehmigen |
Seien Sie vorsichtig bei der Auswahl von "Immer erlauben" und stellen Sie sicher, dass der Vorgang tatsächlich sicher ist.
Dateizugriffskontrolle
Geschützte Verzeichnisse
Einige Systemverzeichnisse sind standardmäßig geschützt, und Codex fordert beim Zugriff auf sie eine zusätzliche Bestätigung an:
| Verzeichnis | Beschreibung |
|---|---|
~/.ssh/ | SSH-Schlüssel und -Konfiguration |
~/.aws/ | AWS-Anmeldedaten |
/etc/ | Systemkonfiguration |
~/.git-credentials | Git-Anmeldeinformationsspeicher |
Benutzerdefinierte Schutzregeln
Sie können benutzerdefinierte Schutzregeln in der Konfiguration hinzufügen:
Zugriffsregeln für Konfigurationsdateien
# Erlaubte Verzeichnisse
allowed_paths = [
"~/projects/*",
"/workspace/*"
]
# Geschützte Verzeichnisse (erfordern zusätzliche Bestätigung)
protected_paths = [
"~/.ssh/*",
"~/secrets/*"
]
Netzwerkzugriffskontrolle
Codex kann den Zugriffsbereich von Netzwerkanfragen einschränken:
Netzwerkzugriff konfigurieren
# Erlaubte Domains
allowed_domains = [
"github.com",
"api.openai.com"
]
# Ob lokaler Netzwerkzugriff erlaubt werden soll
allow_localhost = false
# Ob private Netzwerke erlaubt werden sollen
allow_private_network = false
Die Einschränkung des Netzwerkzugriffs verhindert, dass Codex versehentlich Verbindungen zu nicht vertrauenswürdigen Diensten herstellt.
Einschränkungen für Arbeitsverzeichnisse
Sie können Codex darauf beschränken, nur in bestimmten Verzeichnissen zu arbeiten:
Arbeitsverzeichnis einschränken
# Codex kann nur in diesen Verzeichnissen arbeiten
working_directories = [
"~/projects/*",
"/workspace/*"
]
# Verhalten außerhalb des Verzeichnisses: warn (Warnung) oder deny (Ablehnung)
out_of_bounds = "deny"
Whitelist/Blacklist für Befehle
Whitelist-Modus (empfohlen)
Nur die Ausführung explizit aufgeführter Befehle zulassen:
Befehls-Whitelist
# Whitelist-Modus
whitelist_enabled = true
allowed_commands = [
"git",
"npm",
"node",
"python",
"cargo"
]
Blacklist-Modus
Ausführung bestimmter Befehle verbieten:
Befehl-Blacklist
# Blacklist-Modus
blacklist_enabled = true
blocked_commands = [
"rm -rf /",
"dd",
"mkfs"
]
Der Whitelist-Modus ist sicherer und wird für den Einsatz in Produktionsumgebungen oder beim Umgang mit sensiblen Projekten empfohlen.
Umgang mit sensiblen Daten
Automatische Blockierung
Codex erkennt und blockiert sensible Informationen automatisch:
- API-Schlüssel und Passwörter
- Tokens und Authentifizierungsinformationen
- Personenbezogene Daten (PII)
Schutz von Umgebungsvariablen
Einige Umgebungsvariablen werden automatisch ausgeblendet:
AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY OPENAI_API_KEY DATABASE_URL
Sensible Daten manuell angeben
Sie können Inhalte, die geschützt werden müssen, in der Konfiguration manuell markieren:
Benutzerdefinierte Muster für sensible Daten
# Muster für reguläre Ausdrücke zum Blockieren
patterns = [
"password\\s*=\\s*[^\\s]+",
"api_key\\s*=\\s*[^\\s]+",
"secret\\s*=\\s*[^\\s]+"
]
Audit-Protokolle
Codex kann Audit-Protokolle aller Vorgänge aufzeichnen:
Audit-Protokollierung aktivieren
enabled = true
log_file = "~/.codex/log/audit.log"
Protokollinhalt
Audit-Protokolle zeichnen die folgenden Informationen auf:
- Zeitstempel
- Vorgangstyp
- Beteiligte Dateien oder Befehle
- Ergebnis des Vorgangs (Erfolg/Fehler)
- Status der Benutzerbestätigung
Audit-Log anzeigen
tail -f ~/.codex/log/audit.log
Audit-Logs sind sehr wichtig für Sicherheitsaudits und Fehlerbehebung, insbesondere in Teamumgebungen.
Bewährte Sicherheitspraktiken
Entwicklungsumgebung
- Standard-Ausführungsrichtlinie verwenden (nachfragen)
- Audit-Protokollierung aktivieren
- Befehls-Whitelist konfigurieren
Produktionsumgebung
- Arbeitsverzeichnis einschränken
- Whitelist-Modus verwenden
- Unnötigen Netzwerkzugriff deaktivieren
- Vollständige Audit-Protokollierung aktivieren
Sensible Projekte
- Strengste Schutzregeln verwenden
- Jede Bestätigungsanfrage sorgfältig prüfen
- Audit-Protokolle regelmäßig überprüfen
FAQ
F: Wo wird die Ausführungsrichtlinie konfiguriert?
Die Ausführungsrichtlinie wird hauptsächlich über~/.codex/config.tomlÜber die Konfigurationsdatei konfigurieren. Einige Einstellungen können auch über Umgebungsvariablen konfiguriert werden.
F: Was, wenn ich versehentlich auf "Immer zulassen" geklickt habe?
Die relevanten Regeln in der Konfigurationsdatei löschen oder die gesamte Konfigurationsdatei löschen und Codex neu starten; die Regeln werden zurückgesetzt.
F: Kann Codex auf mein GitHub-Token zugreifen?
Codex fordert die erforderlichen GitHub-Berechtigungen an, um Vorgänge auszuführen. Sie können diese Berechtigungen jederzeit in den GitHub-Einstellungen widerrufen.
F: Wie lassen sich Dateiänderungen vollständig deaktivieren?
Setzen Sie die Ausführungsrichtlinie aufdeny, wodurch Codex daran gehindert wird, Vorgänge auszuführen, die das Dateisystem verändern könnten.