脆弱性レポートを作成する

個別の脆弱性について、証拠に基づく自己完結型のレポートを作成します。

$codex-security:vulnerability-writeup を使用して、個別の脆弱性ごとに自己完結型のレポートを 作成します。Codex Security のスキャン結果から開始することも、提供された調査結果、 開示メモ、PoC、ソースコードを直接使用することもできます。 Codex Security のスキャンは必須ではありません。

証拠を準備する

ワークフローには次の情報を提供します。

  • レビューする検出結果、開示に関するメモ、または評価文書。
  • 対象のソースツリーと、影響を受けるリビジョンまたはリリース。
  • 既存の PoC、ログ、トレース、スクリーンショット、または診断出力。
  • 入手可能な場合は、修正コミットまたは差分。

Codex は、レポートを作成する前に、各主張を影響のあるソースコードと照合して検証します。ソースコードや影響を受けるリビジョンを入手できない場合は、未検証の主張を明示したレポートの作成を進めるかどうかを判断してください。

ワークフローを実行する

次のようなプロンプトを送信します。

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 は提供された資料を一覧化し、同じ根本原因と脆弱な経路を説明するレポートをグループ化して、個別の脆弱性ごとにレポートディレクトリを作成します。各ディレクトリには Markdown レポートが含まれ、補足の PoC ファイルがある場合は poc/ ディレクトリも含まれます。

各レポートをレビューする

レポートを配布する前に、次の点を確認してください。

  • 攻撃者が制御するエントリーポイントから、破られるセキュリティ上の不変条件と影響まで、バグの経路を追跡している。
  • 検証済みの動作と、仮説や未解決の制約を区別している。
  • パス、関数、影響を受けるリビジョンを伴うソースコードの抜粋を含んでいる。
  • PoC が実用的な場合は、PoC のソース、ビルドまたは実行手順、代表的な出力、安全上の制限を含んでいる。
  • 移植可能なパスを使用し、内部ストレージやローカルの絶対パスに依存していない。

スキャンのレポートを使用する

詳細な脆弱性レポートは、標準スキャン、ディープスキャン、変更スキャンでは任意です。リクエストすると、Codex は各レポートを findings/<slug>/<slug>.md に書き込み、補助ファイルを findings/<slug>/poc/ に保存し、report.md からレポートへのリンクを設定します。

スキャンを共有またはアーカイブする場合は、スキャンディレクトリ全体をまとめて保持してください。 レポート全体に共通するパターンへの対策を検討するには、 セキュリティ強化を提案するに進んでください。