Communitygithub.com

análisis-de-malware-macro-en-documentos-de-office

Analiza macros VBA maliciosas incrustadas en documentos de Microsoft Office.

¿Qué es análisis-de-malware-macro-en-documentos-de-office?

Esta habilidad permite a agentes de IA analizar documentos de Microsoft Office sospechosos que contienen macros VBA maliciosas, así como otros vectores de ataque como macros XLM (Excel 4.0), DDE e inyección remota de plantillas. Es útil para analistas de seguridad que investigan campañas de phishing, extraen código VBA ofuscado, identifican URLs de descarga de payloads y comprenden la cadena de ataque completa. La habilidad se basa en herramientas como oletools, oledump.py y XLMDeobfuscator, y proporciona flujos de trabajo detallados para el triaje inicial de documentos, extracción y desofuscación de código VBA, análisis de macros heredadas y generación de informes finales con IOCs y reglas YARA. Es compatible con sistemas Linux/Windows en entornos aislados y utiliza Python 3.8+ para ejecutar los análisis de forma segura sin Microsoft Office.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/main/skills/analyzing-macro-malware-in-office-documents

Preguntar en tu IA favorita

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

Documentación

Análisis de Malware Macro en Documentos de Office

Cuándo Usar

  • Un documento sospechoso de Office (.doc, .docm, .xls, .xlsm, .ppt) ha sido marcado por la seguridad del correo electrónico.
  • Investigar campañas de phishing que entregan documentos de Office armados.
  • Extraer código de macro VBA para identificar la URL de descarga del payload y el método de ejecución.
  • Analizar código VBA ofuscado para comprender la cadena de ataque completa.
  • Determinar si un documento usa DDE, ActiveX o inyección remota de plantillas en lugar de macros.

No usar para analizar amenazas de Office que no son macros (DDE, inyección remota de plantillas); aunque esta habilidad cubre la detección de estos, puede ser necesario un análisis especializado.

