Communitygithub.com

Análisis de PDF Malicioso con peepdf

Realiza análisis estático de documentos PDF maliciosos utilizando peepdf, pdfid y otras herramientas.

¿Qué es Análisis de PDF Malicioso con peepdf?

Esta habilidad permite a un agente de IA (como Claude Code, Cursor o Codex) analizar de forma estática documentos PDF sospechosos o maliciosos utilizando herramientas como peepdf (o peepdf-3), pdfid.py y pdf-parser.py. Es útil durante el triaje de archivos adjuntos de phishing, el análisis de exploits basados en PDF, la extracción de JavaScript, shellcode o ejecutables incrustados, y la generación de indicadores de compromiso (IOCs). El flujo de trabajo incluye escaneo rápido con pdfid, análisis interactivo con peepdf, identificación de objetos sospechosos (como /OpenAction o /EmbeddedFile), extracción de streams codificados (FlateDecode, ASCIIHexDecode), desofuscación de JavaScript, consulta en VirusTotal y generación de reportes. Funciona en sistemas Linux, macOS y Windows con Python 3.8+, y requiere un entorno aislado (VM o sandbox) para evitar ejecuciones accidentales.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Análisis de PDF Malicioso con peepdf?

Cuándo Usarlo

  • Al triar archivos adjuntos PDF sospechosos de correos de phishing
  • Durante el análisis de malware de documentos PDF con exploits
  • Al extraer JavaScript incrustado, shellcode o ejecutables de PDFs
  • Para examen forense de artefactos de documentos armados
  • Al construir firmas de detección para amenazas basadas en PDF

Prerrequisitos

  • Python 3.8+ con peepdf-3 instalado (pip install peepdf-3)
  • pdfid.py y pdf-parser.py del conjunto de herramientas de Didier Stevens
  • Entorno de análisis aislado (VM o sandbox)
  • Opcional: PyV8 para emulación de JavaScript dentro de peepdf
  • Opcional: Pylibemu para análisis de shellcode

Flujo de Trabajo

  1. Triaje con pdfid: Escanea el PDF en busca de palabras clave sospechosas (/JS, /JavaScript, /OpenAction, /Launch, /EmbeddedFile).
  2. Análisis Interactivo: Abre el PDF en modo interactivo de peepdf para explorar la estructura de objetos.
  3. Identificar Objetos Sospechosos: Localiza objetos que contengan JavaScript, streams o datos codificados.
  4. Extraer Contenido: Vuelca streams sospechosos y decodifica filtros (FlateDecode, ASCIIHexDecode).
  5. Desofuscar JavaScript: Analiza el JS extraído en busca de shellcode, heap sprays o código de exploit.
  6. Consultar VirusTotal: Usa peepdf vtcheck para cotejar el hash del archivo con detecciones de antivirus.
  7. Generar IOCs: Extrae URLs, dominios, hashes y firmas de shellcode.

Conceptos Clave

ConceptoDescripción
/OpenActionAcción automática ejecutada al abrir el PDF
/JavaScript /JSCódigo JavaScript incrustado en objetos PDF
/LaunchAcción que lanza aplicaciones externas
/EmbeddedFileArchivo incrustado dentro de la estructura PDF
FlateDecodeFiltro de compresión zlib usado para ocultar contenido
Object StreamsObjetos PDF almacenados en streams comprimidos

Herramientas y Sistemas

HerramientaPropósito
peepdf / peepdf-3Análisis interactivo de PDF con emulación de JS
pdfid.pyEscaneo rápido de triaje para palabras clave sospechosas
pdf-parser.pyAnálisis profundo a nivel de objetos PDF
VirusTotalConsulta de hash y cotejo con detecciones de antivirus
CyberChefDecodificar y transformar payloads extraídos

Formato de Salida

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,

Skills relacionados