
libpff
Отворена C библиотека за файлови формати на Outlook
Четете, анализирайте и извличайте данни от PST, OST, PAB и OFF файлове чрез безплатен отворен C API.
Какво е libpff?
libpff е мощна отворена C библиотека, създадена за достъп до формати Personal Folder File (PFF) и Offline Folder File (OFF), използвани от Microsoft Outlook. Тя позволява на разработчиците програмен достъп за четене, парсиране и извличане на имейли, контакти, календарни елементи и други данни, съхранени в PST, OST, PAB и OFF файлове. Библиотеката поддържа както 32‑битови ANSI, така и 64‑битови Unicode кодировки на низове, както и компресирани формати като 4K‑странични DEFLATE‑компресирани OST файлове, въведени в Outlook 2013. Със своя надежден парсиращ двигател, libpff е особено ценна в цифрова съдебна експертиза, миграция на имейли и процеси по възстановяване на данни.
Библиотеката се поддържа активно под лиценз LGPL-3.0-or-later и в момента се намира в алфа статус, което означава, че е функционална, но може да липсва пълна пълнота на функциите или стабилност за продукционна употреба. Тя включва инструменти за възстановяване на елементи и може да обработва повредени или криптирани файлове, при които типът на криптирането е none. libpff също се интегрира със свързани проекти като libfmapi за MAPI дефиниции и предоставя подробна форензична документация, за да помогне при анализа на сложни структури на Outlook файлове. Разработчиците могат да компилират от изходния код или да използват предварително компилирани бинарни файлове, а проектът е хостван в GitHub за общностни приноси и проследяване на проблеми.
Започване с libpff
За да започнете да използвате libpff, можете да клонирате изходния код от официалното [libpff GitHub](https://github.com/libyal/libpff) хранилище и да го изградите с помощта на CMake или autotools. Предварително компилираните бинарни файлове не се разпространяват официално, затова изграждането от източника е препоръчителният подход. Проектът включва подробни инструкции за изграждане и зависимости като libyal/libcerror и libyal/libcdata. След като бъде изграден, можете да използвате предоставените инструменти за команден ред (например `pffexport`, `pffinfo`), за да преглеждате и извличате данни от PST/OST файлове. За програмно използване, линквайте към компилираната библиотека във вашето C/C++ приложение. Библиотеката е лека и има минимални външни зависимости, което я прави подходяща за вградени или съдебно‑форензични среди.
Инсталиране на libpff чрез компилация от изходен код
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
Извличане на имейли и прикачени файлове от PST файлове
libpff предоставя мощна функционалност за анализиране на PST файлове и извличане на отделни имейл съобщения заедно с техните прикачени файлове. Разработчиците могат да навигират в йерархията на папките, да достъпват свойства на съобщенията (например тема, подател, получатели, времеви марки) и да експортират сурово MIME съдържание или структурирани данни. Библиотеката поддържа както ANSI, така и Unicode кодиране на низове, осигурявайки съвместимост с версии на Outlook от 90‑те години до съвременните издания. Тя също така обработва компресирани OST файлове (4K‑страница DEFLATE), които са чести в по‑новите версии на Outlook. Това прави libpff идеален за инструменти за миграция на имейли, e‑discovery платформи и съдебно‑форензичен анализ, където точното извличане на съдържанието на съобщенията и прикачените файлове е от съществено значение. API‑то предоставя ниско ниво на достъп до MAPI свойства, позволявайки фино управление на извличането на данни.
Как да извлечете имейли от PST файл чрез 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);
Съдебен анализ на повредени Outlook файлове
libpff включва специализирани възможности за форензичен анализ на повредени или частично корумпирани Outlook файлове. Той може да анализира файлове с липсващи или несъответстващи заглавки, да възстанови осиротени елементи и да реконструира дървета на съобщения дори когато вътрешните индекси са повредени. Библиотеката поддържа файлове с тип шифроване "none" и може да заобиколи определени структурни грешки, за да извлече използваеми данни. Това е особено ценно в дигиталните форензични разследвания, където доказателствата могат да се намират в деградирани PST/OST файлове. libpff също предоставя подробен журнал и докладване на грешки, позволявайки на анализаторите да проследяват решенията по парсиране и да идентифицират точките на загуба на данни. В комбинация с извличането на MAPI свойства, libpff служи като надеждна основа за създаване на форензични инструменти, които отговарят на правни и регулаторни стандарти.
Как да възстановим елементи от повреден 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);
Разбор на MAPI свойства и метаданни
libpff позволява дълбока инспекция на MAPI свойства, вградени в Outlook елементи. Разработчиците могат да извличат стандартни свойства като `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME` и персонализирани свойства, дефинирани от приложения. Библиотеката предоставя API за набор от свойства, което позволява итериране върху всички свойства на съобщение, папка или прикачен файл. Това е от съществено значение за приложения, изискващи одит за съответствие, извличане на метаданни или интеграция с MAPI-базирани системи. libpff поддържа както именовани, така и числови идентификатори на свойства и обработва както 32-битови, така и 64-битови типове стойности (например низове, цели числа, бинарни блобове). Тясната му интеграция с libfmapi осигурява точно тълкуване на MAPI дефинициите, което го прави подходящ за създаване на напреднали инструменти за анализ на данни от Outlook.
Как да извлечете MAPI свойства от елемент на съобщение?
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);
}
Експортиране на данни в стандартни формати (CSV, JSON, XML)
Докато libpff е предимно C библиотека за ниско ниво парсиране, тя включва командни инструменти и API‑та, които улесняват експортирането на данни от Outlook към широко използвани формати като CSV, JSON и XML. Инструменти като `pffexport` могат да конвертират съдържанието на PST/OST файлове в структурирани текстови файлове, запазвайки йерархията на папките и метаданните на съобщенията. Разработчиците също могат да използват библиотеката програмно за създаване на персонализирани експортери — например, картографиране на MAPI свойства към JSON обекти за вмъкване в търсачки или аналитични платформи. Тази възможност за експортиране е от съществено значение за миграция на данни, резервни копия и интеграция с модерни облачни услуги, които изискват стандартизирани входни формати. Гъвкавият дизайн на libpff позволява на разработчиците да адаптират логиката за експортиране към специфични изисквания за съответствие или работни процеси.
Как да експортирате съдържанието на PST в JSON чрез 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
