Communitygithub.com

peepdfによる悪意のあるPDFの静的解析

peepdf、pdfid、および関連ツールを使用して悪意のあるPDF文書を静的に分析します。

peepdfによる悪意のあるPDFの静的解析 とは?

このスキルは、セキュリティアナリストやマルウェア研究者が、peepdf、pdfid、pdf-parserなどのツールを使って悪意のあるPDF文書を静的解析するためのワークフローを提供します。フィッシングメールの添付ファイルや、エクスプロイトを含むPDFのトリアージから、埋め込まれたJavaScript、シェルコード、実行ファイルの抽出、さらには検知シグネチャの作成までをカバーします。主な機能として、まずpdfidでPDF内の怪しいキーワード(/JS、/OpenAction、/Launchなど)をスキャンし、次にpeepdfの対話モードでオブジェクト構造を調査します。その後、抽出したストリームをデコードし、JavaScriptの難読化解除やウイルス対策エンジンによるハッシュ照合(VirusTotal連携)を実行可能です。このスキルは、Claude Code、Codex、CursorなどのAIエージェント環境を想定しており、隔離された解析環境(VMやサンドボックス)を前提とします。最終的にIoC(URL、ドメイン、ハッシュ、シェルコードシグネチャ)を生成し、標準化された分析レポートを出力します。PyV8やPylibemuといったオプションの拡張機能により、JavaScriptエミュレーションやシェルコード解析も可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/main/skills/analyzing-malicious-pdf-with-peepdf

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

peepdfによる悪意のあるPDFの静的解析 は何をしますか?

使用すべき場面

  • フィッシングメールから疑わしいPDF添付ファイルをトリアージするとき
  • PDFベースのエクスプロイト文書をマルウェア解析するとき
  • PDFに埋め込まれたJavaScript、シェルコード、実行可能ファイルを抽出するとき
  • 武器化された文書アーティファクトをフォレンジック調査するとき
  • PDFベースの脅威に対する検知シグネチャを構築するとき

前提条件

  • Python 3.8以上とpeepdf-3がインストールされていること(pip install peepdf-3)
  • Didier Stevensスイートに含まれるpdfid.pyとpdf-parser.py
  • 隔離された解析環境(VMまたはサンドボックス)
  • 任意: PyV8(peepdf内でのJavaScriptエミュレーション用)
  • 任意: Pylibemu(シェルコード解析用)

ワークフロー

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

主要な概念

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

ツールとシステム

ツール目的
peepdf / peepdf-3JSエミュレーション機能付き対話型PDF解析
pdfid.py怪しいキーワードの高速トリアージスキャン
pdf-parser.py詳細なオブジェクトレベルPDF解析
VirusTotalハッシュ検索とウイルス対策検知の相互参照
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]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

abusing-dpapi-for-credential-access

Extract and decrypt Windows DPAPI-protected secrets (Credential Manager, browser logins/cookies, Wi-Fi credentials, KeePass keys) online or offline using SharpDPAPI, SharpChrome, Mimikatz, or Impacket

abusing-shadow-credentials-for-privesc

Take over Active Directory accounts by writing attacker-controlled public keys to msDS-KeyCredentialLink (Shadow Credentials) with pyWhisker, Whisker, or Certipy, then authenticate via PKINIT to recover the target

achieving-cmmc-level-2-compliance

>-

acquiring-disk-image-with-dd-and-dcfldd

Create forensically sound bit-for-bit disk images with dd or dcfldd on a Linux forensic workstation, preserving evidence integrity through hash verification (MD5/SHA) during acquisition. Use when imaging a suspect drive, USB device, or memory card for investigation, preserving volatile disk evidence during incident response, or producing a verified copy for legal or law-enforcement proceedings before any destructive analysis.

analyzing-active-directory-acl-abuse

Detect dangerous ACL misconfigurations in Active Directory using ldap3

analyzing-android-malware-with-apktool

Perform static analysis of Android APK malware using apktool for resource decompilation, jadx for Java source recovery, and androguard for manifest inspection, dangerous permission-combination detection, and identification of obfuscated code, dynamic code loading, and reflection-based API calls. Use to statically triage a suspicious APK without executing it or to build mobile malware detection rules.

analyzing-api-gateway-access-logs

Parses API Gateway access logs (AWS API Gateway, Kong, Nginx) to detect

analyzing-apt-group-with-mitre-navigator

Query ATT&CK data with attackcti, mitreattack-python, and stix2, then build MITRE ATT&CK Navigator layers and multi-layer heatmap overlays mapping one or more APT groups

analyzing-azure-activity-logs-for-threats

Queries Azure Monitor activity logs and sign-in logs via azure-monitor-query

analyzing-bootkit-and-rootkit-samples

Analyzes bootkit and advanced rootkit malware infecting the Master

analyzing-browser-forensics-with-hindsight

Parse Chromium-based browser databases with Hindsight to extract and correlate browsing history, downloads, cookies, cached content, autofill data, saved passwords, and extensions from Chrome, Edge, Brave, Opera, and Vivaldi into a unified timeline (XLSX, JSON, or SQLite output). Use during incident response, insider-threat investigations, or criminal cases when you need to reconstruct a user

analyzing-campaign-attribution-evidence

Systematically evaluate cyber-campaign evidence to attribute an operation to a threat actor, using the Diamond Model and Analysis of Competing Hypotheses (ACH) to weigh infrastructure overlaps, TTP consistency, malware code similarity, and timing/language artifacts into confidence-weighted attribution assessments. Use when an incident investigation needs a defensible attribution confidence level.

analyzing-certificate-transparency-for-phishing

Monitor Certificate Transparency logs using crt.sh and Certstream to

analyzing-cloud-storage-access-patterns

Detect abnormal access in AWS S3, GCS, and Azure Blob Storage by analyzing CloudTrail Data Events, GCS audit logs, and Azure Storage Analytics for after-hours bulk downloads, new-IP access, and API-call spikes (e.g. GetObject) via statistical baselines and time-series anomaly detection. Use when investigating suspected cloud data exfiltration or building related detection rules.

analyzing-cobalt-strike-beacon-configuration

Extract and analyze Cobalt Strike beacon configuration from PE files

analyzing-cobaltstrike-malleable-c2-profiles

Parse and analyze Cobalt Strike Malleable C2 profiles with dissect.cobaltstrike (profiles and beacon-payload configs) and pyMalleableC2 (AST parsing) to extract HTTP/DNS transforms, URIs, headers, sleep/jitter, and injection behavior, then generate network detection signatures. Use when reverse-engineering a captured malleable profile or building detections against Cobalt Strike Beacon traffic.

analyzing-command-and-control-communication

Analyzes malware C2 communication over HTTP, HTTPS, DNS, and custom

analyzing-cyber-kill-chain

Analyzes intrusion activity against the Lockheed Martin Cyber Kill Chain

analyzing-disk-image-with-autopsy

Perform comprehensive forensic analysis of raw (dd), E01, or AFF disk images with Autopsy and The Sleuth Kit, recovering deleted files, examining metadata and embedded artifacts, keyword searching, and building investigation timelines with visual reports. Use for structured analysis of a forensic disk image or when stakeholders need visual reports from evidence.

analyzing-dns-logs-for-exfiltration

Analyzes DNS query logs to detect data exfiltration via DNS tunneling,

関連スキル