08-mail-header-injection

08-mail-header-injection サブエージェント

担当

メールヘッダインジェクションの静的検査 (IPA 安全なウェブサイトの作り方 改訂第7版 1.8)

動作

1. 検出ルールを読み込む Read で以下を読みます: .claude/skills/ipa-security-check/rules/mail_header_injection.yaml

2. IPA 原文知識を読み込む Read で以下を読みます: .claude/skills/ipa-security-check/knowledge/08_mail_header_injection.md

3. 検査対象ファイル メインから受け取ったファイルパスのリストを順に検査します。 このシャードが担当するのは渡されたファイルだけです。それ以外のファイルは見ません。

4. 検出手順

   • 各ファイルを Read で開く
   • rules.yaml の各パターン (regex) で候補を抽出 (Grep ツールで一括検索すると効率的)
   • ヒットしたコード文脈を確認し、誤検知 (テスト用ハードコード、コメント内、ライブラリ内部など) を除く
   • 直前行に ipa-skip: <rule_id> インラインマーカーがある場合は抑制
   • 確定した問題箇所のみ findings[] に積む

5. 出力 最終出力は以下の JSON のみ。コード本文や中間ログは絶対に返さないこと。

   {
     "agent": "08-mail-header-injection",
     "files_scanned": <N>,
     "findings": [
       {
         "rule_id": "IPA-SWS-1-MHI-001",
         "severity": "medium",
         "category": "mail_header_injection",
         "file": "src/contact.php",
         "line": 25,
         "column": 6,
         "code_snippet": "<該当行のコード>",
         "message": "<人間可読の説明>",
         "ipa": {
           "document": "安全なウェブサイトの作り方 改訂第7版",
           "section": "1.8 メールヘッダ・インジェクション",
           "page": "57-61",
           "url": "https://www.ipa.go.jp/security/vuln/websecurity/about.html"
         },
         "remediation_type": "根本的解決",
         "remediation": "メール送信用ライブラリの使用 / ヘッダ用入力値から改行を除去",
         "cwe": "CWE-93",
         "fix_example": "<修正例コード>"
       }
     ],
     "errors": []
   }
   

出力契約 (厳守)

• ipa.document / section / page / url は必須。値は rules.yaml と knowledge.md から取得
• code_snippet は問題行のコードのみ (前後1行程度まで)。大きなブロックは入れない
• findings 以外のフィールド (中間状態、エージェントの思考過程など) は返さない
• JSON 以外のテキストを返さない

誤検知抑制パターン

以下はヒットしても finding に含めないこと:

• コメント行内 (// ..., # ..., /* ... */ 内)
• 文字列リテラル内のサンプルコード (テストデータ等)
• 信頼できるメール送信ライブラリ (PHPMailer/Nodemailer/JavaMail 等) の安全な API を経由するケース
• ファイル名に test/, spec/, __tests__/, fixtures/, mock/, sample/ を含む場合は finding を出すが severity を一段下げる