Ir al contenido

Inspección y Diagnóstico de Timelines con pinfo.py

Auditoria interna de arquivos de base de dados Plaso, análise de metadados do caso e extração de resumo operacional antes do filtrado.

0lecturas

pinfo.py (Plaso Info) es una herramienta de diagnóstico y revisión estructural. Su única misión es leer un archivo de base de datos .plaso extraído previamente y mostrar en pantalla de forma resumida los metadatos que contiene.

Este es el primer paso absoluto y obligatorio que todo analista forense debe ejecutar inmediatamente después de haber generado un timeline mediante log2timeline.py. Antes de comenzar a aplicar reglas de filtrado complejas o exports masivos que consumen mucha CPU con psort.py, debes verificar rigurosamente el estado y calidad de la captura de datos realizada.


pinfo.py ahorra decenas de horas de procesamientos fallidos o análisis sobre datos ausentes. Te permite auditar de forma instantánea los siguientes parámetros de salud de la investigación:

  • ✔ Errores de Procesamiento: Listar de forma explícita si algún parser ha lanzado fallos catastróficos (por ejemplo, por culpa de archivos corruptos o firmas ilegibles).
  • ✔ Resumen de Parsers Activos: Confirmar qué analizadores han tenido éxito a la hora de recopilar datos. Si buscas historial de Chrome, pinfo.py te dirá inmediatamente si el parser ha recopilado algún evento o se ha quedado a cero.
  • ✔ Metadatos del Entorno de Destino: Validar la versión del sistema operativo interpretado, la zona horaria inyectada y los rangos temporales generales.
  • ✔ Verificación de Instantáneas (VSS): Confirmar exactamente cuántas copias ocultas del volumen se han analizado correctamente.
  • ✔ Volumen Total de Eventos: Evaluar la cantidad de eventos que forman la base de datos para estimar los tiempos de respuesta de las futuras consultas.

Su invocación es muy directa, solo requiere indicar el camino del archivo .plaso que se desea examinar:

Ventana de terminal
pinfo.py <archivo.plaso>
Ventana de terminal
pinfo.py /opt/forensics/cases/case-001/my_timeline.plaso

Casuística A: Visão Geral do Estado do Caso (Resumo por Padrão)

Sección titulada «Casuística A: Visión General del Estado del Caso (Resumen por Defecto)»

Sem adicionar nenhum parâmetro adicional, a ferramenta fornece um diagnóstico compacto do processamento realizado:

Ventana de terminal
pinfo.py /opt/forensics/cases/case-001/my_timeline.plaso
Plaso Storage File Information
================================
Storage file: my_timeline.plaso
Format version: ...
Serialization format: ...
Processing information
======================
Status: completed
Processing time: 01:32:15
Source processed: /opt/forensics/cases/case-001/image.E01
Command: log2timeline.py -z "Europe/Madrid" ...
Events
======
Total number of events: 15234890
  • Comprobación Clave: Verifica que el campo Status reporte completed. Si refleja el estado aborted o failed, la base de datos está truncada y no es válida para la siguiente fase.
  • Validación del Total de Eventos: Si la lista muestra 0 eventos, la ingesta se ha realizado de forma incorrecta (por ejemplo, por problemas de permisos sobre la imagen forense o rutas mal referenciadas).

Casuística B: Auditar Errores Forenses Internos (--sections errors)

Sección titulada «Casuística B: Auditar Errores Forenses Internos (--sections errors)»

Este é o passo de auditoria de qualidade mais importante do Blue Team. log2timeline.py não para sua execução se se encontra com arquivos de registro corrompidos ou quebrados; simplesmente registra o erro nos metadados do arquivo para sua posterior inspeção:

Ventana de terminal
pinfo.py --sections errors /opt/forensics/cases/case-001/my_timeline.plaso
Errors
======
Parser: winevt
Path specification: /Windows/System32/winevt/Logs/Security.evtx
Error: Unable to parse EVTX file.
  • Interpretación del Fallo: El parser de logs winevt ha fallado en el procesamiento del archivo de logs de Seguridad principal (Security.evtx). El investigador sabe gracias a esto que le faltan los eventos de inicio de sesión. Se deberá intentar extraer el artefacto de la imagen de forma aislada y emplear recuperadores del archivo Security para repararlo.

