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

Sicherheitsbefunde im Backlog priorisieren

Prüfe bestehende Sicherheitsbefunde anhand eines Repositorys und lege fest, welche du zuerst bearbeitest.

Mit $codex-security:triage-finding prüfst du bestehende Sicherheitsbefunde anhand des aktuellen Repositorys. Die statische Analyse erfolgt ohne Schreibzugriff. Codex behandelt jeden Befund zunächst als unbestätigt und prüft die Belege im Repository, ohne den Code auszuführen.

Starte die Triage in einem Codex-Projekt, dessen Arbeitsbereich auf das Repository beschränkt ist, das du prüfen möchtest. Codex benötigt Lesezugriff auf den Quellcode im Repository. Die Konnektoren für Jira und Linear können die Daten zu den Befunden liefern. Für Befunde aus GitHub ist ein authentifizierter Zugriff auf die REST-API von GitHub erforderlich. In beiden Fällen braucht Codex zusätzlich Zugriff auf den Quellcode.

Bei $codex-security:validation hingegen kann Codex Code kompilieren oder ausführen, einen Test oder einen Proof of Concept erstellen oder eine reale Schnittstelle aufrufen, um einen Befund zu reproduzieren oder zu widerlegen. Nutze die Triage, um Befunde in einem bestehenden Backlog einzustufen und zu priorisieren. Nutze die Validierung, wenn die statische Analyse keine eindeutige Bewertung zulässt und eine Prüfung zur Laufzeit Klarheit schaffen könnte.

Die Backlog-Triage geht von bestehenden Befunden aus. Um das Repository nach neuen Schwachstellen zu durchsuchen, starte einen Sicherheitsscan. Bei der Triage ändert Codex das Repository nicht und behebt keine Schwachstellen.

Befunde für die Triage auswählen

Du kannst einen einzelnen Befund oder mehrere Befunde aus folgenden Quellen angeben:

Quelle Was du angeben kannst Voraussetzungen
Eingefügte oder lokal gespeicherte Befunde SARIF-Ergebnisse, einen CVE- oder GHSA-Eintrag, eine Sicherheitsmeldung, ein Ticket aus einem Schwachstellenscanner, einen Bug-Bounty-Bericht, ein Befundartefakt von Codex Security oder eine in eigenen Worten beschriebene mögliche Schwachstelle. Kein Konnektor erforderlich.
Jira oder Linear Genaue URLs oder Kennungen von Tickets zu Sicherheitsfragen oder Schwachstellen, eine JQL-Abfrage für Jira oder ein Team, ein Projekt oder einen Suchbegriff für Linear. Codex ruft die Inhalte der ausgewählten Tickets vor der Triage ab. Lesezugriff über Jira mit Atlassian Rovo oder Linear.
GitHub Ein Repository und die gewünschte Quelle für die Befunde: Codescans, von Dependabot gemeldete Schwachstellen und Malware, Sicherheitsmeldungen und vertrauliche Schwachstellenberichte oder alle Quellen. Wenn du kein Repository angibst, verwendet Codex das mit dem aktuellen Codex-Projekt verknüpfte GitHub-Repository, sofern eines vorhanden ist. GitHub-Issues sind standardmäßig ausgenommen. Gib ein bestimmtes Issue an oder fordere Codex ausdrücklich auf, GitHub-Issues einzubeziehen. Authentifizierter Zugriff auf die REST-API von GitHub, etwa über gh auth token, GH_TOKEN oder GITHUB_TOKEN, mit Leseberechtigung für das ausgewählte Repository und den jeweiligen Befundtyp.

Codex gibt für jeden übermittelten Befund genau ein Ergebnis aus und behält die Reihenfolge der Eingabe bei. So kannst du jedes Ergebnis dem ursprünglichen Befund zuordnen. Auch bei vermeintlichen Duplikaten führt Codex keine Befunde zusammen und lässt keine aus.

Triage ohne Schreibzugriff durchführen

Für eingefügte Befunde oder lokale Artefakte kannst du folgenden Prompt verwenden:

Prüfe die folgenden bestehenden Sicherheitsbefunde mit $codex-security:triage-finding anhand dieses Repositorys. Stufe sie ein und priorisiere sie.

[Paste the findings or provide the artifact path.]

Gib bei Jira oder Linear an, welche Tickets Codex prüfen soll. Lass Codex ohne Schreibzugriff auf das Quellsystem arbeiten:

Importiere mit $codex-security:triage-finding die Sicherheitsbefunde aus [Jira or Linear issue URLs, identifiers, or query]. Stufe die Befunde anhand dieses Repositorys ein und priorisiere sie.
Ändere die ursprünglichen Tickets nicht.

