Communitygithub.com

análise-de-pst-outlook-para-perícia-de-e-mail

Analisar arquivos PST e OST do Microsoft Outlook usando libpff e pst-utils para extrair conteúdo de mensagens, cabeçalhos, anexos, itens excluídos e metadados MAPI, incluindo recuperação de itens da pasta Itens Recuperáveis. Use ao conduzir investigações forenses de e-mail, e-discovery legal ou resposta a incidentes que exijam reconstrução de padrões de comunicação ou rastreamento de roteamento de mensagens a partir de arquivos do Outlook.

O que é análise-de-pst-outlook-para-perícia-de-e-mail?

Esta habilidade capacita um agente de IA a realizar análises forenses aprofundadas de arquivos PST (Personal Storage Table) e OST (Offline Storage Table) do Microsoft Outlook, fontes críticas de evidência em investigações digitais. Ela utiliza ferramentas de código aberto como libpff e pypff, além de scripts Python personalizados, para extrair mensagens de e-mail, cabeçalhos de transporte, anexos, itens excluídos (da pasta Itens Recuperáveis) e metadados MAPI. A habilidade é útil para investigadores de segurança, analistas de SOC e profissionais de e-discovery que precisam reconstruir padrões de comunicação, rastrear roteamento de mensagens de ponta a ponta, detectar indicadores de phishing, identificar exfiltração de dados por anexos criptografados e executar buscas por palavras-chave. O agente pode processar recursivamente pastas, gerar relatórios JSON abrangentes, exportar anexos para análise de malware e analisar cabeçalhos de e-mail para verificação de autenticação (SPF, DKIM, DMARC) e rastreamento de IP de origem, tornando-se uma ferramenta completa para investigações de e-mail corporativo. A solução é compatível com ambientes de análise forense baseados em Linux, macOS e Windows, e oferece suporte a arquivos PST em formato ANSI (legado) e Unicode (moderno).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/main/skills/analyzing-outlook-pst-for-email-forensics

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Analisando PST do Outlook para Perícia Forense de E-mail

Visão Geral

Arquivos PST (Personal Storage Table) e OST (Offline Storage Table) do Microsoft Outlook são fontes de evidência críticas em investigações de perícia digital. Os arquivos PST armazenam mensagens de e-mail, eventos de calendário, contatos, tarefas e anotações em um formato binário proprietário baseado no sistema de propriedades MAPI (Messaging Application Programming Interface). A análise forense desses arquivos permite a recuperação de e-mails excluídos (da pasta Itens Recuperáveis), a extração de cabeçalhos de e-mail para rastrear rotas de mensagens, a análise de anexos para busca de malware ou dados exfiltrados e a reconstrução de padrões de comunicação. Arquivos PST modernos usam o formato Unicode com páginas de 4KB e podem crescer até 50GB, enquanto o formato ANSI legado é limitado a 2GB.

Quando Usar

  • Ao investigar incidentes de segurança que exijam a análise de PST do Outlook para perícia forense de e-mail.
  • Ao construir regras de detecção ou consultas de caça a ameaças para este domínio.
  • Quando analistas de SOC precisam de procedimentos estruturados para este tipo de análise.
  • Ao validar a cobertura de monitoramento de segurança para técnicas de ataque relacionadas.

Pré-requisitos

  • libpff/pffexport (analisador PST de código aberto)
  • Python 3.8+ com bibliotecas pypff ou libratom
  • MailXaminer, Forensic Email Collector ou SysTools PST Forensics (comerciais)
  • Microsoft Outlook (opcional, para acesso nativo a PST)
  • Espaço em disco suficiente para o conteúdo extraído

Localizações de Arquivos PST

OrigemCaminho
Padrão Outlook 2016+%USERPROFILE%\Documents\Outlook Files*.pst
Outlook Legado%LOCALAPPDATA%\Microsoft\Outlook*.pst
Cache OST%LOCALAPPDATA%\Microsoft\Outlook*.ost
Arquivo%USERPROFILE%\Documents\Outlook Files\archive.pst

Análise com Ferramentas de Código Aberto

libpff / pffexport

# Exportar todos os itens de um arquivo PST
pffexport -m all evidence.pst -t exported_pst

# Exportar apenas mensagens de e-mail
pffexport -m items evidence.pst -t exported_emails

# Exportar itens recuperados/excluídos
pffexport -m recovered evidence.pst -t recovered_items

# Obter informações do arquivo PST
pffinfo evidence.pst

Análise PST em Python

import pypff
import os
import json
import hashlib
import email
import sys
from datetime import datetime
from collections import defaultdict


