1. Produse
  2.   E-mail
  3.   C++
  4.   libpff

libpff

 
 

Bibliotecă C open source pentru formatele de fișiere Outlook

Citește, parsează și extrage date din fișierele PST, OST, PAB și OFF prin API C gratuit și open source.

Ce este libpff?

libpff este o bibliotecă C open source puternică, concepută pentru a accesa formatele Personal Folder File (PFF) și Offline Folder File (OFF) utilizate de Microsoft Outlook. Permite dezvoltatorilor să citească, să analizeze și să extragă programatic e‑mailuri, contacte, elemente de calendar și alte date stocate în fișierele PST, OST, PAB și OFF. Biblioteca suportă atât codificări de șiruri de caractere ANSI pe 32 de biți, cât și Unicode pe 64 de biți, precum și formate comprimate, cum ar fi fișierele OST comprimate cu DEFLATE pe pagini de 4K introduse în Outlook 2013. Cu motorul său robust de parsare, libpff este deosebit de valoros în forensic digital, migrarea de e‑mailuri și fluxurile de lucru de recuperare a datelor.

Biblioteca este întreținută activ sub licența LGPL-3.0-or-later și în prezent se află în stadiul alfa, ceea ce înseamnă că este funcțională, dar poate să nu aibă toate funcționalitățile complete sau stabilitatea necesară pentru utilizare în producție. Include instrumente pentru recuperarea elementelor și poate gestiona fișiere corupte sau criptate în care tipul de criptare este niciunul. libpff se integrează, de asemenea, cu proiecte conexe precum libfmapi pentru definiții MAPI și furnizează documentație forensică detaliată pentru a ajuta la analizarea structurilor complexe de fișiere Outlook. Dezvoltatorii pot compila din sursă sau pot folosi binare precompilate, iar proiectul este găzduit pe GitHub pentru contribuții din comunitate și urmărirea problemelor.

Previous Next

Începerea lucrului cu libpff

Pentru a începe să utilizați libpff, puteți clona codul sursă din depozitul său oficial [GitHub al libpff](https://github.com/libyal/libpff) și să îl construiți folosind CMake sau autotools. Binarele precompilate nu sunt distribuite oficial, astfel că compilarea din sursă este abordarea recomandată. Proiectul include instrucțiuni detaliate de construire și dependențe precum libyal/libcerror și libyal/libcdata. Odată construit, puteți folosi instrumentele din linia de comandă furnizate (de exemplu `pffexport`, `pffinfo`) pentru a inspecta și extrage date din fișiere PST/OST. Pentru utilizare programatică, legați-vă de biblioteca compilată în aplicația dumneavoastră C/C++. Biblioteca este ușoară și are dependențe externe minime, făcând-o potrivită pentru medii încorporate sau forensice.

Instalați libpff prin compilare din sursă

git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install

Extrageți e‑mailuri și atașamente din fișiere PST

libpff oferă funcționalitate robustă pentru a analiza fișiere PST și a extrage mesaje de e‑mail individuale împreună cu atașamentele lor. Dezvoltatorii pot parcurge ierarhia de foldere, accesa proprietățile mesajelor (de exemplu, subiect, expeditor, destinatari, marcaje de timp) și exporta conținutul MIME brut sau date structurate. Biblioteca suportă atât codificări de șiruri ANSI, cât și Unicode, asigurând compatibilitatea cu versiunile Outlook din anii 1990 până la cele moderne. De asemenea, gestionează fișierele OST comprimate (DEFLATE pe pagini de 4K), care sunt comune în versiunile mai noi ale Outlook. Acest lucru face ca libpff să fie ideal pentru instrumente de migrare a e‑mailurilor, platforme de e‑discovery și analiză criminalistică, unde extragerea precisă a corpurilor mesajelor și a atașamentelor este critică. API‑ul expune acces de nivel scăzut la proprietățile MAPI, permițând un control detaliat asupra recuperării datelor.

Cum să extrageți e‑mailuri dintr-un fișier PST prin 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);

Analiză criminalistică a fișierelor Outlook corupte

libpff include capabilități specializate pentru analiza criminalistică a fișierelor Outlook deteriorate sau parțial corupte. Poate analiza fișiere cu antete lipsă sau inconsistente, recupera elemente orfane și reconstrui arbori de mesaje chiar și atunci când indexurile interne sunt defecte. Biblioteca suportă fișiere cu tipul de criptare "none" și poate ocoli anumite erori structurale pentru a extrage date utilizabile. Acest lucru este deosebit de valoros în investigațiile de criminalistică digitală în care dovezile pot rezida în fișiere PST/OST degradate. libpff oferă, de asemenea, jurnalizare detaliată și raportare a erorilor, permițând analiștilor să urmărească deciziile de parsare și să identifice punctele de pierdere a datelor. Împreună cu extragerea proprietăților MAPI, libpff servește ca o bază fiabilă pentru construirea de instrumente criminalistice care respectă standardele legale și de conformitate.

Cum să recuperezi elementele dintr-un fișier PST corupt?

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);

Analizați proprietățile și metadatele MAPI

libpff permite o inspecție profundă a proprietăților MAPI încorporate în elementele Outlook. Dezvoltatorii pot recupera proprietăți standard precum `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME` și proprietăți personalizate definite de aplicații. Biblioteca expune un API de set de proprietăți care permite iterarea peste toate proprietățile unui mesaj, folder sau atașament. Acest lucru este esențial pentru aplicațiile care necesită audit de conformitate, extragere de metadate sau integrare cu sisteme bazate pe MAPI. libpff suportă atât identificatori de proprietăți numiți, cât și numerici și gestionează tipuri de valori pe 32‑bit și 64‑bit (de exemplu, șiruri, numere întregi, blob‑uri binare). Integrarea strânsă cu libfmapi asigură o interpretare corectă a definițiilor MAPI, făcându‑l potrivit pentru construirea de instrumente avansate de analiză a datelor Outlook.

Cum să extragi proprietățile MAPI dintr-un element de mesaj?

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);
}

Exportați datele în formate standard (CSV, JSON, XML)

În timp ce libpff este în principal o bibliotecă C pentru parsare la nivel scăzut, include utilitare în linia de comandă și API-uri care facilitează exportul datelor Outlook în formate larg utilizate precum CSV, JSON și XML. Instrumente precum `pffexport` pot converti conținutul PST/OST în fișiere text structurate, păstrând ierarhia folderelor și metadatele mesajelor. Dezvoltatorii pot, de asemenea, să folosească biblioteca programatic pentru a construi exportatoare personalizate—de exemplu, maparea proprietăților MAPI în obiecte JSON pentru ingestia în motoare de căutare sau platforme de analiză. Această capacitate de export este crucială pentru migrarea datelor, backup și integrarea cu servicii cloud moderne care necesită formate de intrare standardizate. Designul flexibil al libpff permite dezvoltatorilor să adapteze logica de export la cerințe specifice de conformitate sau flux de lucru.

Cum să exporți conținutul PST în JSON prin 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
 Română