Requisitos Previos

  • Python 3.8+ con oletools instalado (pip install oletools)
  • oledump.py de Didier Stevens (https://blog.didierstevens.com/programs/oledump-py/)
  • Máquina virtual de análisis aislada sin Microsoft Office instalado (previene la ejecución accidental)
  • XLMDeobfuscator para análisis de macros de Excel 4.0 (pip install xlmdeobfuscator)
  • LibreOffice para renderizado seguro de documentos (no ejecuta macros VBA por defecto)

Flujo de Trabajo

Paso 1: Triaje Inicial del Documento

Determinar si el documento contiene macros u otro contenido activo:

# Triaje rápido con olevba
olevba suspect.docm

# Verificar flujos OLE y macros
oleid suspect.docm

# Indicadores de salida:
# Macros VBA:        Verdadero/Falso
# Macros XLM:        Verdadero/Falso
# Relaciones Externas: Verdadero/Falso (plantilla remota)
# ObjectPool:        Verdadero/Falso (objetos incrustados)
# Flash:             Verdadero/Falso (objetos SWF)

# Análisis OLE completo
oledump.py suspect.docm

# Listar todos los flujos OLE con indicadores de macro
# Flujos marcados con 'M' contienen macros VBA
# Flujos marcados con 'm' contienen atributos de macro

Paso 2: Extraer y Analizar Código VBA

Extraer la fuente completa de la macro VBA:

# Extraer VBA con desofuscación completa
olevba --decode --deobf suspect.docm

# Extraer solo el código fuente VBA
olevba --code suspect.docm > extracted_vba.txt

# Extracción detallada con oledump
oledump.py -s 8 -v suspect.docm  # Flujo 8 (ajustar según el listado de flujos)

# Extraer todos los flujos de macro
oledump.py -p plugin_vba_dco suspect.docm
Elementos Clave de VBA a Identificar:
━━━━━━━━━━━━━━━━━━━━━━━━━━━
Disparadores de Auto-Ejecución:
  - Auto_Open / AutoOpen (Word)
  - Auto_Close / AutoClose
  - Document_Open / Document_Close
  - Workbook_Open (Excel)
  - AutoExec

Funciones Sospechosas:
  - Shell() / Shell.Application
  - WScript.Shell.Run / Exec
  - CreateObject("WScript.Shell")
  - Ejecución de PowerShell
  - URLDownloadToFile
  - MSXML2.XMLHTTP (peticiones HTTP)
  - ADODB.Stream (escritura de archivos)
  - Environ() (variables de entorno)
  - CallByName (llamadas a métodos indirectas)

Paso 3: Desofuscar Código VBA

Eliminar las capas de ofuscación para revelar el payload:

# Técnicas de desofuscación VBA
import re

def desofuscar_vba(codigo):
    # 1. Resolver llamadas Chr(): Chr(104) & Chr(116) -> "ht"
    def resolver_chr(coincidencia):
        try:
            return chr(int(coincidencia.group(1)))
        except:
            return coincidencia.group(0)
    codigo = re.sub(r'Chr\$?\((\d+)\)', resolver_chr, codigo)

    # 2. Eliminar concatenación de cadenas: "htt" & "p://" -> "http://"
    codigo = re.sub(r'"\s*&\s*"', '', codigo)

    # 3. Resolver llamadas ChrW: ChrW(104)
    codigo = re.sub(r'ChrW\$?\((\d+)\)', resolver_chr, codigo)

    # 4. Resolver StrReverse: StrReverse("exe.daolnwod") -> "download.exe"
    def resolver_reversa(coincidencia):
        return '"' + coincidencia.group(1)[::-1] + '"'
    codigo = re.sub(r'StrReverse\("([^"]+)"\)', resolver_reversa, codigo)

    # 5. Eliminar ofuscación con Mid$/Left$/Right$ (complejo, marcar para revisión manual)

    # 6. Resolver Replace(): Replace("Powxershxell", "x", "")
    def resolver_reemplazar(coincidencia):
        original = coincidencia.group(1)
        buscar = coincidencia.group(2)
        reemplazar_con = coincidencia.group(3)
        return '"' + original.replace(buscar, reemplazar_con) + '"'
    codigo = re.sub(r'Replace\("([^"]+)",\s*"([^"]+)",\s*"([^"]*)"\)', resolver_reemplazar, codigo)

    return codigo

with open("extracted_vba.txt") as f:
    codigo_vba = f.read()

desofuscado = desofuscar_vba(codigo_vba)
print(desofuscado)

Paso 4: Analizar Macros de Excel 4.0 (XLM)

Manejar macros heredadas de Excel que eluden la detección de VBA:

# Detectar macros XLM
olevba --xlm suspect.xlsm

# Desofuscar macros XLM
xlmdeobfuscator -f suspect.xlsm

# Análisis manual de XLM con oledump
oledump.py suspect.xlsm -p plugin_biff.py

# Funciones de macro XLM (Excel 4.0) a vigilar:
# EXEC()       - Ejecutar comando de shell
# CALL()       - Llamar a función DLL
# REGISTER()   - Registrar función DLL
# URLDownloadToFileA - Descargar archivo
# ALERT()      - Mostrar mensaje (ingeniería social)
# HALT()       - Detener ejecución
# GOTO()       - Flujo de control
# IF()         - Ejecución condicional

Paso 5: Verificar Vectores de Ataque Sin Macros

Examinar el documento en busca de DDE, plantillas remotas y objetos incrustados:

# Verificar DDE (Dynamic Data Exchange)
python3 -c "
import zipfile
import xml.etree.ElementTree as ET
import re

z = zipfile.ZipFile('suspect.docx')
for nombre in z.namelist():
    if nombre.endswith('.xml') or nombre.endswith('.rels'):
        contenido = z.read(nombre).decode('utf-8', errors='ignore')
        # Códigos de campo DDE
        if 'DDEAUTO' in contenido or 'DDE ' in contenido:
            print(f'[!] DDE encontrado en {nombre}')
            dde_match = re.findall(r'DDEAUTO[^\"]*\"([^\"]+)\"', contenido)
            for m in dde_match:
                print(f'    Comando: {m}')
        # Plantilla remota
        if 'attachedTemplate' in contenido or 'Target=' in contenido:
            urls = re.findall(r'Target=\"(https?://[^\"]+)\"', contenido)
            for url in urls:
                print(f'[!] URL de plantilla remota: {url}')
"

# Verificar objetos OLE incrustados
oledump.py -p plugin_msg.py suspect.docm

# Verificar relaciones en busca de referencias externas
python3 -c "
import zipfile
z = zipfile.ZipFile('suspect.docx')
for nombre in z.namelist():
    if '.rels' in nombre:
        contenido = z.read(nombre).decode('utf-8', errors='ignore')
        if 'http' in contenido.lower() or 'ftp' in contenido.lower():
            print(f'Referencia externa en {nombre}:')
            import re
            urls = re.findall(r'Target=\\

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