class PSTForensicAnalyzer:
    """Análise forense de arquivos PST/OST do Outlook."""

    def __init__(self, pst_path: str, output_dir: str):
        self.pst_path = pst_path
        self.output_dir = output_dir
        os.makedirs(output_dir, exist_ok=True)
        self.pst = pypff.file()
        self.pst.open(pst_path)
        self.messages = []
        self.attachments = []
        self.stats = defaultdict(int)

    def process_folder(self, folder, folder_path: str = ""):
        """Processa recursivamente pastas PST e extrai mensagens."""
        folder_name = folder.name or "Root"
        current_path = f"{folder_path}/{folder_name}" if folder_path else folder_name

        for i in range(folder.number_of_sub_messages):
            try:
                message = folder.get_sub_message(i)
                msg_data = self.extract_message(message, current_path)
                if msg_data:
                    self.messages.append(msg_data)
                    self.stats["total_messages"] += 1
            except Exception as e:
                self.stats["parse_errors"] += 1

        for i in range(folder.number_of_sub_folders):
            try:
                subfolder = folder.get_sub_folder(i)
                self.process_folder(subfolder, current_path)
            except Exception:
                continue

    def extract_message(self, message, folder_path: str) -> dict:
        """Extrai metadados forenses de uma única mensagem de e-mail."""
        msg_data = {
            "folder": folder_path,
            "subject": message.subject or "",
            "sender": message.sender_name or "",
            "sender_email": "",
            "creation_time": str(message.creation_time) if message.creation_time else None,
            "delivery_time": str(message.delivery_time) if message.delivery_time else None,
            "modification_time": str(message.modification_time) if message.modification_time else None,
            "has_attachments": message.number_of_attachments > 0,
            "attachment_count": message.number_of_attachments,
            "body_size": len(message.plain_text_body or b""),
            "html_size": len(message.html_body or b""),
        }

        # Extrair cabeçalhos de transporte para análise de roteamento
        headers = message.transport_headers
        if headers:
            msg_data["headers_present"] = True
            msg_data["headers_size"] = len(headers)
            # Analisar cabeçalhos principais
            parsed = email.message_from_string(headers)
            msg_data["from_header"] = parsed.get("From", "")
            msg_data["to_header"] = parsed.get("To", "")
            msg_data["date_header"] = parsed.get("Date", "")
            msg_data["message_id"] = parsed.get("Message-ID", "")
            msg_data["x_originating_ip"] = parsed.get("X-Originating-IP", "")
            msg_data["received_headers"] = parsed.get_all("Received", [])

        # Processar anexos
        for j in range(message.number_of_attachments):
            try:
                attachment = message.get_attachment(j)
                att_data = {
                    "message_subject": msg_data["subject"],
                    "name": attachment.name or f"attachment_{j}",
                    "size": attachment.size,
                    "content_type": "",
                }
                self.attachments.append(att_data)
                self.stats["total_attachments"] += 1
            except Exception:
                continue

        return msg_data

    def save_attachments(self, max_size_mb: int = 100):
        """Exporta anexos para disco para análise."""
        att_dir = os.path.join(self.output_dir, "attachments")
        os.makedirs(att_dir, exist_ok=True)

        root = self.pst.get_root_folder()
        self._save_attachments_recursive(root, att_dir, max_size_mb)

    def _save_attachments_recursive(self, folder, att_dir, max_size_mb):
        for i in range(folder.number_of_sub_messages):
            try:
                message = folder.get_sub_message(i)
                for j in range(message.number_of_attachments):
                    att = message.get_attachment(j)
                    if att.size and att.size < max_size_mb * 1024 * 1024:
                        name = att.name or f"unknown_{i}_{j}"
                        safe_name = "".join(c if c.isalnum() or c in ".-_" else "_" for c in name)
                        path = os.path.join(att_dir, safe_name)
                        try:
                            data = att.read_buffer(att.size)
                            with open(path, "wb") as f:
                                f.write(data)
                        except Exception:
                            continue
            except Exception:
                continue

        for i in range(folder.number_of_sub_folders):
            try:
                self._save_attachments_recursive(folder.get_sub_folder(i), att_dir, max_size_mb)
            except Exception:
                continue

    def generate_report(self) -> str:
        """Gera relatório abrangente de análise forense PST."""
        root = self.pst.get_root_folder()
        self.process_folder(root)

        report = {
            "analysis_timestamp": datetime.now().isoformat(),
            "pst_file": self.pst_path,
            "pst_size_bytes": os.path.getsize(self.pst_path),
            "statistics": dict(self.stats),
            "messages": self.messages[:500],
            "attachments": self.attachments[:200],
        }

        report_path = os.path.join(self.output_dir, "pst_forensic_report.json")
        with open(report_path, "w") as f:
            json.dump(report, f, indent=2, default=str)

        print(f"[*] Total mensagens: {self.stats['total_messages']}")
        print(f"[*] Total anexos: {self.stats['total_attachments']}")
        print(f"[*] Erros de análise: {self.stats['parse_errors']}")
        return report_path

    def close(self):
        self.pst.close()


