Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Schwachstellenberichte schreiben

Erstelle Schwachstellenberichte und belege die Ergebnisse anhand von Befunden, Offenlegungsnotizen, Quellcode und Proofs of Concept.

Mit $codex-security:vulnerability-writeup erstellst du für jede einzelne Schwachstelle einen eigenständigen Bericht. Du kannst von den Ergebnissen eines Scans mit Codex Security ausgehen oder direkt mit den bereitgestellten Befunden, Offenlegungsnotizen, Proofs of Concept (PoCs) und dem Quellcode arbeiten. Ein Scan mit Codex Security ist optional.

Belege vorbereiten

Stelle dem Workflow folgende Unterlagen zur Verfügung:

  • Befunde, Offenlegungsnotizen oder Prüfberichte, die Codex prüfen soll.
  • Den zu untersuchenden Quellcodebaum und die betroffene Revision oder Release-Version.
  • Vorhandene PoCs, Logs, Traces, Screenshots oder Diagnoseausgaben.
  • Commits oder Diffs mit Fehlerkorrekturen, sofern vorhanden.

Bevor Codex den Bericht schreibt, prüft es jede Aussage anhand des betroffenen Quellcodes. Fehlt der Quellcode oder die betroffene Revision, entscheide, ob Codex trotzdem einen Bericht erstellen soll, in dem es die ungeprüften Aussagen kennzeichnet.

Workflow ausführen

Sende einen Prompt wie diesen:

Erstelle mit $codex-security:vulnerability-writeup für jede einzelne Schwachstelle in [input paths] einen eigenständigen Bericht. Prüfe die Aussagen anhand von [source path and revision]. Behalte die bereitgestellten PoCs bei oder verbessere sie. Speichere die Berichte in [output directory]. Verwende zum Reproduzieren der Schwachstellen eine lokale Testumgebung.

Codex erfasst das bereitgestellte Material und bündelt Berichte, die dieselbe Fehlerursache und denselben verwundbaren Codepfad beschreiben. Für jede einzelne Schwachstelle legt Codex ein Berichtsverzeichnis an. Jedes Verzeichnis enthält einen Markdown-Bericht. Sind zugehörige PoC-Dateien vorhanden, enthält es außerdem das Verzeichnis poc/.

Jeden Bericht prüfen

Prüfe vor der Weitergabe, ob der Bericht die folgenden Anforderungen erfüllt:

  • Er zeichnet den Fehler vom Einstiegspunkt aus nach, den die angreifende Person kontrolliert, und zeigt, welche Sicherheitsinvariante der Fehler verletzt und welche Folgen das hat.
  • Er unterscheidet zwischen nachgewiesenem Verhalten, Hypothesen und noch ungeklärten Einschränkungen.
  • Er enthält Quellcodeauszüge mit Angaben zu Pfaden, Funktionen und der betroffenen Revision.
  • Wenn ein PoC praktikabel ist, enthält der Bericht dessen Quellcode, eine Anleitung zum Kompilieren oder Ausführen, eine repräsentative Ausgabe und Hinweise zu sicherheitsbedingten Einschränkungen.
  • Er verwendet portable Pfade und ist weder auf interne Speicherorte noch auf lokale absolute Pfade angewiesen.

Berichte aus einem Scan verwenden

Bei Standardscans, vertieften Scans und Scans von Änderungen sind ausführliche Schwachstellenberichte optional. Wenn du sie anforderst, schreibt Codex jeden Bericht nach findings/<slug>/<slug>.md, legt die zugehörigen Dateien unter findings/<slug>/poc/ ab und verlinkt den Bericht in report.md.

Wenn du einen Scan weitergibst oder archivierst, halte das gesamte Scanverzeichnis zusammen. Wenn du nach Verbesserungen suchst, die wiederkehrende Schwachstellenmuster in mehreren Berichten aufgreifen, lies weiter im Abschnitt Maßnahmen zur Sicherheitshärtung vorschlagen.