1. Produkti
  2.   E-pasts
  3.   C++
  4.   libpff

libpff

 
 

Atvērtā koda C bibliotēka Outlook failu formātiem

Lasiet, parsējiet & izgūstiet datus no PST, OST, PAB & OFF failiem, izmantojot bezmaksas atvērtā koda C API.

Kas ir libpff?

libpff ir jaudīga atvērtā koda C bibliotēka, kas paredzēta Personal Folder File (PFF) un Offline Folder File (OFF) formātu piekļuvei, ko izmanto Microsoft Outlook. Tā ļauj izstrādātājiem programmatiski lasīt, parsēt un izvilkt e-pastus, kontaktus, kalendāra vienumus un citus datus, kas saglabāti PST, OST, PAB un OFF failos. Bibliotēka atbalsta gan 32-bitu ANSI, gan 64-bitu Unicode virkņu kodējumus, kā arī saspiestos formātus, piemēram, 4K lapu DEFLATE-saspiestos OST failus, kas ieviesti Outlook 2013. Ar savu stabilo parsēšanas dzinēju libpff ir īpaši vērtīga digitālās forenzikas, e-pastu migrācijas un datu atgūšanas darba plūsmās.

Bibliotēka tiek aktīvi uzturēta saskaņā ar LGPL-3.0 vai jaunāku licences nosacījumiem, un pašlaik 处于 alpha statusā, kas nozīmē, ka tā ir funkcionāla, bet var trūkt pilnīgas funkcionalitātes vai stabilitātes ražošanas lietošanai. Tā ietver rīkus vienumu atgūšanai un var apstrādāt bojātus vai šifrētus failus, kur šifrēšanas veids ir neviens. libpff arī integrējas ar saistītiem projektiem, piemēram, libfmapi MAPI definīcijām, un nodrošina detalizētu forensisko dokumentāciju, lai palīdzētu analizēt sarežģītas Outlook failu struktūras. Izstrādātāji var kompilēt no pirmkoda vai izmantot iepriekš kompilētus bināros failus, un projekts ir izvietots GitHub, lai veicinātu kopienas ieguldījumu un problēmu izsekošanu.

Previous Next

Sākums ar libpff

Lai sāktu izmantot libpff, varat klonēt avota kodu no tās oficiālā [libpff GitHub](https://github.com/libyal/libpff) krātuves un būvēt to, izmantojot CMake vai autotools. Iepriekš kompilētas bināras versijas netiek oficiāli izplatītas, tāpēc ieteicams veidot no avota. Projektā ir iekļauti detalizēti būvēšanas norādījumi un atkarības, piemēram, libyal/libcerror un libyal/libcdata. Pēc būvēšanas varat izmantot pieejamos komandrindas rīkus (piemēram, `pffexport`, `pffinfo`), lai pārbaudītu un izvilktu datus no PST/OST failiem. Programmatiskai lietošanai piesaistiet saistīto bibliotēku savā C/C++ lietojumprogrammā. Bibliotēka ir viegla un tai ir minimālas ārējās atkarības, padarot to piemērotu iegultām vai forensiskām vidēm.

Instalējiet libpff, izmantojot avota būvēšanu

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

Izgūstiet e-pastus un pielikumus no PST failiem

libpff nodrošina robustu funkcionalitāti PST failu parsēšanai un individuālu e-pasta ziņojumu izguvei kopā ar to pielikumiem. Izstrādātāji var pārvietoties pa mapju hierarhiju, piekļūt ziņojumu īpašībām (piemēram, tēmai, sūtītājam, saņēmējiem, laika zīmēm) un eksportēt neapstrādātu MIME saturu vai strukturētus datus. Bibliotēka atbalsta gan ANSI, gan Unicode virkņu kodējumus, nodrošinot saderību ar Outlook versijām no 1990. gadiem līdz mūsdienu laidieniem. Tā arī apstrādā kompresētus OST failus (4K lapu DEFLATE), kas ir izplatīti jaunākajās Outlook versijās. Tas padara libpff par ideālu e-pasta migrācijas rīkiem, e-atklāšanas platformām un forensiskajai analīzei, kur precīza ziņojumu ķermeņu un pielikumu izguve ir kritiska. API nodrošina zemā līmeņa piekļuvi MAPI īpašībām, ļaujot veikt smalku datu izgūšanas kontroli.

Kā izgūt e-pastus no PST faila, izmantojot 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);