def main():
    if len(sys.argv) < 3:
        print("Uso: python process.py <arquivo_pst> <diretorio_saida>")
        sys.exit(1)
    analyzer = PSTForensicAnalyzer(sys.argv[1], sys.argv[2])
    analyzer.generate_report()
    analyzer.close()


if __name__ == "__main__":
    main()

Análise de Cabeçalhos de E-mail

Cabeçalhos principais para investigação forense:

CabeçalhoValor Forense
ReceivedCadeia de roteamento da mensagem (leia de baixo para cima)
X-Originating-IPEndereço IP real do remetente
Message-IDIdentificador único para correlação
DateTimestamp de envio
Return-PathEndereço de devolução (pode diferir do From)
DKIM-SignatureAssinatura de autenticação de domínio
Authentication-ResultsResultados de verificação SPF, DKIM, DMARC
X-MailerCliente de e-mail utilizado

Referências

Exemplo de Saída

$ pffexport /evidencias/jsmith_archive.pst -t /analise/saida_pst

pffexport 20231205 - libpff Ferramenta de Exportação PST/OST
=================================================
Entrada: /evidencias/jsmith_archive.pst (2.3 GB)

Exportando conteúdo PST...
  Pastas:        45
  Mensagens:     12.456
  Anexos:        3.234
  Contatos:      567
  Calendário:    234
  Tarefas:       89

Exportação concluída em 3m 42s.

$ python3 pst_analyzer.py /analise/saida_pst /analise/relatorio_email

Relatório de Análise Forense PST
==============================
Origem: jsmith_archive.pst ([email protected])
Intervalo de Datas: 2023-06-01 a 2024-01-18

--- Estatísticas da Caixa Postal ---
  Total de E-mails:      12.456
  Enviados:              4.567
  Recebidos:             7.889
  Com Anexos:            3.234
  Excluídos (recuperados): 234

--- E-mails de Phishing / Suspeitos ---
E-mail #8923
  Data:        2024-01-15 14:30:22 UTC
  De:          "Suporte TI" <[email protected]>
  Para:        [email protected]
  Assunto:     Urgente: Redefinição de Senha Necessária
  Cabeçalhos:
    Return-Path:    [email protected]
    X-Originating-IP: 203.0.113.55
    Received:       de relay-mensagem.ajuda-c0rporativa.com (203.0.113.55)
    SPF:            FALHA (domínio ajuda-c0rporativa.com)
    DKIM:           NENHUM
    DMARC:          FALHA
  Anexos:
    - Formulario_Redefinicao_Senha.xlsm (245 KB) SHA-256: 7a3b8c9d...e1f2a3b4
  Prévia do Corpo: "Prezado Colaborador, Sua senha expirará em 24 horas.
                  Por favor, abra o formulário anexo para redefinir suas credenciais..."

--- Indicadores de Exfiltração de Dados ---
E-mail #9102
  Data:        2024-01-16 03:15:45 UTC
  De:          [email protected]
  Para:          [email protected]
  Assunto:     (sem assunto)
  Anexos:
    - archive_parte1.7z (24.5 MB) - criptografado
    - archive_parte2.7z (24.5 MB) - criptografado

E-mail #9103
  Data:        2024-01-16 03:18:22 UTC
  De:          [email protected]
  Para:          [email protected]
  Assunto:     Re:
  Anexos:
    - archive_parte3.7z (18.2 MB) - criptografado

--- Ocorrências de Palavras-chave ---
  "confidencial":     45 e-mails
  "senha":            23 e-mails
  "transferência":     12 e-mails
  "demissão":          3 e-mails
  "apagar evidências": 1 e-mail (E-mail #9200, 2024-01-17 22:30:00 UTC)

Resumo:
  E-mails de phishing detectados:    1 (vetor de comprometimento inicial)
  E-mails enviados suspeitos:       5 (para contas pessoais com anexos)
  Anexos criptografados:             3 (67.2 MB total - possível exfiltração)
  Relatório: /analise/relatorio_email/pst_forensic_report.json

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,

Habilidades Relacionadas