analyzing-malicious-pdf-with-peepdf について
peepdf と関連ツールで不審な PDF を調べるための、セキュリティ分析者向けスキルガイドです。悪意あるオブジェクトの特定、内容の抽出、JavaScript の分析、IOC の整理を扱います。
主な機能
- 01不審な PDF キーワードの検索
- 02PDF オブジェクトの対話的な確認
- 03ストリームの抽出とデコード
- 04埋め込み JavaScript の分析
- 05脅威 IOC の整理
活用シーン
- 01フィッシングメールの PDF 添付ファイルのトリアージ
- 02PDF 形式のエクスプロイト文書の分析
- 03PDF からのスクリプトやファイルの抽出
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mukul975/ anthropic-cybersecurity-skills --skill analyzing-malicious-pdf-with-peepdfインストール後、Claude Code で/analyzing-malicious-pdf-with-peepdfを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEreferences/api-reference.mdscripts/agent.py詳細
peepdf を使用した悪意のある PDF の分析
使用する場面
- フィッシングメールに添付された不審な PDF をトリアージするとき
- PDF ベースのエクスプロイト文書をマルウェア分析するとき
- PDF から埋め込み JavaScript、シェルコード、または実行ファイルを抽出するとき
- 兵器化されたドキュメントの痕跡をフォレンジック調査するとき
- PDF ベースの脅威を検出するシグネチャを作成するとき
前提条件
- peepdf-3 をインストールした Python 3.8 以降(pip install peepdf-3)
- Didier Stevens suite の pdfid.py および pdf-parser.py
- 隔離された分析環境(VM またはサンドボックス)
- オプション:peepdf 内での JavaScript エミュレーション用 PyV8
- オプション:シェルコード分析用 Pylibemu
ワークフロー
- pdfid でトリアージ:PDF をスキャンし、不審なキーワード(/JS、/JavaScript、/OpenAction、/Launch、/EmbeddedFile)を確認します。
- 対話型分析:PDF を peepdf の対話型モードで開き、オブジェクト構造を調査します。
- 不審なオブジェクトの特定:JavaScript、ストリーム、またはエンコードされたデータを含むオブジェクトを探します。
- コンテンツの抽出:不審なストリームをダンプし、フィルター(FlateDecode、ASCIIHexDecode)をデコードします。
- JavaScript の難読化解除:抽出した JS を分析し、シェルコード、ヒープスプレー、またはエクスプロイトコードを調べます。
- VirusTotal の確認:peepdf vtcheck を使用して、ファイルハッシュを AV 検出結果と照合します。
- IOC の生成:URL、ドメイン、ハッシュ、シェルコードのシグネチャを抽出します。
主な概念
| 概念 | 説明 |
|---|---|
| /OpenAction | PDF を開いたときに実行される自動アクション |
| /JavaScript /JS | PDF オブジェクトに埋め込まれた JavaScript コード |
| /Launch | 外部アプリケーションを起動するアクション |
| /EmbeddedFile | PDF 構造内に埋め込まれたファイル |
| FlateDecode | コンテンツを隠すために使用される zlib 圧縮フィルター |
| Object Streams | 圧縮ストリームに格納された PDF オブジェクト |
ツールとシステム
| ツール | 用途 |
|---|---|
| peepdf / peepdf-3 | JS エミュレーションを備えた対話型 PDF 分析 |
| pdfid.py | 不審なキーワードを素早くスキャンしてトリアージ |
| pdf-parser.py | PDF の深いオブジェクトレベル解析 |
| VirusTotal | ハッシュ検索と AV 検出結果の照合 |
| CyberChef | 抽出したペイロードのデコードと変換 |
出力形式
Analysis Report: PDF-MAL-[DATE]-[SEQ]
File: [filename.pdf]
SHA-256: [hash]
Suspicious Keywords: [/JS, /OpenAction, etc.]
Objects with JavaScript: [Object IDs]
Extracted URLs: [List]
Shellcode Detected: [Yes/No]
Embedded Files: [Count and types]
VirusTotal Detections: [X/Y engines]
Risk Level: [Critical/High/Medium/Low]
コメント
Markdown 対応