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

PolicyVerhaltenAnwendbare Szenarien
askVor jeder Ausführung um Bestätigung bittenTägliche Entwicklung (Standard)
approveAusführung automatisch genehmigenVollständig vertrauenswürdige Umgebung
denyAlle Operationen ablehnen, die Nebenwirkungen haben könnenNur-Lese-Modus

Operationen, die eine Bestätigung erfordern

Die folgenden Arten von Vorgängen lösen Bestätigungsanfragen aus:

  • Ausführen von Shell-Befehlen (insbesondererm、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

[exec]
default_policy = "ask"

Aus Sicherheitsgründen wird nicht empfohlen, die Standardrichtlinie aufapprove, 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

OptionenBeschreibung
YNur einmal ausführen
NVorgang abbrechen
ARegeln 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:

VerzeichnisBeschreibung
~/.ssh/SSH-Schlüssel und -Konfiguration
~/.aws/AWS-Anmeldedaten
/etc/Systemkonfiguration
~/.git-credentialsGit-Anmeldeinformationsspeicher

Benutzerdefinierte Schutzregeln

Sie können benutzerdefinierte Schutzregeln in der Konfiguration hinzufügen:

Zugriffsregeln für Konfigurationsdateien

[sandbox]
# 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

[network]
# 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

[sandbox]
# 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

[Befehle]
# Whitelist-Modus
whitelist_enabled = true
allowed_commands = [
    "git",
    "npm",
    "node",
    "python",
    "cargo"
]

Blacklist-Modus

Ausführung bestimmter Befehle verbieten:

Befehl-Blacklist

[Befehle]
# 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

[sensitive]
# 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

[audit]
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

# Letzte Audit-Logs 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.

Weitere Erweiterungen