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

$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]. Do not test public or production systems.

Codex は提供された資料の一覧を作成し、同じ根本原因と脆弱な経路を説明するレポートをグループ化して、個別の脆弱性ごとに 1 つのレポートディレクトリを作成します。各ディレクトリには、内容が分かる名前の Markdown レポートと、補足用の PoC ファイルがある場合は poc/ ディレクトリが含まれます。

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

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

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

対象を明示的に指定した許可がない限り、公開環境または本番環境を決してテストしないでください。

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

詳細スキャンまたは変更スキャンに報告対象の調査結果がある場合、Codex は最終報告時に調査結果ごとにこのワークフローを 1 回実行します。標準スキャンでは、詳細レポートは任意です。 Codex が詳細レポートを生成する場合、各レポートを findings/<slug>/<slug>.md に書き込み、補足ファイルを findings/<slug>/poc/ に保存し、report.md からレポートへリンクします。

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