Gib bei GitHub-Befunden das Repository und die Quelle an:

Importiere mit $codex-security:triage-finding die Befunde zu [code scanning, Dependabot vulnerabilities and malware, security advisories and private vulnerability reports, or all] aus [owner/repository]. Stufe die Befunde anhand dieses Repositorys ein und priorisiere sie.

Wenn du das mit dem aktuellen Codex-Projekt verknüpfte GitHub-Repository verwenden möchtest, genügt die Angabe der Befundquelle:

Importiere mit $codex-security:triage-finding die Befunde zu [code scanning, Dependabot vulnerabilities and malware, security advisories and private vulnerability reports, or all] aus GitHub. Stufe die Befunde anhand dieses Repositorys ein und priorisiere sie. Verwende das GitHub-Repository, das mit dem aktuellen Codex-Projekt verknüpft ist.

Codex prüft den aktuellen Quellcode und die geltende Richtlinie in SECURITY.md. Anschließend stuft Codex jeden übermittelten Befund ein und dokumentiert, welche Belege dafür oder dagegen sprechen und welche Fragen offenbleiben.

Ergebnisse prüfen

Einstufung Bedeutung
confirmed Die Belege im Repository zeigen, dass der anfällige Codepfad unter den angegebenen Voraussetzungen erreichbar ist und eine unterstützte Sicherheitsgrenze überschreitet.
not_actionable Die Belege im Repository schließen die gemeldete Schwachstelle aus. Beispielsweise ist die verwendete Version nicht betroffen, der Codepfad unerreichbar, eine Schutzmaßnahme wirksam oder die betroffene Funktion nicht Teil der ausgelieferten Software.
needs_review Die Belege im Repository reichen für eine Entscheidung nicht aus. Erforderliche Informationen fehlen, sind mehrdeutig oder hängen vom Verhalten zur Laufzeit, von der Umgebung oder von einer Richtlinie ab.

Entscheide anhand der Priorisierung, welche Befunde mit confirmed du zuerst behebst und welche mit needs_review du zuerst untersuchst. Codex priorisiert die Befunde innerhalb jeder Gruppe separat.

Lies die Begründung der Einstufung zusammen mit dem betroffenen Code und den Voraussetzungen für einen Angriff. Prüfe, ob die Belege den Befund stützen und welche Fragen noch offen sind, bevor du dich bei der Bearbeitung an der Priorisierung orientierst. confirmed bedeutet hier, dass die statische Analyse des Repositorys den Befund stützt. Eine Reproduktion in der laufenden Anwendung ist damit nicht belegt.

Einträge in Jira, Linear und anderen Backlogs bleiben unverändert, sofern du Codex nach der Prüfung der Triage-Ergebnisse nicht ausdrücklich mit der Aktualisierung beauftragst.

Nächste Schritte

  • confirmed: Sobald eine Person entschieden hat, dass die Schwachstelle behoben werden soll, nutze $codex-security:fix-finding, um sie zu beheben und die Korrektur zu überprüfen. Bei der Triage stellt Codex die Informationen für die Übergabe so zusammen, dass du sie direkt als Prompt verwenden kannst. Den Skill ruft Codex dabei nicht automatisch auf.

  • needs_review: Wenn sich der fehlende Nachweis durch Ausführen von Code erbringen lässt, nutze $codex-security:validation, um den Befund am laufenden Code zu prüfen. Übernimm aus dem Triage-Ergebnis die Beschreibung der möglichen Schwachstelle, die betroffenen Codestellen, die Voraussetzungen, die Belege aus der statischen Analyse und die noch fehlenden Nachweise:

    Prüfe mit $codex-security:validation den Befund [triage item ID or source ID] aus dem Ergebnis der Backlog-Triage am laufenden Code. Reproduziere oder widerlege den Befund. Dokumentiere, was du getestet hast, und führe auf, was noch unklar ist.

    Anders als bei der Triage kann Codex bei der Validierung Code kompilieren oder ausführen, einen Test oder einen Proof of Concept erstellen oder eine reale Schnittstelle aufrufen. Wie du die Ausführung steuerst, erfährst du in den Genehmigungs- und Sicherheitsrichtlinien für Codex.

  • needs_review: Wenn die Bewertung des Befunds von einer Produktrichtlinie oder den Bedingungen der Bereitstellung abhängt, beantworte die aufgeführten offenen Fragen, bevor du den Code änderst.

  • not_actionable: Bewahre die Belege zusammen mit dem Triage-Ergebnis auf. Codex schließt oder aktualisiert das ursprüngliche Ticket nicht automatisch.

  • Um nach Schwachstellen zu suchen, die im übermittelten Backlog noch nicht erfasst sind, starte einen Sicherheitsscan.