Casuística C: Detalle de Carga de los Parsers (--sections parsers)

Sección titulada «Casuística C: Detalle de Carga de los Parsers (--sections parsers)»

Permite listar quais módulos analisadores encontraram eventos válidos e em qual quantidade relativa:

Ventana de terminal
pinfo.py --sections parsers /opt/forensics/cases/case-001/my_timeline.plaso
Parsers
=======
Parser: Total number of events
-------------------------------------------------
chrome_cache: 15230
chrome_history: 5890
...
fs: 8901234
...
prefetch: 450
windows_registry: 250120
winevt: 120450
-------------------------------------------------
Total: 15234890
  • Interpretación: Si tu objetivo de investigación se centraba en averiguar la ejecución de archivos, y el parser prefetch muestra 450 entradas, confirmas que dispondrás de evidencias abundantes en el archivo .plaso.

Casuística D: Identificación del Sistema Operativo y Zona Horaria (--sections info,analysis)

Sección titulada «Casuística D: Identificación del Sistema Operativo y Zona Horaria (--sections info,analysis)»

Garante que o Plaso identificou corretamente a assinatura do sistema operacional e o fuso horário utilizado na investigação:

Ventana de terminal
pinfo.py --sections "info,analysis" /opt/forensics/cases/case-001/my_timeline.plaso
Analysis Reports
================
Report: Operating System
---------------------------------------
Version: Windows 10 Pro
Report: Timezone
--------------------------------
System Timezone: Europe/Madrid
  • Interpretación: Si la zona horaria del sistema analizado no se corresponde con la hora detectada por la base de datos, cualquier correlación temporal posterior lanzada en la línea de tiempo será incorrecta.

Casuística E: Resumen de Copias Ocultas Procesadas (--sections stores)

Sección titulada «Casuística E: Resumen de Copias Ocultas Procesadas (--sections stores)»

Verifica que la directiva --vss-stores ha completado el análisis de las instantáneas:

Ventana de terminal
pinfo.py --sections stores /opt/forensics/cases/case-001/my_timeline.plaso
Storage Files
=============
Index Path specification
----------------------------
0 /opt/forensics/cases/case-001/image.E01 (Partition 2)
1 VSS Store 1 (Created: 2026-03-10 ...)
2 VSS Store 2 (Created: 2026-03-15 ...)
  • Interpretación: Confirma que Plaso ha procesado con éxito la partición activa principal (índice 0) y dos instantáneas pasadas.

Casuística F: Despejo Completo de Auditoria (Modo Verbose)

Sección titulada «Casuística F: Volcado Completo de Auditoría (Modo Verbose)»

A abordagem mais utilizada pelos investigadores. Despeja de uma só vez todas as seções analíticas de metadados estruturados em um arquivo de texto de relatório do caso:

Ventana de terminal
pinfo.py -v /opt/forensics/cases/case-001/my_timeline.plaso > /opt/forensics/cases/case-001/analysis_report.txt

  1. Fase de Criação: Executa log2timeline.py para construir a base de dados my_timeline.plaso (tarefa de longa duração).
  2. Fase de Diagnóstico Imediato: Gera o relatório global verboso:
    Ventana de terminal
    pinfo.py -v /opt/forensics/cases/case-001/my_timeline.plaso > /opt/forensics/cases/case-001/analysis_report.txt
  3. Fase de Auditoria: Abre o arquivo analysis_report.txt e confirma:
    • ✔ O estado Status deve ser completed.
    • ✔ A seção errors não deve listar perdas de arquivos de registro vitais.
    • ✔ A zona horária coincide plenamente com a do sistema investigado.
  4. Fase de Processamento: Se a auditoria for satisfatória, prossiga imediatamente para processar os dados com psort.py. Em caso contrário, se corrigam os parâmetros na ingestão e se repita o passo 1.