
libpff
Otwarta biblioteka C dla formatów plików Outlook
Odczytuj, analizuj i wyodrębniaj dane z plików PST, OST, PAB i OFF za pomocą darmowego otwartoźródłowego API C.
Czym jest libpff?
libpff to potężna otwarto‑źródłowa biblioteka w języku C, zaprojektowana do dostępu do formatów Personal Folder File (PFF) i Offline Folder File (OFF) używanych przez Microsoft Outlook. Umożliwia programistom programowe odczytywanie, analizowanie i wyodrębnianie e‑maili, kontaktów, elementów kalendarza oraz innych danych przechowywanych w plikach PST, OST, PAB i OFF. Biblioteka obsługuje zarówno 32‑bitowe kodowanie ANSI, jak i 64‑bitowe Unicode, a także skompresowane formaty, takie jak 4‑K‑stronicowe pliki OST skompresowane metodą DEFLATE, wprowadzone w Outlook 2013. Dzięki solidnemu silnikowi parsowania, libpff jest szczególnie przydatna w cyfrowej kryminalistyce, migracji poczty elektronicznej i procesach odzyskiwania danych.
Biblioteka jest aktywnie utrzymywana na licencji LGPL-3.0-or-later i obecnie处于 statusie alfa, co oznacza, że jest funkcjonalna, ale może brakować pełnej kompletności funkcji lub stabilności do użycia produkcyjnego. Zawiera narzędzia do odzyskiwania elementów i może obsługiwać uszkodzone lub zaszyfrowane pliki, w których typ szyfrowania to brak. libpff integruje się również z powiązanymi projektami, takimi jak libfmapi, dla definicji MAPI i dostarcza szczegółową dokumentację forensic, aby pomóc w analizie złożonych struktur plików Outlook. Programiści mogą kompilować ze źródeł lub używać gotowych binarek, a projekt jest hostowany na GitHub w celu wkładu społeczności i śledzenia zgłoszeń.
Rozpoczęcie pracy z libpff
Aby rozpocząć korzystanie z libpff, możesz sklonować kod źródłowy z oficjalnego repozytorium [libpff GitHub](https://github.com/libyal/libpff) i zbudować go przy użyciu CMake lub autotools. Prekompilowane binaria nie są oficjalnie dystrybuowane, więc budowanie ze źródeł jest zalecanym podejściem. Projekt zawiera szczegółowe instrukcje budowania oraz zależności, takie jak libyal/libcerror i libyal/libcdata. Po zbudowaniu możesz używać dostarczonych narzędzi wiersza poleceń (np. `pffexport`, `pffinfo`), aby przeglądać i wyodrębniać dane z plików PST/OST. Do użytku programistycznego linkuj przeciwko skompilowanej bibliotece w swojej aplikacji C/C++. Biblioteka jest lekka i ma minimalne zewnętrzne zależności, co czyni ją odpowiednią dla środowisk wbudowanych lub forensycznych.
Instalacja libpff poprzez kompilację ze źródeł
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
Wyodrębnianie e‑maili i załączników z plików PST
libpff zapewnia solidną funkcjonalność do parsowania plików PST i wyodrębniania pojedynczych wiadomości e-mail wraz z ich załącznikami. Programiści mogą przeglądać hierarchię folderów, uzyskiwać dostęp do właściwości wiadomości (np. temat, nadawca, odbiorcy, znaczniki czasu) oraz eksportować surową zawartość MIME lub dane strukturalne. Biblioteka obsługuje zarówno kodowanie ANSI, jak i Unicode, zapewniając kompatybilność z wersjami Outlooka od lat 90. XX do współczesnych wydań. Obsługuje także skompresowane pliki OST (DEFLATE o rozmiarze strony 4K), które są powszechne w nowszych wersjach Outlooka. To sprawia, że libpff jest idealny dla narzędzi migracji poczty, platform e-discovery oraz analizy kryminalistycznej, gdzie dokładne wyodrębnianie treści wiadomości i załączników jest kluczowe. API udostępnia niskopoziomowy dostęp do właściwości MAPI, umożliwiając precyzyjną kontrolę nad pobieraniem danych.
Jak wyodrębnić e‑maile z pliku PST przy użyciu 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);
Analiza kryminalistyczna uszkodzonych plików Outlook
libpff zawiera specjalistyczne możliwości analizy forensic uszkodzonych lub częściowo uszkodzonych plików Outlook. Potrafi parsować pliki z brakującymi lub niespójnymi nagłówkami, odzyskiwać osierocone elementy oraz odtwarzać drzewa wiadomości nawet wtedy, gdy wewnętrzne indeksy są uszkodzone. Biblioteka obsługuje pliki z typem szyfrowania "none" i może obejść niektóre błędy strukturalne, aby wydobyć użyteczne dane. Jest to szczególnie cenne w dochodzeniach cyfrowej kryminalistyki, gdzie dowody mogą znajdować się w zdegradowanych plikach PST/OST. libpff zapewnia także szczegółowe logowanie i raportowanie błędów, umożliwiając analitykom śledzenie decyzji parsowania i identyfikację punktów utraty danych. W połączeniu z ekstrakcją właściwości MAPI, libpff stanowi niezawodną podstawę do budowania narzędzi forensic, które spełniają wymogi prawne i zgodności.
Jak odzyskać elementy z uszkodzonego pliku 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);
Analiza właściwości i metadanych MAPI
libpff umożliwia dogłębną inspekcję właściwości MAPI osadzonych w elementach Outlooka. Programiści mogą pobierać standardowe właściwości, takie jak `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, oraz własne właściwości definiowane przez aplikacje. Biblioteka udostępnia interfejs API zestawu właściwości, który pozwala na iterację po wszystkich właściwościach wiadomości, folderu lub załącznika. Jest to niezbędne dla aplikacji wymagających audytu zgodności, ekstrakcji metadanych lub integracji z systemami opartymi na MAPI. libpff obsługuje zarówno nazwane, jak i numeryczne identyfikatory właściwości oraz obsługuje typy wartości 32‑bitowe i 64‑bitowe (np. ciągi znaków, liczby całkowite, binarne blob-y). Ścisła integracja z libfmapi zapewnia dokładną interpretację definicji MAPI, co czyni ją odpowiednią do budowania zaawansowanych narzędzi analizy danych Outlooka.
Jak wyodrębnić właściwości MAPI z elementu wiadomości?
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);
}
Eksport danych do standardowych formatów (CSV, JSON, XML)
Podczas gdy libpff jest przede wszystkim biblioteką C do niskopoziomowego parsowania, zawiera narzędzia wiersza poleceń i interfejsy API ułatwiające eksport danych Outlooka do powszechnie używanych formatów, takich jak CSV, JSON i XML. Narzędzia takie jak `pffexport` mogą konwertować zawartość PST/OST na ustrukturyzowane pliki tekstowe, zachowując hierarchię folderów i metadane wiadomości. Programiści mogą również używać biblioteki programowo do budowania własnych eksporterów — np. mapując właściwości MAPI na obiekty JSON do wprowadzania ich do silników wyszukiwania lub platform analitycznych. Ta możliwość eksportu jest kluczowa dla migracji danych, tworzenia kopii zapasowych i integracji z nowoczesnymi usługami chmurowymi, które wymagają ustandaryzowanych formatów wejściowych. Elastyczna konstrukcja libpff pozwala programistom dostosować logikę eksportu do konkretnych wymagań zgodności lub przepływu pracy.
Jak wyeksportować zawartość PST do formatu JSON za pomocą interfejsu wiersza poleceń (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
