mcpField
A
analyzing-malicious-pdf-with-peepdf

analyzing-malicious-pdf-with-peepdf

github.com/mukul975セキュリティ35.2k389 回インストール8 週間前に更新
リポジトリ

analyzing-malicious-pdf-with-peepdf について

peepdf と関連ツールで不審な PDF を調べるための、セキュリティ分析者向けスキルガイドです。悪意あるオブジェクトの特定、内容の抽出、JavaScript の分析、IOC の整理を扱います。

主な機能

  1. 01不審な PDF キーワードの検索
  2. 02PDF オブジェクトの対話的な確認
  3. 03ストリームの抽出とデコード
  4. 04埋め込み JavaScript の分析
  5. 05脅威 IOC の整理

活用シーン

  1. 01フィッシングメールの PDF 添付ファイルのトリアージ
  2. 02PDF 形式のエクスプロイト文書の分析
  3. 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 と一緒にインストールされる参考資料やスクリプト。

LICENSE
references/
api-reference.md
scripts/
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

ワークフロー

  1. pdfid でトリアージ:PDF をスキャンし、不審なキーワード(/JS、/JavaScript、/OpenAction、/Launch、/EmbeddedFile)を確認します。
  2. 対話型分析:PDF を peepdf の対話型モードで開き、オブジェクト構造を調査します。
  3. 不審なオブジェクトの特定:JavaScript、ストリーム、またはエンコードされたデータを含むオブジェクトを探します。
  4. コンテンツの抽出:不審なストリームをダンプし、フィルター(FlateDecode、ASCIIHexDecode)をデコードします。
  5. JavaScript の難読化解除:抽出した JS を分析し、シェルコード、ヒープスプレー、またはエクスプロイトコードを調べます。
  6. VirusTotal の確認:peepdf vtcheck を使用して、ファイルハッシュを AV 検出結果と照合します。
  7. IOC の生成:URL、ドメイン、ハッシュ、シェルコードのシグネチャを抽出します。

主な概念

概念説明
/OpenActionPDF を開いたときに実行される自動アクション
/JavaScript /JSPDF オブジェクトに埋め込まれた JavaScript コード
/Launch外部アプリケーションを起動するアクション
/EmbeddedFilePDF 構造内に埋め込まれたファイル
FlateDecodeコンテンツを隠すために使用される zlib 圧縮フィルター
Object Streams圧縮ストリームに格納された PDF オブジェクト

ツールとシステム

ツール用途
peepdf / peepdf-3JS エミュレーションを備えた対話型 PDF 分析
pdfid.py不審なキーワードを素早くスキャンしてトリアージ
pdf-parser.pyPDF の深いオブジェクトレベル解析
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]

コメント