
libpff
Perpustakaan C Sumber Terbuka untuk Format File Outlook
Baca, Urai & Ekstrak Data dari File PST, OST, PAB & OFF melalui API C Gratis Sumber Terbuka.
Apa itu libpff?
libpff adalah perpustakaan C sumber terbuka yang kuat dirancang untuk mengakses format Personal Folder File (PFF) dan Offline Folder File (OFF) yang digunakan oleh Microsoft Outlook. Ini memungkinkan pengembang untuk secara programatis membaca, mengurai, dan mengekstrak email, kontak, item kalender, serta data lain yang disimpan dalam file PST, OST, PAB, dan OFF. Perpustakaan ini mendukung enkoding string ANSI 32-bit dan Unicode 64-bit, serta format terkompresi seperti file OST yang dikompresi DEFLATE berukuran 4K halaman yang diperkenalkan di Outlook 2013. Dengan mesin penguraian yang kuat, libpff sangat berharga dalam forensik digital, migrasi email, dan alur kerja pemulihan data.
Pustaka ini secara aktif dipelihara di bawah lisensi LGPL-3.0-or-later dan saat ini berada dalam status alfa, yang berarti fungsional tetapi mungkin belum memiliki kelengkapan fitur penuh atau stabilitas untuk penggunaan produksi. Ini mencakup alat untuk pemulihan item dan dapat menangani file yang rusak atau terenkripsi di mana jenis enkripsi adalah none. libpff juga terintegrasi dengan proyek terkait seperti libfmapi untuk definisi MAPI dan menyediakan dokumentasi forensik terperinci untuk membantu menganalisis struktur file Outlook yang kompleks. Pengembang dapat membangun dari sumber atau menggunakan binari yang telah dikompilasi sebelumnya, dan proyek ini dihosting di GitHub untuk kontribusi komunitas serta pelacakan isu.
Memulai dengan libpff
Untuk mulai menggunakan libpff, Anda dapat mengkloning kode sumber dari repositori resmi [libpff GitHub](https://github.com/libyal/libpff) dan membangunnya menggunakan CMake atau autotools. Biner yang telah dikompilasi sebelumnya tidak didistribusikan secara resmi, sehingga membangun dari sumber merupakan pendekatan yang disarankan. Proyek ini menyertakan instruksi build yang detail serta dependensi seperti libyal/libcerror dan libyal/libcdata. Setelah dibangun, Anda dapat menggunakan alat baris perintah yang disediakan (misalnya `pffexport`, `pffinfo`) untuk memeriksa dan mengekstrak data dari file PST/OST. Untuk penggunaan programatik, tautkan terhadap perpustakaan yang telah dikompilasi dalam aplikasi C/C++ Anda. Perpustakaan ini ringan dan memiliki dependensi eksternal yang minimal, menjadikannya cocok untuk lingkungan tertanam atau forensik.
Instal libpff melalui Build Sumber
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
Ekstrak Email dan Lampiran dari File PST
libpff menyediakan fungsionalitas yang kuat untuk mengurai file PST dan mengekstrak pesan email individu beserta lampirannya. Pengembang dapat menelusuri hierarki folder, mengakses properti pesan (mis., subjek, pengirim, penerima, cap waktu), dan mengekspor konten MIME mentah atau data terstruktur. Perpustakaan ini mendukung enkoding string ANSI dan Unicode, memastikan kompatibilitas dengan versi Outlook dari tahun 1990-an hingga rilis modern. Ia juga menangani file OST terkompresi (DEFLATE halaman 4K), yang umum pada versi Outlook yang lebih baru. Hal ini menjadikan libpff ideal untuk alat migrasi email, platform e-discovery, dan analisis forensik di mana ekstraksi yang akurat dari isi pesan dan lampiran sangat penting. API menyediakan akses tingkat rendah ke properti MAPI, memungkinkan kontrol yang halus atas pengambilan data.
Cara Mengekstrak Email dari File PST melalui 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);
Analisis Forensik File Outlook yang Rusak
libpff mencakup kemampuan khusus untuk analisis forensik file Outlook yang rusak atau sebagian korup. Ia dapat mengurai file dengan header yang hilang atau tidak konsisten, memulihkan item yang terasing, dan membangun kembali pohon pesan bahkan ketika indeks internal rusak. Perpustakaan ini mendukung file dengan tipe enkripsi "none" dan dapat melewati beberapa kesalahan struktural untuk mengekstrak data yang dapat digunakan. Hal ini sangat berharga dalam penyelidikan forensik digital di mana bukti dapat berada dalam file PST/OST yang terdegradasi. libpff juga menyediakan pencatatan terperinci dan pelaporan kesalahan, memungkinkan analis melacak keputusan penguraian dan mengidentifikasi titik kehilangan data. Dikombinasikan dengan ekstraksi properti MAPI-nya, libpff berfungsi sebagai fondasi yang dapat diandalkan untuk membangun alat forensik yang memenuhi standar hukum dan kepatuhan.
Cara Memulihkan Item dari File PST yang Rusak?
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);
Mengurai Properti dan Metadata MAPI
libpff memungkinkan inspeksi mendalam terhadap properti MAPI yang tertanam dalam item Outlook. Pengembang dapat mengambil properti standar seperti `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, dan properti khusus yang didefinisikan oleh aplikasi. Perpustakaan ini menyediakan API set properti yang memungkinkan iterasi atas semua properti dari pesan, folder, atau lampiran. Ini penting bagi aplikasi yang memerlukan audit kepatuhan, ekstraksi metadata, atau integrasi dengan sistem berbasis MAPI. libpff mendukung baik pengidentifikasi properti bernama maupun numerik, dan menangani tipe nilai 32-bit dan 64-bit (mis., string, integer, binary blob). Integrasi ketatnya dengan libfmapi memastikan interpretasi yang akurat dari definisi MAPI, menjadikannya cocok untuk membangun alat analisis data Outlook tingkat lanjut.
Cara Mengekstrak Properti MAPI dari Item Pesan?
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);
}
Ekspor Data ke Format Standar (CSV, JSON, XML)
Sementara libpff pada dasarnya adalah perpustakaan C untuk penguraian tingkat rendah, ia menyertakan utilitas baris perintah dan API yang memudahkan pengeksporan data Outlook ke format yang banyak digunakan seperti CSV, JSON, dan XML. Alat seperti `pffexport` dapat mengonversi konten PST/OST menjadi file teks terstruktur, mempertahankan hierarki folder dan metadata pesan. Pengembang juga dapat menggunakan perpustakaan ini secara programatik untuk membangun pengekspor khusus—misalnya, memetakan properti MAPI ke objek JSON untuk dimasukkan ke dalam mesin pencari atau platform analitik. Kemampuan ekspor ini sangat penting untuk migrasi data, pencadangan, dan integrasi dengan layanan cloud modern yang memerlukan format input standar. Desain fleksibel libpff memungkinkan pengembang menyesuaikan logika ekspor dengan persyaratan kepatuhan atau alur kerja tertentu.
Cara Mengekspor Konten PST ke JSON melalui 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