Kriminālsanalīze bojātiem Outlook failiem

libpff ietver specializētas iespējas forensiskai bojātu vai daļēji korumpētu Outlook failu analīzei. Tas var parsēt failus ar trūkstošām vai nekonsekventām galvenēm, atgūt vientuļus elementus un rekonstruēt ziņojumu koku pat tad, ja iekšējie indeksi ir bojāti. Bibliotēka atbalsta failus ar šifrēšanas veidu "none" un var apiet noteiktas struktūras kļūdas, lai izvilktu lietojamus datus. Tas ir īpaši vērtīgi digitālās forenzikas izmeklējumos, kur pierādījumi var atrasties degradētos PST/OST failos. libpff arī nodrošina detalizētu žurnālu un kļūdu ziņošanu, ļaujot analītiķiem sekot parsēšanas lēmumiem un identificēt datu zuduma punktus. Kombinējot to ar MAPI īpašību izguvi, libpff kalpo kā uzticama pamatforma forensisko rīku izveidei, kas atbilst likuma un atbilstības standartiem.

Kā atgūt vienumus no bojāta PST faila?

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

Parsēt MAPI īpašības un metadatus

libpff ļauj veikt dziļu MAPI īpašību pārbaudi, kas ir iekļautas Outlook vienībās. Izstrādātāji var izgūt standarta īpašības, piemēram, `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, kā arī lietojumprogrammu definētās pielāgotās īpašības. Bibliotēka nodrošina īpašību kopas API, kas ļauj iterēt pār visām ziņojuma, mapes vai pielikuma īpašībām. Tas ir būtiski lietojumprogrammām, kas pieprasa atbilstības auditu, metadatu izguvi vai integrāciju ar MAPI balstītām sistēmām. libpff atbalsta gan nosauktus, gan skaitliskus īpašību identifikatorus, un apstrādā gan 32‑bitu, gan 64‑bitu vērtību tipus (piemēram, virknes, veseli skaitļi, bināri dati). Tās ciešā integrācija ar libfmapi nodrošina precīzu MAPI definīciju interpretāciju, padarot to piemērotu uzlabotu Outlook datu analīzes rīku izveidei.

Kā izvilkt MAPI īpašības no ziņojuma vienuma?

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ēt datus uz standarta formātiem (CSV, JSON, XML)

Kamēr libpff galvenokārt ir C bibliotēka zemā līmeņa parsēšanai, tā ietver komandrindas utilītus un API, kas atvieglo Outlook datu eksportēšanu plaši izmantotajos formātos, piemēram, CSV, JSON un XML. Rīki, piemēram, `pffexport`, var konvertēt PST/OST saturu strukturētos teksta failos, saglabājot mapju hierarhiju un ziņu metadatus. Izstrādātāji var arī izmantot bibliotēku programmatiski, lai izveidotu pielāgotus eksportētājus — piemēram, mapējot MAPI īpašības uz JSON objektiem, lai tos varētu izmantot meklētājprogrammu vai analītikas platformu apstrādei. Šī eksportēšanas iespēja ir būtiska datu migrācijai, rezerves kopēšanai un integrācijai ar modernajiem mākoņpakalpojumiem, kas pieprasa standartizētus ievades formātus. libpff elastīgais dizains ļauj izstrādātājiem pielāgot eksportēšanas loģiku konkrētām atbilstības vai darba plūsmas prasībām.

Kā eksportēt PST saturu uz JSON, izmantojot 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
 Latviski