Ein vertiefter Scan prüft dasselbe Repository oder denselben Ordner mit mehreren unabhängigen Standardscans und führt deren Befunde zusammen. Nutze ihn, wenn du den Code mehrfach prüfen möchtest und die zusätzliche Laufzeit und den höheren Tokenverbrauch einplanen kannst.
Beginne mit einem Standardscan, um zu prüfen, ob Prüfumfang und Sicherheitskontext zu deinem Ziel passen. Weitere Durchläufe können Probleme aufdecken, die bei einer früheren Prüfung unentdeckt geblieben sind. Es gibt jedoch keine Garantie dafür, dass die Scans alle Probleme finden oder jedes Mal dieselben Ergebnisse liefern.
Zwischen Standardscan und vertieftem Scan wählen
| Standardscan | Vertiefter Scan | |
|---|---|---|
| Prüfung | Ein Standardscan | Mehrere Standardscans, deren Befunde zusammengeführt werden |
| Einsatzzweck | Erster Scan oder Prüfung eines festgelegten Bereichs | Weitere unabhängige Prüfungen desselben Bereichs |
| Prüfumfang | Repository oder Ordner | Repository oder Ordner |
| Änderungen | Nutze den Workflow zur Prüfung von Codeänderungen | Nicht unterstützt |
Vertieften Scan starten
Für die beste Scanqualität verwende gpt-5.6-sol mit dem Reasoning-Aufwand xhigh.
- Öffne Sicherheit > Scans und wähle + Scan.
- Wähle ein Repository oder einen Ordner aus, wähle Codebasis und aktiviere Vertiefter Scan. Der Scan prüft das gesamte ausgewählte Repository oder den gesamten ausgewählten Ordner.
- Wähle das Modell und den Reasoning-Aufwand. Ergänze unter Zusätzlicher Kontext Angaben zum Bedrohungsmodell oder zur Bereitstellung.
- Wähle Scan starten.
Du kannst den Scan auch in einem Codex-Chat starten:
Nutze $codex-security:deep-security-scan, um dieses Repository auf Sicherheitsprobleme zu prüfen.
Wenn du nur eine Komponente prüfen möchtest, ersetze „dieses Repository“ durch den Pfad zu ihrem Ordner.
Die Worker eines vertieften Scans übernehmen deine Einstellungen für Modell und Reasoning-Aufwand. Jeder Worker führt einen vollständigen Standardscan aus. Codex Security führt die Ergebnisse der abgeschlossenen Scans zusammen. Unter Scans kannst du den gespeicherten Scan verfolgen. Wähle Aktivität anzeigen, um die zugehörige Codex-Aufgabe einzusehen. Lege vor dem Start Laufzeitgrenzen fest, wenn du die Anzahl paralleler Prüfungen oder die Dauer begrenzen möchtest.
Verfolge die aktuelle Phase des vertieften Scans und sieh dir die zugehörige Codex-Aktivität an, bevor du das Endergebnis prüfst.
Ergebnis prüfen
Der Scan ist erst abgeschlossen, wenn die Abschlussverarbeitung erfolgreich war und report.md erzeugt hat. Weder die Meldung, dass die Ergebnisse zusammengeführt wurden, noch das Vorhandensein der Datei scan-manifest.json reicht als Nachweis aus.
Vertiefte Scans verwenden dieselben gespeicherten Scaninformationen und dasselbe vollständige Scanverzeichnis wie Standardscans. Öffne den abgeschlossenen Scan unter Scans oder sieh dir seine Befunde unter Befunde an. Wenn du detaillierte Schwachstellenberichte oder Empfehlungen zur strukturellen Härtung anforderst, enthält die erzeugte Datei report.md Links darauf. Wenn du das Ergebnis weitergibst oder archivierst, bewahre die verlinkten Verzeichnisse findings/ und hardening/ zusammen mit dem Bericht auf.
Lies zuerst die Zusammenfassung der Prüfabdeckung und dann die Befunde. Auch ein vertiefter Scan hat Grenzen. Prüfe daher, welche Bereiche zurückgestellt wurden und wo Nachweise fehlen, bevor du Schlüsse ziehst. Wenn du einen Befund akzeptierst, folge der Anleitung Einen Befund beheben und die Behebung überprüfen.
Wenn du einen Pull Request, einen Commit, einen Commit-Bereich zwischen Branches oder einen lokalen Patch prüfen möchtest, folge der Anleitung Codeänderungen prüfen. Vertiefte Scans unterstützen keine Diffs als Prüfziel.
Laufzeit des vertieften Scans konfigurieren
Um die Anzahl paralleler Prüfungen und die Dauer eines vertieften Scans zu steuern, erstelle oder bearbeite die Datei ~/.codex/codex-security/config.toml. Wenn du CODEX_HOME gesetzt hast, verwende stattdessen $CODEX_HOME/codex-security/config.toml.
Mit diesem Beispielprofil läuft der Scan kürzer und führt weniger Prüfungen gleichzeitig 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 der unabhängigen Worker, die gleichzeitig Standardscans ausführen dürfen. Der frühere Wert "auto" entspricht ebenfalls 4. |
subagents |
3 |
Anzahl der Subagenten, die jeder Worker starten darf. Mit 0 deaktivierst du sie. |
stop_after_no_new |
4 |
Beendet den Scan, sobald die angegebene Anzahl aufeinanderfolgender Worker-Scans ohne neue Befunde abgeschlossen ist. |
stop_after_consecutive_errors |
3 |
Beendet den Scan nach der angegebenen Anzahl aufeinanderfolgender Worker-Fehler. |
max_discovery_runs |
40 |
Begrenzt die Anzahl unabhängiger Standardscans, bevor Codex Security die Ergebnisse zusammenführt. |
max_time_hours |
96 |
Begrenzt die Laufzeit der Worker in Stunden. Gib einen positiven Wert bis einschließlich 96 an. Auch Bruchteile einer Stunde sind möglich. |
Niedrigere Werte können die Scanzeit verkürzen und den Tokenverbrauch senken. Dabei können Befunde unentdeckt bleiben. Änderungen an der Konfiguration gelten nur für neue vertiefte Scans. Bereits laufende Scans behalten ihre Einstellungen.
Wenn das Zeitlimit erreicht ist, stoppt Codex Security die noch laufenden Worker, behält die Ergebnisse der abgeschlossenen Scans und führt sie im Abschlussbericht zusammen. Hat bis dahin kein Worker die Prüfung des Quellcodes abgeschlossen, vermerkt der Bericht, dass der Code nur teilweise geprüft wurde.
Die Einstellung max_time_hours setzt die Plugin-Version 0.1.19 oder höher voraus. Details zu den einzelnen Versionen findest du im Changelog des Plugins.
Bei einer Unterbrechung oder einem Fehler vorgehen
Prüfe den Status des gespeicherten Scans, bevor du einen weiteren startest. Öffne dazu in der Desktop-App den Scan unter Scans. In einem Codex-Chat kannst du Codex bitten, den bestehenden Scan zu prüfen.
- Wenn die Wartezeit endet, während der Scan noch läuft, kehre zum selben Scan oder Chat zurück und bitte Codex, den Scan fortzusetzen. Der Scan läuft weiter, auch wenn die Antwort endet oder die Wartezeit überschritten wird.
- Wenn der Scan einen endgültigen Fehler meldet oder abgebrochen wurde, bewahre die Fehlermeldung und das gespeicherte Scanverzeichnis auf. Prüfe gespeicherte Befunde getrennt von möglichen Befunden, die noch auf Bestätigung warten. Die Prüfung ist unvollständig. Eine leere Befundliste belegt daher nicht, dass der Code frei von Schwachstellen ist.
Wenn du um Hilfe bittest, gib an, welche Version der Codex CLI oder der Desktop-App und welche Plugin-Version du beim fehlgeschlagenen Scan verwendet hast. Nenne auch den Anbieter, das Modell, den Scanstatus und die genaue Fehlermeldung. Wenn du die Versionen erst nach einem Update prüfst, können sie von den verwendeten Versionen abweichen. Siehe Versionen und Updates prüfen.