Communitygithub.com

Analyse de PDF malveillants avec peepdf

Effectuer une analyse statique de documents PDF suspects à l'aide de peepdf, pdfid et pdf-parser.

Qu'est-ce que Analyse de PDF malveillants avec peepdf ?

Cette compétence permet aux agents IA d'analyser statiquement des documents PDF potentiellement malveillants. Elle est particulièrement utile lors du triage de pièces jointes d'emails de phishing, de l'analyse de documents PDF contenant des exploits, ou de l'extraction de code JavaScript, de shellcode ou d'exécutables embarqués. Le workflow guide l'agent à travers plusieurs étapes : triage rapide avec pdfid pour détecter des mots-clés suspects comme /JavaScript ou /OpenAction, analyse interactive dans peepdf pour explorer la structure objet, extraction des flux encodés via des filtres comme FlateDecode, désobfuscation du JavaScript, vérification sur VirusTotal, et enfin génération d'IOCs (indicateurs de compromission). Cette compétence est conçue pour fonctionner dans un environnement isolé (VM ou sandbox) et requiert Python 3.8+, peepdf-3, et les outils pdfid/pdf-parser de la suite Didier Stevens, avec des options pour l'émulation JavaScript (PyV8) et l'analyse de shellcode (Pylibemu).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Analyse de PDF malveillants avec peepdf ?

Quand l'utiliser

  • Lors du triage de pièces jointes PDF suspectes provenant d'emails de phishing
  • Pendant l'analyse de logiciels malveillants sur des documents PDF exploitables
  • Lors de l'extraction de JavaScript, shellcode ou exécutables embarqués dans des PDF
  • Pour l'examen forensique d'artefacts de documents militarisés
  • Lors de la création de signatures de détection pour les menaces basées sur les PDF

Prérequis

  • Python 3.8+ avec peepdf-3 installé (pip install peepdf-3)
  • pdfid.py et pdf-parser.py de la suite Didier Stevens
  • Environnement d'analyse isolé (VM ou sandbox)
  • Optionnel : PyV8 pour l'émulation JavaScript dans peepdf
  • Optionnel : Pylibemu pour l'analyse de shellcode

Workflow

  1. Triage avec pdfid : Analyser le PDF pour détecter les mots-clés suspects (/JS, /JavaScript, /OpenAction, /Launch, /EmbeddedFile).
  2. Analyse interactive : Ouvrir le PDF en mode interactif peepdf pour explorer la structure objet.
  3. Identifier les objets suspects : Localiser les objets contenant du JavaScript, des flux ou des données encodées.
  4. Extraire le contenu : Vider les flux suspects et décoder les filtres (FlateDecode, ASCIIHexDecode).
  5. Désobfusquer le JavaScript : Analyser le JS extrait pour détecter du shellcode, des heap sprays ou du code d'exploitation.
  6. Vérifier VirusTotal : Utiliser peepdf vtcheck pour recouper le hash du fichier avec les détections antivirales.
  7. Générer les IOCs : Extraire les URLs, domaines, hashes et signatures de shellcode.

Concepts clés

ConceptDescription
/OpenActionAction automatique exécutée à l'ouverture du PDF
/JavaScript /JSCode JavaScript embarqué dans les objets PDF
/LaunchAction qui lance des applications externes
/EmbeddedFileFichier intégré dans la structure du PDF
FlateDecodeFiltre de compression zlib utilisé pour masquer le contenu
Object StreamsObjets PDF stockés dans des flux compressés

Outils et systèmes

OutilObjectif
peepdf / peepdf-3Analyse interactive de PDF avec émulation JS
pdfid.pyAnalyse rapide pour détection de mots-clés suspects
pdf-parser.pyAnalyse approfondie au niveau objet du PDF
VirusTotalRecherche de hash et recoupement avec les détections AV
CyberChefDécodage et transformation des charges utiles extraites

Format de sortie

Rapport d'analyse : PDF-MAL-[DATE]-[SEQ]
Fichier : [nom_fichier.pdf]
SHA-256 : [hash]
Mots-clés suspects : [/JS, /OpenAction, etc.]
Objets avec JavaScript : [IDs des objets]
URLs extraites : [Liste]
Shellcode détecté : [Oui/Non]
Fichiers embarqués : [Nombre et types]
Détections VirusTotal : [X/Y moteurs]
Niveau de risque : [Critique/Élevé/Moyen/Faible]

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,

Skills associés