
libpff
Libreria C Open Source per i Formati di File Outlook
Leggi, Analizza ed Estrai Dati da File PST, OST, PAB e OFF tramite API C Open Source Gratuita.
Che cos'è libpff?
libpff è una potente libreria C open source progettata per accedere ai formati Personal Folder File (PFF) e Offline Folder File (OFF) utilizzati da Microsoft Outlook. Consente agli sviluppatori di leggere, analizzare ed estrarre programmaticamente email, contatti, elementi del calendario e altri dati memorizzati nei file PST, OST, PAB e OFF. La libreria supporta sia codifiche di stringhe ANSI a 32 bit che Unicode a 64 bit, nonché formati compressi come i file OST compressi DEFLATE a pagine da 4 KB introdotti in Outlook 2013. Grazie al suo robusto motore di parsing, libpff è particolarmente utile in forense digitale, migrazione di email e flussi di lavoro di recupero dati.
La libreria è attivamente mantenuta sotto licenza LGPL-3.0-or-later e attualmente è in stato alpha, il che significa che è funzionale ma potrebbe non avere la completa completezza delle funzionalità o la stabilità necessaria per l'uso in produzione. Include strumenti per il recupero di elementi e può gestire file corrotti o crittografati dove il tipo di crittografia è nessuno. libpff si integra anche con progetti correlati come libfmapi per le definizioni MAPI e fornisce una documentazione forense dettagliata per aiutare ad analizzare strutture complesse di file Outlook. Gli sviluppatori possono compilare dal sorgente o utilizzare binari precompilati, e il progetto è ospitato su GitHub per contributi della comunità e tracciamento dei problemi.
Iniziare con libpff
Per iniziare a usare libpff, puoi clonare il codice sorgente dal suo repository ufficiale [libpff GitHub](https://github.com/libyal/libpff) e compilarlo usando CMake o autotools. I binari precompilati non sono distribuiti ufficialmente, quindi la compilazione dal sorgente è l'approccio consigliato. Il progetto include istruzioni dettagliate per la compilazione e dipendenze come libyal/libcerror e libyal/libcdata. Una volta compilato, puoi utilizzare gli strumenti da riga di comando forniti (ad esempio `pffexport`, `pffinfo`) per ispezionare ed estrarre dati da file PST/OST. Per l'uso programmatico, collega la libreria compilata nella tua applicazione C/C++. La libreria è leggera e ha dipendenze esterne minime, rendendola adatta a ambienti embedded o forensi.
Installa libpff tramite compilazione da sorgente
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
Estrai email e allegati dai file PST
libpff fornisce funzionalità robuste per analizzare i file PST ed estrarre singoli messaggi email insieme ai relativi allegati. Gli sviluppatori possono attraversare la gerarchia delle cartelle, accedere alle proprietà dei messaggi (ad es., oggetto, mittente, destinatari, timestamp) ed esportare il contenuto MIME grezzo o dati strutturati. La libreria supporta sia le codifiche di stringa ANSI che Unicode, garantendo la compatibilità con le versioni di Outlook dagli anni '90 fino alle versioni moderne. Gestisce inoltre i file OST compressi (DEFLATE a pagine da 4 KB), comuni nelle versioni più recenti di Outlook. Questo rende libpff ideale per strumenti di migrazione email, piattaforme di e-discovery e analisi forense, dove l'estrazione accurata dei corpi dei messaggi e degli allegati è fondamentale. L'API espone l'accesso a basso livello alle proprietà MAPI, consentendo un controllo dettagliato sul recupero dei dati.
Come estrarre email da un file PST tramite API C?
pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;
if (pff_file_open(&pff_file, "example.pst", PFF_OPEN_READ, &error) != 1) {
// handle error
}
pff_item_t *root_item = NULL;
if (pff_file_get_root_item(pff_file, &root_item, &error) != 1) {
// handle error
}
// Iterate over items and extract messages
pff_item_t *item = NULL;
while (pff_item_get_sub_item(root_item, &item, &error) == 1) {
// Process each item (e.g., folder or message)
pff_item_free(&item, NULL);
}
pff_item_free(&root_item, NULL);
pff_file_close(pff_file, &error);
Analisi forense di file Outlook corrotti
libpff include capacità specializzate per l'analisi forense di file Outlook danneggiati o parzialmente corrotti. Può analizzare file con intestazioni mancanti o incoerenti, recuperare elementi orfani e ricostruire gli alberi dei messaggi anche quando gli indici interni sono rotti. La libreria supporta file con tipo di crittografia "none" e può aggirare alcuni errori strutturali per estrarre dati utilizzabili. Questo è particolarmente prezioso nelle indagini di forense digitale dove le prove possono trovarsi in file PST/OST degradati. libpff fornisce anche registri dettagliati e segnalazione degli errori, consentendo agli analisti di tracciare le decisioni di parsing e identificare i punti di perdita dei dati. In combinazione con l'estrazione delle proprietà MAPI, libpff funge da base affidabile per costruire strumenti forensi che soddisfano gli standard legali e di conformità.
Come recuperare gli elementi da un file PST corrotto?
pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;
// Open with recovery mode (if supported)
if (pff_file_open_recover(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error) != 1) {
// fallback to standard open
pff_file_open(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error);
}
// Use item recovery functions
pff_item_t *recovered_item = NULL;
if (pff_file_get_recovered_item(pff_file, &recovered_item, &error) == 1) {
// Process recovered item
pff_item_free(&recovered_item, NULL);
}
pff_file_close(pff_file, &error);
Analizza le proprietà e i metadati MAPI
libpff consente un'ispezione approfondita delle proprietà MAPI incorporate negli elementi di Outlook. Gli sviluppatori possono recuperare proprietà standard come `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME` e proprietà personalizzate definite dalle applicazioni. La libreria espone un'API di set di proprietà che permette l'iterazione su tutte le proprietà di un messaggio, cartella o allegato. Questo è essenziale per le applicazioni che richiedono audit di conformità, estrazione di metadati o integrazione con sistemi basati su MAPI. libpff supporta sia identificatori di proprietà nominati che numerici e gestisce sia tipi di valore a 32-bit che a 64-bit (ad esempio, stringhe, interi, blob binari). La sua stretta integrazione con libfmapi garantisce un'interpretazione accurata delle definizioni MAPI, rendendola adatta alla creazione di strumenti avanzati di analisi dei dati di Outlook.
Come estrarre le proprietà MAPI da un elemento di messaggio?
pff_item_t *message_item = NULL;
pff_property_t *property = NULL;
pff_error_t *error = NULL;
// Assume message_item is obtained from traversal
while (pff_item_get_property(message_item, &property, &error) == 1) {
uint32_t property_tag = 0;
uint32_t property_type = 0;
const uint8_t *value_data = NULL;
size_t value_data_size = 0;
pff_property_get_tag(property, &property_tag, &error);
pff_property_get_type(property, &property_type, &error);
pff_property_get_value_data(property, &value_data, &value_data_size, &error);
// Process property (e.g., print subject if PR_SUBJECT)
if (property_tag == 0x0037001F) { // PR_SUBJECT (Unicode)
printf("Subject: %ls\n", (wchar_t*)value_data);
}
pff_property_free(&property, NULL);
}
Esporta dati in formati standard (CSV, JSON, XML)
Mentre libpff è principalmente una libreria C per l'analisi a basso livello, include utility da riga di comando e API che facilitano l'esportazione dei dati di Outlook in formati ampiamente utilizzati come CSV, JSON e XML. Strumenti come `pffexport` possono convertire i contenuti PST/OST in file di testo strutturati, preservando la gerarchia delle cartelle e i metadati dei messaggi. Gli sviluppatori possono anche utilizzare la libreria programmaticamente per creare esportatori personalizzati—ad esempio, mappando le proprietà MAPI a oggetti JSON per l'ingestione in motori di ricerca o piattaforme di analisi. Questa capacità di esportazione è fondamentale per la migrazione dei dati, il backup e l'integrazione con i moderni servizi cloud che richiedono formati di input standardizzati. Il design flessibile di libpff consente agli sviluppatori di adattare la logica di esportazione a requisiti specifici di conformità o di flusso di lavoro.
Come esportare il contenuto PST in JSON tramite CLI?
# Export all messages to JSON with metadata
pffexport -f json -o output_dir/ example.pst
# Export only messages with attachments
pffexport -f json -a example.pst
# View help for export options
pffexport --help
