
libpff
Бібліотека C з відкритим кодом для форматів файлів Outlook
Читання, аналіз та вилучення даних з файлів PST, OST, PAB та OFF за допомогою безкоштовного API C з відкритим кодом.
Що таке 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 і currently处于 статусі альфа, що означає, що вона функціональна, але може не мати повної функціональності або стабільності для використання у продакшн. Вона включає інструменти для відновлення елементів і може обробляти пошкоджені або зашифровані файли, де тип шифрування — відсутній. 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, починаючи з 1990‑х років і до сучасних випусків. Вона також обробляє стиснені 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
