
libpff
Bibliothèque C open source pour les formats de fichiers Outlook
Lire, analyser et extraire des données des fichiers PST, OST, PAB et OFF via une API C gratuite et open source.
Qu'est-ce que libpff ?
libpff est une puissante bibliothèque C open source conçue pour accéder aux formats Personal Folder File (PFF) et Offline Folder File (OFF) utilisés par Microsoft Outlook. Elle permet aux développeurs de lire, analyser et extraire de manière programmatique les courriels, contacts, éléments de calendrier et autres données stockées dans les fichiers PST, OST, PAB et OFF. La bibliothèque prend en charge les encodages de chaînes 32 bits ANSI et 64 bits Unicode, ainsi que les formats compressés tels que les fichiers OST compressés DEFLATE sur pages de 4 Ko introduits dans Outlook 2013. Grâce à son moteur d'analyse robuste, libpff est particulièrement utile en criminalistique numérique, migration de courriels et processus de récupération de données.
La bibliothèque est activement maintenue sous la licence LGPL-3.0-or-later et est actuellement en statut alpha, ce qui signifie qu'elle est fonctionnelle mais peut manquer de complétude fonctionnelle ou de stabilité pour une utilisation en production. Elle comprend des outils de récupération d'éléments et peut gérer des fichiers corrompus ou chiffrés où le type de chiffrement est aucun. libpff s'intègre également à des projets connexes comme libfmapi pour les définitions MAPI et fournit une documentation médico-légale détaillée pour aider à analyser les structures complexes des fichiers Outlook. Les développeurs peuvent compiler à partir du code source ou utiliser des binaires précompilés, et le projet est hébergé sur GitHub pour les contributions de la communauté et le suivi des problèmes.
Premiers pas avec libpff
Pour commencer à utiliser libpff, vous pouvez cloner le code source depuis son dépôt officiel [GitHub de libpff](https://github.com/libyal/libpff) et le compiler à l'aide de CMake ou d'autotools. Les binaires précompilés ne sont pas distribués officiellement, il est donc recommandé de compiler à partir des sources. Le projet comprend des instructions de compilation détaillées et des dépendances telles que libyal/libcerror et libyal/libcdata. Une fois compilé, vous pouvez utiliser les outils en ligne de commande fournis (par ex. `pffexport`, `pffinfo`) pour inspecter et extraire les données des fichiers PST/OST. Pour une utilisation programmatique, liez la bibliothèque compilée dans votre application C/C++. La bibliothèque est légère et possède peu de dépendances externes, ce qui la rend adaptée aux environnements embarqués ou forensiques.
Installer libpff via compilation à partir du code source
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
Extraire les e‑mails et les pièces jointes des fichiers PST
libpff fournit une fonctionnalité robuste pour analyser les fichiers PST et extraire les messages électroniques individuels ainsi que leurs pièces jointes. Les développeurs peuvent parcourir la hiérarchie des dossiers, accéder aux propriétés des messages (par ex., sujet, expéditeur, destinataires, horodatages) et exporter le contenu MIME brut ou des données structurées. La bibliothèque prend en charge les encodages de chaînes ANSI et Unicode, garantissant la compatibilité avec les versions d'Outlook des années 1990 jusqu'aux versions modernes. Elle gère également les fichiers OST compressés (DEFLATE à pages de 4 Ko), qui sont courants dans les versions plus récentes d'Outlook. Cela rend libpff idéal pour les outils de migration de courriels, les plateformes d'e‑discovery et l'analyse forensique où l'extraction précise des corps de messages et des pièces jointes est cruciale. L'API expose un accès bas‑niveau aux propriétés MAPI, permettant un contrôle granulaire de la récupération des données.
Comment extraire les e‑mails d'un fichier PST via l'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);
Analyse forensique des fichiers Outlook corrompus
libpff inclut des capacités spécialisées pour l'analyse forensique de fichiers Outlook endommagés ou partiellement corrompus. Il peut analyser des fichiers avec des en-têtes manquants ou incohérents, récupérer les éléments orphelins et reconstruire les arbres de messages même lorsque les index internes sont cassés. La bibliothèque prend en charge les fichiers dont le type de chiffrement est "none" et peut contourner certaines erreurs structurelles pour extraire des données utilisables. Cela est particulièrement précieux dans les enquêtes de criminalistique numérique où les preuves peuvent se trouver dans des fichiers PST/OST détériorés. libpff fournit également une journalisation détaillée et des rapports d'erreurs, permettant aux analystes de suivre les décisions d'analyse et d'identifier les points de perte de données. Associé à son extraction de propriétés MAPI, libpff constitue une base fiable pour la création d'outils forensiques répondant aux normes légales et de conformité.
Comment récupérer des éléments d'un fichier PST corrompu ?
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);
Analyser les propriétés et métadonnées MAPI
libpff permet une inspection approfondie des propriétés MAPI intégrées aux éléments Outlook. Les développeurs peuvent récupérer les propriétés standard telles que `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, ainsi que les propriétés personnalisées définies par les applications. La bibliothèque expose une API d’ensemble de propriétés qui permet d’itérer sur toutes les propriétés d’un message, d’un dossier ou d’une pièce jointe. Ceci est essentiel pour les applications nécessitant des audits de conformité, l’extraction de métadonnées ou l’intégration avec des systèmes basés sur MAPI. libpff prend en charge à la fois les identifiants de propriétés nommés et numériques, et gère les types de valeurs 32 bits et 64 bits (par ex., chaînes, entiers, blobs binaires). Son intégration étroite avec libfmapi garantit une interprétation précise des définitions MAPI, ce qui le rend adapté à la création d’outils avancés d’analyse de données Outlook.
Comment extraire les propriétés MAPI d'un élément de message ?
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);
}
Exporter les données vers des formats standards (CSV, JSON, XML)
Tandis que libpff est principalement une bibliothèque C pour l'analyse de bas niveau, elle comprend des utilitaires en ligne de commande et des API qui facilitent l'exportation des données Outlook vers des formats largement utilisés tels que CSV, JSON et XML. Des outils tels que `pffexport` peuvent convertir le contenu PST/OST en fichiers texte structurés, en préservant la hiérarchie des dossiers et les métadonnées des messages. Les développeurs peuvent également utiliser la bibliothèque de manière programmatique pour créer des exportateurs personnalisés — par exemple, mapper les propriétés MAPI vers des objets JSON pour l'ingestion dans les moteurs de recherche ou les plateformes d'analyse. Cette capacité d'exportation est cruciale pour la migration de données, la sauvegarde et l'intégration avec les services cloud modernes qui nécessitent des formats d'entrée standardisés. La conception flexible de libpff permet aux développeurs d'adapter la logique d'exportation aux exigences spécifiques de conformité ou de flux de travail.
Comment exporter le contenu d'un PST au format JSON via 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
