Rédiger des rapports de vulnérabilité

Utilisez $codex-security:vulnerability-writeup pour créer un rapport autonome pour chaque vulnérabilité distincte. Vous pouvez partir des résultats d’une analyse Codex Security ou utiliser directement les constats, les notes de divulgation, les PoC et le code source fournis. Une analyse Codex Security n’est pas requise.

Préparer les preuves

Fournissez au workflow :

• Les constats, notes de divulgation ou documents d’évaluation à examiner.
• L’arborescence du code source cible et la révision ou version concernée.
• Les PoC, journaux, traces, captures d’écran ou sorties de diagnostic existants.
• Les commits ou diffs correctifs, le cas échéant.

Codex vérifie chaque affirmation dans le code source concerné avant de rédiger le rapport. Si le code source ou la révision concernée n’est pas disponible, décidez si vous souhaitez poursuivre avec un rapport qui signale les affirmations non vérifiées.

Exécuter le workflow

Envoyez une requête comme celle-ci :

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 dresse l’inventaire des éléments fournis, regroupe les rapports qui décrivent la même cause racine et le même chemin vulnérable, puis crée un répertoire de rapport pour chaque vulnérabilité distincte. Chaque répertoire contient un rapport Markdown et un répertoire poc/ lorsque des fichiers de PoC complémentaires sont disponibles.

Examiner chaque rapport

Avant de diffuser un rapport, vérifiez qu’il :

• Retrace le bug depuis le point d’entrée contrôlé par l’attaquant jusqu’à l’invariant de sécurité violé et aux conséquences.
• Distingue les comportements vérifiés des hypothèses et des contraintes non résolues.
• Inclut des extraits du code source avec les chemins, les fonctions et la révision concernée.
• Inclut le code source du PoC, les instructions de compilation ou d’exécution, des exemples de sortie et les limites de sécurité lorsqu’un PoC est réalisable.
• Utilise des chemins portables et ne dépend pas d’un stockage interne ni de chemins absolus locaux.

Utiliser les rapports issus d’une analyse

Les rapports de vulnérabilités détaillés sont facultatifs pour les analyses standard, approfondies et de modifications. Lorsque vous les demandez, Codex écrit chaque rapport dans findings/<slug>/<slug>.md, stocke les fichiers justificatifs sous findings/<slug>/poc/ et ajoute un lien vers le rapport depuis report.md.

Conservez l’intégralité du répertoire d’analyse lors du partage ou de l’archivage d’une analyse. Pour rechercher des améliorations qui traitent des schémas communs à plusieurs rapports, poursuivez avec Proposer un renforcement de la sécurité.