1. Produk
  2.   E-mel
  3.   C++
  4.   libpff

libpff

 
 

Perpustakaan C Sumber Terbuka untuk Format Fail Outlook

Baca, Hurai & Ekstrak Data daripada Fail PST, OST, PAB & OFF melalui API C Sumber Terbuka Percuma.

Apakah libpff?

libpff ialah perpustakaan C sumber terbuka yang kuat direka untuk mengakses format Personal Folder File (PFF) dan Offline Folder File (OFF) yang digunakan oleh Microsoft Outlook. Ia membolehkan pembangun membaca, mengurai, dan mengekstrak e-mel, kenalan, item kalendar, serta data lain yang disimpan dalam fail PST, OST, PAB, dan OFF secara programatik. Perpustakaan ini menyokong pengekodan rentetan ANSI 32-bit dan Unicode 64-bit, serta format termampat seperti fail OST berkompres DEFLATE 4K-halaman yang diperkenalkan dalam Outlook 2013. Dengan enjin penguraian yang kukuh, libpff sangat berharga dalam forensik digital, migrasi e-mel, dan aliran kerja pemulihan data.

Perpustakaan ini diselenggarakan secara aktif di bawah lesen LGPL-3.0-atau-seterusnya dan kini berada dalam status alfa, yang bermaksud ia berfungsi tetapi mungkin tidak mempunyai kesempurnaan ciri penuh atau kestabilan untuk penggunaan produksi. Ia termasuk alat untuk pemulihan item dan boleh mengendalikan fail yang rosak atau disulitkan di mana jenis penyulitan adalah tiada. libpff juga berintegrasi dengan projek berkaitan seperti libfmapi untuk definisi MAPI dan menyediakan dokumentasi forensik terperinci untuk membantu menganalisis struktur fail Outlook yang kompleks. Pembangun boleh membina dari sumber atau menggunakan binari pra-kompilasi, dan projek ini dihoskan di GitHub untuk sumbangan komuniti serta penjejakan isu.

Previous Next

Mula Menggunakan libpff

Untuk mula menggunakan libpff, anda boleh menyalin kod sumber dari repositori [libpff GitHub](https://github.com/libyal/libpff) rasmi dan membinanya menggunakan CMake atau autotools. Binari pra‑kompilasi tidak diedarkan secara rasmi, jadi membina dari sumber adalah pendekatan yang disarankan. Projek ini termasuk arahan bina terperinci dan kebergantungan seperti libyal/libcerror dan libyal/libcdata. Setelah dibina, anda boleh menggunakan alat baris perintah yang disediakan (contoh, `pffexport`, `pffinfo`) untuk memeriksa dan mengekstrak data daripada fail PST/OST. Untuk penggunaan programatik, pautkan terhadap perpustakaan yang telah dikompilasi dalam aplikasi C/C++ anda. Perpustakaan ini ringan dan mempunyai kebergantungan luaran yang minimum, menjadikannya sesuai untuk persekitaran terbenam atau forensik.

Pasang libpff melalui Binaan Sumber

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

Ekstrak E-mel dan Lampiran daripada Fail PST

libpff menyediakan fungsi yang kukuh untuk mengurai fail PST dan mengekstrak mesej e-mel individu bersama lampirannya. Pembangun boleh menelusuri hierarki folder, mengakses sifat mesej (contohnya, subjek, penghantar, penerima, cap masa), dan mengeksport kandungan MIME mentah atau data berstruktur. Perpustakaan ini menyokong pengekodan rentetan ANSI dan Unicode, memastikan keserasian dengan versi Outlook dari tahun 1990-an hingga keluaran moden. Ia juga mengendalikan fail OST termampat (DEFLATE 4K-halaman), yang biasa dalam versi Outlook yang lebih baru. Ini menjadikan libpff ideal untuk alat migrasi e-mel, platform e-discovery, dan analisis forensik di mana pengekstrakan tepat badan mesej dan lampiran adalah kritikal. API memaparkan akses peringkat rendah kepada sifat MAPI, membolehkan kawalan terperinci ke atas pengambilan data.

Bagaimana untuk Mengekstrak E-mel daripada Fail 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 Fail Outlook yang Rosak

libpff termasuk keupayaan khusus untuk analisis forensik fail Outlook yang rosak atau sebahagiannya rosak. Ia boleh mengurai fail dengan tajuk yang hilang atau tidak konsisten, memulihkan item yang terasing, dan membina semula pokok mesej walaupun indeks dalaman rosak. Perpustakaan ini menyokong fail dengan jenis penyulitan "none" dan boleh melangkau beberapa ralat struktur untuk mengekstrak data yang boleh digunakan. Ini sangat berharga dalam penyiasatan forensik digital di mana bukti mungkin berada dalam fail PST/OST yang terdegradasi. libpff juga menyediakan log terperinci dan pelaporan ralat, membolehkan penganalisis menjejaki keputusan penguraian dan mengenal pasti titik kehilangan data. Digabungkan dengan pengekstrakan sifat MAPI, libpff berfungsi sebagai asas yang boleh dipercayai untuk membina alat forensik yang memenuhi piawaian undang-undang dan pematuhan.

Bagaimana Memulihkan Item daripada Fail PST yang Rosak?

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

Menghurai Sifat MAPI dan Metadata

libpff membolehkan pemeriksaan mendalam terhadap sifat MAPI yang terbenam dalam item Outlook. Pembangun boleh mendapatkan sifat standard seperti `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, dan sifat khusus yang ditakrifkan oleh aplikasi. Perpustakaan ini memaparkan API set sifat yang membolehkan iterasi ke atas semua sifat mesej, folder, atau lampiran. Ini penting untuk aplikasi yang memerlukan audit pematuhan, pengekstrakan metadata, atau integrasi dengan sistem berasaskan MAPI. libpff menyokong kedua-dua pengecam sifat bernama dan berangka, serta mengendalikan kedua-dua jenis nilai 32-bit dan 64-bit (contohnya, rentetan, integer, blob binari). Integrasi rapatnya dengan libfmapi memastikan tafsiran tepat definisi MAPI, menjadikannya sesuai untuk membina alat analisis data Outlook yang maju.

Bagaimana Mengekstrak Sifat MAPI daripada Item Mesej?

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 Data ke Format Piawai (CSV, JSON, XML)

Sementara libpff pada dasarnya merupakan perpustakaan C untuk penguraian peringkat rendah, ia menyertakan utiliti baris perintah dan API yang memudahkan pengeksportan data Outlook ke format yang banyak digunakan seperti CSV, JSON, dan XML. Alat seperti `pffexport` dapat menukar kandungan PST/OST menjadi fail teks berstruktur, mengekalkan hierarki folder dan metadata mesej. Pembangun juga boleh menggunakan perpustakaan ini secara programatik untuk membina pengeksport tersuai—contohnya, memetakan sifat MAPI ke objek JSON untuk dimasukkan ke dalam enjin carian atau platform analitik. Keupayaan pengeksportan ini penting untuk migrasi data, sandaran, dan integrasi dengan perkhidmatan awan moden yang memerlukan format input piawai. Reka bentuk fleksibel libpff membolehkan pembangun menyesuaikan logik pengeksport mengikut keperluan pematuhan atau aliran kerja tertentu.

Bagaimana Mengeksport Kandungan 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
 Melayu