Schwachstellenberichte verfassen
Erstellen Sie evidenzbasierte, eigenständige Berichte für einzelne Schwachstellen.
Verwenden Sie $codex-security:vulnerability-writeup, um für jede einzelne Schwachstelle einen eigenständigen Bericht
zu erstellen. Sie können mit den Ergebnissen eines Codex Security-Scans beginnen
oder bereitgestellte Erkenntnisse, Offenlegungshinweise, PoCs und Quellcode direkt verwenden. Ein
Codex Security-Scan ist nicht erforderlich.
Evidenz vorbereiten
Stellen Sie dem Workflow Folgendes bereit:
- Die zu prüfenden Befunde, Offenlegungshinweise oder Bewertungsdokumente.
- Den Zielquellbaum und die betroffene Revision oder Version.
- Vorhandene PoCs, Protokolle, Traces, Screenshots oder Diagnoseausgaben.
- Commits oder Diffs zur Fehlerbehebung, sofern verfügbar.
Codex prüft jede Aussage anhand des betroffenen Quellcodes, bevor es den Bericht schreibt. Falls der Quellcode oder die betroffene Revision nicht verfügbar ist, entscheiden Sie, ob Sie mit einem Bericht fortfahren möchten, der die ungeprüften Aussagen kennzeichnet.
Workflow ausführen
Senden Sie einen Prompt wie diesen:
Use $codex-security:vulnerability-writeup to create one self-contained report for each distinct vulnerability in [input paths]. Verify the claims against [source path and revision], preserve or improve the supplied PoCs, and write the reports to [output directory]. Use a local test environment for reproductions.Codex erfasst das bereitgestellte Material, gruppiert Berichte, die dieselbe
Grundursache und denselben verwundbaren Codepfad beschreiben, und erstellt für jede eigenständige
Schwachstelle ein Berichtsverzeichnis. Jedes Verzeichnis enthält einen Markdown-Bericht
und ein poc/-Verzeichnis, wenn ergänzende PoC-Dateien verfügbar sind.
Jeden Bericht prüfen
Prüfen Sie vor dem Weitergeben eines Berichts die folgenden Punkte:
- Er verfolgt den Fehler vom durch Angreifer kontrollierten Einstiegspunkt bis zur verletzten Sicherheitsinvariante und den Auswirkungen.
- Er unterscheidet verifiziertes Verhalten von Hypothesen und ungeklärten Einschränkungen.
- Er enthält Quellcodeauszüge mit Pfaden, Funktionen und der betroffenen Revision.
- Er enthält PoC-Quellcode, Build- oder Ausführungsanweisungen, repräsentative Ausgaben und Sicherheitseinschränkungen, sofern ein PoC praktikabel ist.
- Er verwendet portable Pfade und ist nicht von internem Speicher oder lokalen absoluten Pfaden abhängig.
Berichte aus einem Scan verwenden
Ausführliche Schwachstellenberichte sind bei Standard-, Tiefen- und Änderungs-
Scans optional. Wenn Sie diese anfordern, schreibt Codex jeden Bericht nach
findings/<slug>/<slug>.md, speichert unterstützende Dateien unter
findings/<slug>/poc/ und verlinkt den Bericht aus report.md.
Bewahren Sie beim Teilen oder Archivieren eines Scans das vollständige Scan-Verzeichnis zusammen auf. Um nach Verbesserungen zu suchen, die wiederkehrende Muster in den Berichten beheben, fahren Sie mit Sicherheitshärtung vorschlagen fort.