ChatGPT-Dokumentation
Deutsch
Kontakt goolvyouyou@gmail.com

Einen umfassenden Sicherheitsscan ausführen

Führen Sie wiederholte Sicherheitsprüfungen eines Repositorys oder Ordners durch und legen Sie Grenzen für Parallelität und Dauer fest.

Ein tiefgehender Scan führt mehrere unabhängige Standardscans desselben Repositorys oder Ordners aus und führt deren Befunde zusammen. Verwenden Sie ihn, wenn Sie eine wiederholte Prüfung wünschen und die zusätzliche Laufzeit und den höheren Tokenverbrauch einplanen können.

Beginnen Sie mit einem Standardscan, um zu prüfen, ob Umfang und Sicherheitskontext Ihrem Ziel entsprechen. Wiederholte Prüfungen können Probleme aufdecken, die ein früherer Durchlauf übersehen hat, garantieren jedoch weder eine vollständige Erkennung noch identische Ergebnisse bei verschiedenen Durchläufen.

Zwischen Standardscans und umfassenden Scans wählen

Standardscan Tiefgehender Scan
Prüfung Ein Standardscan Mehrere Standardscans mit zusammengeführten Befunden
Verwendung Ein erster Scan oder die Prüfung eines definierten Umfangs Zusätzliche unabhängige Prüfungen dieses Umfangs
Umfang Repository oder Ordner Repository oder Ordner
Änderungen Workflow zur Prüfung von Änderungen verwenden Nicht unterstützt

Den tiefgehenden Scan starten

Verwenden Sie für die beste Scanqualität gpt-5.6-sol mit dem Reasoning-Aufwand xhigh.

  1. Öffnen Sie Sicherheit > Scans und wählen Sie + Scan.
  2. Wählen Sie ein Repository oder einen Ordner, wählen Sie Codebasis und aktivieren Sie Tiefgehender Scan. Der Scan prüft das gesamte ausgewählte Repository oder den gesamten ausgewählten Ordner.
  3. Wählen Sie das Modell und den Reasoning-Aufwand. Ergänzen Sie unter Zusätzlicher Kontext Angaben zum Bedrohungsmodell oder zur Bereitstellung.
  4. Wählen Sie Scan starten.

Sie können ihn auch aus einer Codex-Unterhaltung heraus starten:

Use $codex-security:deep-security-scan to run a deep security scan of this repository.

Für eine einzelne Komponente ersetzen Sie „this repository“ durch den Pfad zu ihrem Ordner.

Worker für Tiefenscans übernehmen Ihre gewählten Modell- und Reasoning-Einstellungen. Jeder Worker führt einen vollständigen Standardscan aus, und Codex Security fasst die abgeschlossenen Ergebnisse zusammen. Verfolgen Sie den gespeicherten Scan unter Scans, oder wählen Sie Aktivität anzeigen, um seine Codex-Aufgabe zu prüfen. Legen Sie vor dem Start Laufzeitlimits fest, wenn Sie die Parallelität oder Dauer begrenzen müssen.

Verfolgen Sie die aktive Phase des Tiefenscans und prüfen Sie seine Codex-Aktivität, bevor Sie das abgeschlossene Ergebnis prüfen.

Ergebnis prüfen

Tiefenscans verwenden dieselben gespeicherten Scandetails und dasselbe vollständige Scanverzeichnis wie Standardscans. Öffnen Sie den abgeschlossenen Scan unter Scans, oder prüfen Sie seine Befunde unter Befunde. Die generierte Datei report.md verlinkt auf detaillierte Schwachstellenberichte oder Hinweise zur strukturellen Härtung, wenn Sie diese Ausgaben anfordern. Bewahren Sie alle verlinkten Verzeichnisse findings/ und hardening/ zusammen mit dem Bericht auf, wenn Sie das Ergebnis weitergeben oder archivieren.

Prüfen Sie die Abdeckungsübersicht vor den Befunden. Auch ein Tiefenscan hat Grenzen. Prüfen Sie daher zurückgestellte Bereiche und verbleibende Nachweislücken, bevor Sie eine Schlussfolgerung ziehen. Fahren Sie bei einem akzeptierten Befund mit Befund beheben und verifizieren fort.

Um einen Pull Request, Commit, Branch-Bereich oder lokalen Patch zu prüfen, verwenden Sie Codeänderungen prüfen. Tiefenscans akzeptieren keine Diff-Ziele.

Laufzeit eines umfassenden Scans konfigurieren

Um die Parallelität und Dauer eines umfassenden Scans zu steuern, erstellen oder bearbeiten Sie ~/.codex/codex-security/config.toml. Wenn Sie CODEX_HOME festlegen, verwenden Sie stattdessen $CODEX_HOME/codex-security/config.toml.

Dieses Profil führt beispielsweise einen kürzeren Scan mit begrenzter Parallelität aus:

[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5
Einstellung Standardwert Beschreibung
workers 4 Anzahl unabhängiger Standard-Scan-Worker, die gleichzeitig ausgeführt werden dürfen. Der veraltete Wert "auto" wird ebenfalls als 4 aufgelöst.
subagents 3 Anzahl der Subagenten, die jeder Worker starten darf. Legen Sie 0 fest, um sie zu deaktivieren.
stop_after_no_new 4 Beendet den Vorgang, nachdem diese Anzahl aufeinanderfolgender abgeschlossener Worker-Scans keine neuen Befunde ergeben hat.
stop_after_consecutive_errors 3 Beendet den Vorgang nach dieser Anzahl aufeinanderfolgender Worker-Fehler.
max_discovery_runs 40 Begrenzt die Anzahl unabhängiger Standard-Scan-Durchläufe vor der Aggregation.
max_time_hours 96 Begrenzt die Ausführungszeit der Worker auf eine positive Stundenzahl bis 96; verwenden Sie bei Bedarf Bruchteile.

Niedrigere Werte können die Scanzeit und Token-Nutzung reduzieren, dabei jedoch Befunde übersehen. Konfigurationsänderungen gelten für neue umfassende Scans, nicht für bereits laufende Scans.

Wenn das Zeitlimit abläuft, stoppt Codex Security nicht abgeschlossene Worker, behält die Ergebnisse abgeschlossener Scans bei und aggregiert sie im Abschlussbericht. Wenn vor Ablauf der Frist kein Worker die Quellcodeprüfung abschließt, weist der Bericht eine teilweise Abdeckung aus.

Die Einstellung max_time_hours erfordert Plugin-Version 0.1.19 oder neuer. Einzelheiten zur Veröffentlichung finden Sie im Plugin-Änderungsprotokoll.