Linguagem de Consultas Avançada e Caza de Amenazas com psort.py
Sintaxe SQL-like de filtrado com psort.py, operadores lógicos, expressões regulares e aislamento de indicadores de compromisso em investigações forenses.
A Linguagem de Consultas e Técnicas de Caça
Sección titulada «El Lenguaje de Consultas y Técnicas de Caza»1. Visão Geral
Sección titulada «1. Visión General»Uma vez aprendidos os fundamentos de psort.py (definição de formatos de saída, uso do parâmetro -w de escritura e definição de zona horária local), já sabemos como extraer e delimitar o timeline por datas.
No entanto, dentro deste intervalo temporal delimitado, ainda devemos ser capazes de encontrar indicadores de ataque suspeitos e dados de presença de malware de forma rápida. A filtragem avançada de conteúdo é executada através de um parâmetro principal:
-filter <CONSULTA>ou--filter <CONSULTA>
Este parâmetro emprega uma linguagem de consultas própria da plataforma Plaso (com uma sintaxe muito parecida com as declarações SQL), permitindo realizar pesquisas baseadas em qualquer atributo associado a um evento.
2. Principais Atributos para Pesquisa Forense
Sección titulada «2. Atributos Principales para Búsqueda Forense»Para poder filtrar com sucesso, deve conhecer os campos de dados que processa a base de dados sqlite interna do arquivo .plaso:
- ✔ message
: A descrição textual ou conteúdo do evento (ex: Execution of: cmd.exe, URL: ...). Esse é o principal objetivo de busca para localizar domínios e executáveis. - ✔ parser
: O módulo analizador encarregado de gerar o registro (ex: winevt, prefetch, chrome_history). - ✔ data_type
: O tipo específico de estrutura de dados (ex: windows:prefetch:execution, fs:stat, chrome:history:visit). É um campo muito granular e de alto valor analítico. - ✔ filename
: Rota física do arquivo onde reside a prova (ex: /Windows/Prefetch/CMD.EXE.pf). - ✔ source_short
: Classificação compacta do tipo de evidência (ex: REGpara registro, FILEpara sistema de arquivos, WEBHISTpara web). - ✔ timestamp_desc
: Detalhe do tipo de marca de tempo (ex: File Creation Time, Last Access Time).
3. Sintaxe de Consultas e Operadores Suportados
Sección titulada «3. Sintaxis de Consultas y Operadores Soportados»Aspas de Sintaxe
Toda a cadeia que acompanha ao parâmetro --filter se deve escrever encerrada de forma obrigatória entre aspas duplas ("). As variáveis de texto contidas no interior se definirão entre aspas simples (').
A. Igualdade Estricta (==)
Sección titulada «A. Igualdad Estricta (==)»Busca uma correspondência de texto exata respeitando maiúsculas e minúsculas:
# Filtrar para recopilar solo eventos creados por el parser Prefetch--filter "parser == 'prefetch'"B. Desigualdade ou Exclusão (!=)
Sección titulada «B. Desigualdad o Exclusión (!=)»Exclui determinados valores ou tipos da consulta para eliminar ruído repetitivo:
# Omitir todos los registros genéricos del sistema de archivos (MFT)--filter "data_type != 'fs:stat'"C. Coincidência de Conteúdo (CONTAINS)
Sección titulada «C. Coincidencia de Contenido (CONTAINS)»O operador mais potente da suite forense. Realiza buscas de texto de tipo substring e não diferencia maiúsculas de minúsculas sobre o atributo indicado:
# Localizar cualquier evento que contenga o mencione el binario powershell--filter "message CONTAINS 'powershell.exe'"
# Búsqueda de dominios maliciosos detectados en la red--filter "message CONTAINS 'evil-domain.com'"D. Expressões Regulares (=~)
Sección titulada «D. Expresiones Regulares (=~)»Permite criar pesquisas com padrões de caracteres complexos (regex):
# Identificar de forma automática cualquier dirección IP de tipo IPv4 contenida en el campo message--filter "message =~ '[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}'"4. Operadores Lógicos Combinados (AND, OR, NOT)
Sección titulada «4. Operadores Lógicos Combinados (AND, OR, NOT)», NOT)Podemos combinar diferentes diretivas de pesquisa para fechar o cerco sobre indicadores de comprometimento específicos em grandes volumes de logs:
Casuística A: Caça Forense de Execução de Malware
Sección titulada «Casuística A: Caza Forense de Ejecución de Malware»- Objetivo do Caso: Queremos localizar rapidamente o rastro da execução de um software suspeito chamado mimikatz.exe
na cache de execuções.
--filter "message CONTAINS 'mimikatz.exe' AND (parser == 'prefetch' OR data_type == 'windows:appcompatcache:entry')"Casuística B: Isolar o Histórico de Navegação e Downloads
Sección titulada «Casuística B: Aislar el Historial de Navegación y Descargas»- Objetivo do Caso: Listar exclusivamente as conexões e descargas realizadas com os navegadores Chrome e Firefox instalados no sistema da vítima.
--filter "parser == 'chrome_history' OR parser == 'firefox_history' OR parser == 'chrome_downloads' OR parser == 'firefox_downloads'"Casuística C: Exclusão do Ruído de Fundo do Disco (MFT)
Sección titulada «Casuística C: Exclusión del Ruido de Fondo del Disco (MFT)»- Objetivo do Caso: Queremos auditar todas as entradas do sistema, exceto as milhões de consultas do MFT que fazem referência ao arquivo de eventos do sistema de arquivos (FILE
).
--filter "source_short != 'FILE'"5. O Fluxo de Trabalho Completo: O Comando Mestre
Sección titulada «5. El Flujo de Trabajo Completo: La Comando Maestra»Unindo todos os conhecimentos do manual de fundamentos e de análise avançada, criamos a consulta forense definitiva:
Cenário de Resposta a Incidentes:
Sección titulada «Escenario de Respuesta a Incidentes:»- Sospecha: Se produziu um ataque de roubo de credenciais mediante PowerShell no 15 de Março de 2026.
- IOCs (Indicadores de Compromiso): O atacante utilizou a shell de PowerShell e se comunicou com a IP fictícia 172.16.99.100
. - Zona Horária: O servidor se encontra configurado na zona horária de Europa/Madrid.
- Objetivo: Gerar um listado CSV depurado sem as entradas genéricas de arquivos (fs:stat
).
Execução do Comando Mestre do Blue Team:
Sección titulada «Ejecución de la Comando Maestra del Blue Team:»psort.py -z "Europe/Madrid" -o l2tcsv -w /opt/forensics/cases/case-001/timeline_triage_export.csv /opt/forensics/cases/case-001/my_timeline.plaso --date_filter "2026-03-15" --filter "(message CONTAINS 'powershell.exe' OR message CONTAINS '172.16.99.100') AND data_type != 'fs:stat'"Detalhamento da Arquitetura do Comando:
Sección titulada «Desglose de la Arquitectura de la Comando:»- -z "Europe/Madrid"
: Adapta automaticamente todas as datas do informe à franja local do incidente. - -o l2tcsv
: Formata perfeitamente a saída em formato de tabela CSV. - -w /opt/.../timeline_triage_export.csv
: Grava o arquivo de análise resultante. - --date_filter "2026-03-15"
: (Filtrado de Fundamentos) Isola exclusivamente a data onde se perpetrou o incidente. --filter "...": (Filtragem Avançada) Intersecta a busca exigindo:- Que o campo message
contenha o executável PowerShell O a direção IP de compromisso 172.16.99.100. - Y que se exclua todo o volume de entradas genéricas do sistema de arquivos (data_type != 'fs:stat'
).
- Que o campo message

