1. produkty
  2.   E-mailem
  3.   C++
  4.   libpff

libpff

 
 

Open source knihovna v C pro formáty souborů Outlook

Čtěte, analyzujte a extrahujte data ze souborů PST, OST, PAB a OFF pomocí bezplatného open source C API.

Co je libpff?

libpff je výkonná open source knihovna v jazyce C navržená pro přístup k formátům Personal Folder File (PFF) a Offline Folder File (OFF), které používá Microsoft Outlook. Umožňuje vývojářům programově číst, parsovat a extrahovat e‑mail, kontakty, položky kalendáře a další data uložená v souborech PST, OST, PAB a OFF. Knihovna podporuje jak 32‑bitové kódování ANSI, tak 64‑bitové Unicode řetězce, stejně jako komprimované formáty, například 4K‑stránkové DEFLATE‑komprimované soubory OST zavedené v Outlooku 2013. Díky svému robustnímu parsovacímu enginu je libpff zvláště cenná v digitální forenzice, migraci e‑mailů a pracovních postupech obnovy dat.

Knihovna je aktivně udržována pod licencí LGPL-3.0-or-later a aktuálně je v alfa stavu, což znamená, že je funkční, ale může postrádat úplnou sadu funkcí nebo stabilitu pro produkční použití. Obsahuje nástroje pro obnovu položek a dokáže zpracovat poškozené nebo šifrované soubory, kde typ šifrování je žádný. libpff také integruje související projekty, jako je libfmapi pro definice MAPI, a poskytuje podrobnou forenzní dokumentaci, která pomáhá analyzovat složité struktury souborů Outlook. Vývojáři mohou sestavit ze zdrojového kódu nebo použít předkompilované binární soubory a projekt je hostován na GitHubu pro příspěvky komunity a sledování problémů.

Previous Next

Začínáme s libpff

Chcete-li začít používat libpff, můžete klonovat zdrojový kód z jeho oficiálního [libpff GitHub](https://github.com/libyal/libpff) repozitáře a sestavit jej pomocí CMake nebo autotools. Předkompilované binární soubory nejsou oficiálně distribuovány, takže doporučeným přístupem je sestavení ze zdroje. Projekt obsahuje podrobné pokyny pro sestavení a závislosti jako libyal/libcerror a libyal/libcdata. Po sestavení můžete použít dodané nástroje příkazové řádky (např. `pffexport`, `pffinfo`) k prohlížení a extrahování dat ze souborů PST/OST. Pro programové použití odkažte na zkompilovanou knihovnu ve své C/C++ aplikaci. Knihovna je lehká a má minimální externí závislosti, což ji činí vhodnou pro vestavěná nebo forenzní prostředí.

Instalovat libpff pomocí sestavení ze zdrojového kódu

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

Extrahovat e-maily a přílohy ze souborů PST

libpff poskytuje robustní funkčnost pro analýzu souborů PST a extrakci jednotlivých e‑mailových zpráv spolu s jejich přílohami. Vývojáři mohou procházet hierarchii složek, přistupovat k vlastnostem zpráv (např. předmět, odesílatel, příjemci, časová razítka) a exportovat surový obsah MIME nebo strukturovaná data. Knihovna podporuje jak kódování řetězců ANSI, tak Unicode, což zajišťuje kompatibilitu s verzemi Outlooku od 90. let až po moderní vydání. Také zvládá komprimované soubory OST (4K‑stránkový DEFLATE), které jsou běžné v novějších verzích Outlooku. To činí libpff ideální pro nástroje pro migraci e‑mailů, platformy e‑discovery a forenzní analýzu, kde je kritická přesná extrakce těla zpráv a příloh. API poskytuje nízkoúrovňový přístup k vlastnostem MAPI, umožňující detailní kontrolu nad získáváním dat.

Jak extrahovat e-maily ze souboru PST pomocí C API?

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

Forenzní analýza poškozených souborů Outlook

libpff zahrnuje specializované schopnosti pro forenzní analýzu poškozených nebo částečně poškozených souborů Outlook. Dokáže parsovat soubory s chybějícími nebo nekonzistentními hlavičkami, obnovit osiřelé položky a rekonstruovat strom zpráv i když jsou interní indexy poškozené. Knihovna podporuje soubory s typem šifrování "none" a může obejít určité strukturální chyby k extrakci použitelné dat. To je zvláště cenné při digitálních forenzních vyšetřováních, kde mohou důkazy spočívat v degradovaných souborech PST/OST. libpff také poskytuje podrobné protokolování a hlášení chyb, což analytikům umožňuje sledovat rozhodnutí při parsování a identifikovat místa ztráty dat. V kombinaci s extrakcí MAPI vlastností slouží libpff jako spolehlivý základ pro tvorbu forenzních nástrojů, které splňují právní a souladové standardy.

Jak obnovit položky z poškozeného souboru PST?

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

Analyzovat MAPI vlastnosti a metadata

libpff umožňuje hlubokou inspekci MAPI vlastností vložených v položkách Outlooku. Vývojáři mohou získat standardní vlastnosti jako `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME` a vlastní vlastnosti definované aplikacemi. Knihovna poskytuje API sady vlastností, které umožňuje iteraci přes všechny vlastnosti zprávy, složky nebo přílohy. To je nezbytné pro aplikace vyžadující audit shody, extrakci metadat nebo integraci se systémy založenými na MAPI. libpff podporuje jak pojmenované, tak číselné identifikátory vlastností a zpracovává jak 32‑bitové, tak 64‑bitové typy hodnot (např. řetězce, celá čísla, binární bloky). Jeho úzká integrace s libfmapi zajišťuje přesnou interpretaci definic MAPI, což jej činí vhodným pro tvorbu pokročilých nástrojů pro analýzu dat Outlooku.

Jak extrahovat MAPI vlastnosti z položky zprávy?

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

Exportovat data do standardních formátů (CSV, JSON, XML)

Zatímco libpff je především knihovna v jazyce C pro nízkoúrovňové parsování, zahrnuje nástroje příkazové řádky a API, které usnadňují export dat Outlooku do široce používaných formátů, jako jsou CSV, JSON a XML. Nástroje jako `pffexport` mohou převádět obsah PST/OST do strukturovaných textových souborů, přičemž zachovávají hierarchii složek a metadata zpráv. Vývojáři mohou také knihovnu programově použít k vytvoření vlastních exportérů — např. mapováním MAPI vlastností na JSON objekty pro ingestování do vyhledávačů nebo analytických platforem. Tato exportní schopnost je klíčová pro migraci dat, zálohování a integraci s moderními cloudovými službami, které vyžadují standardizované vstupní formáty. Flexibilní design libpff umožňuje vývojářům přizpůsobit exportní logiku konkrétním požadavkům na soulad nebo pracovní postupy.

Jak exportovat obsah PST do JSON pomocí 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
 Čeština