libpff

 
 

Atviro kodo C biblioteka Outlook failų formatams

Skaitykite, analizuokite ir išgaukite duomenis iš PST, OST, PAB ir OFF failų per nemokamą atviro kodo C API.

Kas yra libpff?

libpff yra galinga atviro kodo C biblioteka, skirta prieigai prie Personal Folder File (PFF) ir Offline Folder File (OFF) formatų, kuriuos naudoja Microsoft Outlook. Ji leidžia kūrėjams programiškai skaityti, analizuoti ir išgauti el. laiškus, kontaktus, kalendoriaus elementus ir kitus duomenis, saugomus PST, OST, PAB ir OFF failuose. Biblioteka palaiko tiek 32‑bitų ANSI, tiek 64‑bitų Unicode simbolių kodavimus, taip pat suspaustus formatus, pvz., 4K puslapių DEFLATE suspaustus OST failus, pristatytus Outlook 2013. Su savo patikimu analizės varikliu libpff ypač vertinga skaitmeninės kriminalistikos, el. pašto migracijos ir duomenų atkūrimo procesams.

Biblioteka aktyviai prižiūrima pagal LGPL-3.0-ar-vėlesnę licenciją ir šiuo metu yra alfa būsenoje, tai reiškia, kad ji veikia, tačiau gali trūkti pilnos funkcijų komplektacijos ar stabilumo gamybos naudojimui. Ji apima įrankius elementų atkūrimui ir gali tvarkyti sugadintus arba šifruotus failus, kai šifravimo tipas yra nenurodytas. libpff taip pat integruojasi su susijusiais projektais, tokiais kaip libfmapi, skirtu MAPI apibrėžimams, ir pateikia išsamų teisinės analizės dokumentaciją, padedančią analizuoti sudėtingas Outlook failų struktūras. Kūrėjai gali kompiliuoti iš šaltinio arba naudoti iš anksto sukompiliuotas binarines rinkmenas, o projektas talpinamas GitHub platformoje, skirta bendruomenės indėliams ir problemų sekimui.

Previous Next

Pradžia su libpff

Norėdami pradėti naudoti libpff, galite klonuoti šaltinio kodą iš oficialios [libpff GitHub](https://github.com/libyal/libpff) saugyklos ir sukurti jį naudodami CMake arba autotools. Iš anksto sukompiliuoti binariniai failai nėra oficialiai platinami, todėl rekomenduojama kurti iš šaltinio. Projektas apima išsamias kūrimo instrukcijas ir priklausomybes, tokias kaip libyal/libcerror ir libyal/libcdata. Sukūrus, galite naudoti pateiktus komandų eilutės įrankius (pvz., `pffexport`, `pffinfo`), kad patikrintumėte ir išgautumėte duomenis iš PST/OST failų. Programiškai naudojant, susiekite su sukompiliuota biblioteka savo C/C++ programoje. Biblioteka yra lengva ir turi minimalias išorines priklausomybes, todėl ji tinka įterptinėms ar teisinėms tyrimų aplinkoms.

Įdiegti libpff naudojant šaltinio kūrimą

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

Ištraukti el. laiškus ir priedus iš PST failų

libpff suteikia patikimą funkcionalumą PST failų analizavimui ir atskirų el. laiškų bei jų priedų išgavimui. Kūrėjai gali naršyti aplankų hierarchiją, pasiekti laiško savybes (pvz., temą, siuntėją, gavėjus, laiko žymas) ir eksportuoti neapdorotą MIME turinį arba struktūruotus duomenis. Biblioteka palaiko tiek ANSI, tiek Unicode simbolių kodavimus, užtikrindama suderinamumą su Outlook versijomis nuo 1990‑ųjų iki šiuolaikinių leidimų. Ji taip pat apdoroja suspaustus OST failus (4K puslapių DEFLATE), kurie yra įprasti naujesnėse Outlook versijose. Tai daro libpff idealiu el. pašto migracijos įrankiams, e‑discovery platformoms ir teisinės analizės (forensic) tyrimams, kur tikslus laiškų turinio ir priedų išgavimas yra kritiškas. API suteikia žemo lygio prieigą prie MAPI savybių, leidžiančią smulkią duomenų gavimo kontrolę.

Kaip ištraukti el. laiškus iš PST failo naudojant 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);

Teismo ekspertizės analizė sugadintų Outlook failų

libpff apima specializuotas galimybes forensinei pažeistų arba dalinai sugadintų Outlook failų analizei. Ji gali analizuoti failus su trūkstamomis arba nesuderinamomis antraštėmis, atkurti apleistus elementus ir rekonstruoti pranešimų medžius net kai vidiniai indeksai yra sugadinti. Biblioteka palaiko failus su šifravimo tipu "none" ir gali apeiti tam tikras struktūrines klaidas, kad išgautų naudojamus duomenis. Tai ypač vertinga skaitmeninės forenzikos tyrimuose, kai įrodymai gali būti susiję su degraduotais PST/OST failais. libpff taip pat suteikia išsamų žurnalinimą ir klaidų ataskaitas, leidžiančias analitikams sekti analizės sprendimus ir identifikuoti duomenų praradimo taškus. Derinant su MAPI savybių išgavimu, libpff tampa patikimu pagrindu kuriant forenzikos įrankius, atitinkančius teisės ir atitikties standartus.

Kaip atkurti elementus iš sugadinto PST failo?

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

Analizuoti MAPI savybes ir metaduomenis

libpff suteikia galimybę išsamiai tikrinti MAPI savybes, įterptas į Outlook elementus. Kūrėjai gali gauti standartines savybes, tokias kaip `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, ir programų apibrėžtas pasirinktines savybes. Biblioteka pateikia savybių rinkinio API, leidžiančią iteruoti per visas žinutės, aplanko ar priedo savybes. Tai būtina programoms, kurioms reikalingas atitikties auditas, metaduomenų išgavimas arba integracija su MAPI pagrįstomis sistemomis. libpff palaiko tiek pavadintus, tiek skaitinius savybių identifikatorius ir apdoroja tiek 32‑bitų, tiek 64‑bitų verčių tipus (pvz., eilutes, sveikuosius skaičius, binarinius duomenis). Jo glaudi integracija su libfmapi užtikrina tikslų MAPI apibrėžimų interpretavimą, todėl jis tinka kurti pažangias Outlook duomenų analizės priemones.

Kaip išgauti MAPI savybes iš žinutės elemento?

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

Eksportuoti duomenis į standartinius formatus (CSV, JSON, XML)

Nors libpff yra pirmiausia C biblioteka žemų lygių analizavimui, ji apima komandų eilutės įrankius ir API, kurie palengvina Outlook duomenų eksportavimą į plačiai naudojamus formatus, tokius kaip CSV, JSON ir XML. Įrankiai, tokie kaip `pffexport`, gali konvertuoti PST/OST turinį į struktūruotus tekstinius failus, išsaugodami aplankų hierarchiją ir pranešimų metaduomenis. Kūrėjai taip pat gali programiškai naudoti biblioteką kuriant pasirinktinius eksportuotojus – pvz., mapuojant MAPI savybes į JSON objektus, kad būtų įkelta į paieškos variklius ar analitikos platformas. Ši eksporto galimybė yra esminė duomenų migracijai, atsarginiam kopijavimui ir integracijai su šiuolaikinėmis debesų paslaugomis, kurios reikalauja standartizuotų įvesties formatų. libpff lankstus dizainas leidžia kūrėjams pritaikyti eksporto logiką konkretiems atitikties ar darbo srauto reikalavimams.

Kaip eksportuoti PST turinį į JSON per 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
 Lietuvių