libpff

 
 

Avoimen lähdekoodin C-kirjasto Outlook-tiedostomuotoihin

Lue, jäsennä ja poimi tietoja PST-, OST-, PAB- ja OFF-tiedostoista ilmaisella avoimen lähdekoodin C-API:lla.

Mikä on libpff?

libpff on tehokas avoimen lähdekoodin C-kirjasto, joka on suunniteltu pääsemään käsiksi Microsoft Outlookin käyttämien Personal Folder File (PFF) ja Offline Folder File (OFF) -muotojen tiedostoihin. Se mahdollistaa kehittäjille ohjelmallisesti lukea, jäsentää ja poimia sähköpostit, yhteystiedot, kalenteritapahtumat ja muut PST-, OST-, PAB- ja OFF-tiedostoissa tallennetut tiedot. Kirjasto tukee sekä 32‑bit ANSI- että 64‑bit Unicode -merkkikoodauksia, sekä pakattuja formaatteja kuten Outlook 2013:ssa esitellyt 4K-sivun DEFLATE-pakatut OST-tiedostot. Vankalla jäsentämismekaniikallaan libpff on erityisen arvokas digitaalisen rikostutkinnan, sähköpostin siirron ja tietojen palauttamisen työnkuluissa.

Kirjasto on aktiivisesti ylläpidetty LGPL-3.0-or-later -lisenssin alaisena ja on tällä hetkellä alfa-tilassa, mikä tarkoittaa, että se on toiminnallinen, mutta saattaa puuttua täysi ominaisuuksien täydellisyys tai vakaus tuotantokäyttöön. Se sisältää työkaluja kohteiden palauttamiseen ja pystyy käsittelemään vioittuneita tai salattuja tiedostoja, joissa salauksen tyyppi on none. libpff integroituu myös liittyviin projekteihin, kuten libfmapi MAPI-määrittelyjä varten, ja tarjoaa yksityiskohtaista forensista dokumentaatiota monimutkaisten Outlook-tiedostorakenteiden analysoimiseksi. Kehittäjät voivat kääntää lähdekoodista tai käyttää esikäännettyjä binääritiedostoja, ja projekti on isännöity GitHubissa yhteisöpanoksia ja vikojen seurantaa varten.

Previous Next

Aloittaminen libpff:n kanssa

Jos haluat aloittaa libpff:n käytön, voit kloonata lähdekoodin sen virallisesta [libpff GitHub](https://github.com/libyal/libpff) -varastosta ja rakentaa sen käyttäen CMakea tai autotoolsia. Esikäännettyjä binääritiedostoja ei jaeta virallisesti, joten lähdekoodista kääntäminen on suositeltava tapa. Projekti sisältää yksityiskohtaiset rakennusohjeet ja riippuvuudet kuten libyal/libcerror ja libyal/libcdata. Kun käännös on valmis, voit käyttää mukana toimitettuja komentorivityökaluja (esim. `pffexport`, `pffinfo`) tarkastellaksesi ja poimiaksesi tietoja PST/OST-tiedostoista. Ohjelmallista käyttöä varten linkitä käännettyyn kirjastoon C/C++-sovelluksessasi. Kirjasto on kevyt ja sillä on minimaaliset ulkoiset riippuvuudet, mikä tekee siitä sopivan upotettuihin tai forensisiin ympäristöihin.

Asenna libpff lähdekoodin avulla

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

Poimi sähköpostit ja liitteet PST-tiedostoista

libpff tarjoaa vankkaa toiminnallisuutta PST-tiedostojen jäsentämiseen ja yksittäisten sähköpostiviestien sekä niiden liitteiden poimimiseen. Kehittäjät voivat selata kansiorakennetta, käyttää viestin ominaisuuksia (esim. aihe, lähettäjä, vastaanottajat, aikaleimat) ja viedä raakaa MIME-sisältöä tai jäsenneltyä dataa. Kirjasto tukee sekä ANSI- että Unicode-merkistökoodauksia, mikä varmistaa yhteensopivuuden Outlook-versioiden kanssa 1990-luvulta nykyaikaisiin julkaisuihin. Se käsittelee myös pakattuja OST-tiedostoja (4K-sivun DEFLATE), jotka ovat yleisiä uudemmissa Outlook-versioissa. Tämä tekee libpff:stä ihanteellisen sähköpostin migraatiotyökaluille, e-discovery-alustoille ja oikeuslääketieteelliselle analyysille, jossa viestien rungon ja liitteiden tarkka poiminta on kriittistä. API tarjoaa matalan tason pääsyn MAPI-ominaisuuksiin, mahdollistaen hienojakoisen hallinnan tietojen hakemisessa.

Kuinka poimia sähköpostit PST-tiedostosta C API:n avulla?

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

Forensinen analyysi vioittuneista Outlook-tiedostoista

libpff sisältää erikoistuneita ominaisuuksia vahingoittuneiden tai osittain korruptoituneiden Outlook-tiedostojen rikostutkintaan. Se voi jäsentää tiedostoja, joista puuttuvat tai epäyhtenäiset otsikot, palauttaa orvot kohteet ja rekonstruoida viestipuut, vaikka sisäiset indeksit olisivatkin rikki. Kirjasto tukee tiedostoja, joiden salaus on "none", ja voi ohittaa tietyt rakenteelliset virheet hyödyllisen datan poimimiseksi. Tämä on erityisen arvokasta digitaalisen rikostutkinnan tutkimuksissa, joissa todisteet voivat sijaita heikentyneissä PST/OST-tiedostoissa. libpff tarjoaa myös yksityiskohtaista lokitusta ja virheraportointia, mahdollistaen analyytikoiden seurata jäsentämispäätöksiä ja tunnistaa tietojen menetyspisteet. Yhdistettynä sen MAPI-ominaisuuksien poimintaan, libpff toimii luotettavana perustana rikostutkintatyökalujen rakentamiseen, jotka täyttävät oikeudelliset ja vaatimustenmukaisuuden standardit.

Kuinka palauttaa kohteet vioittuneesta PST-tiedostosta?

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

Jäsennä MAPI-ominaisuudet ja metatiedot

libpff mahdollistaa MAPI-ominaisuuksien syvällisen tarkastelun, jotka on upotettu Outlook-objekteihin. Kehittäjät voivat hakea vakio-ominaisuuksia, kuten `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, sekä sovellusten määrittelemiä mukautettuja ominaisuuksia. Kirjasto tarjoaa property set -API:n, jonka avulla voidaan iteroida kaikkien viestin, kansion tai liitteen ominaisuuksien läpi. Tämä on olennaista sovelluksille, jotka tarvitsevat vaatimustenmukaisuuden tarkastusta, metatietojen poimintaa tai integraatiota MAPI-pohjaisten järjestelmien kanssa. libpff tukee sekä nimettyjä että numeerisia ominaisuustunnisteita, ja käsittelee sekä 32‑bit että 64‑bit arvo-tyyppejä (esim. merkkijonot, kokonaisluvut, binääripaketit). Sen tiivis integraatio libfmapi:n kanssa takaa MAPI-määritelmien tarkan tulkinnan, mikä tekee siitä sopivan kehittyneiden Outlook-datanalyysityökalujen rakentamiseen.

Kuinka poimia MAPI-ominaisuudet viestikohteesta?

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

Vie tiedot standardimuotoihin (CSV, JSON, XML)

Vaikka libpff on ensisijaisesti C-kirjasto alhaisen tason jäsentämiseen, se sisältää komentorivityökaluja ja API-rajapintoja, jotka helpottavat Outlook-tietojen vientiä laajasti käytettyihin formaatteihin, kuten CSV, JSON ja XML. Työkalut kuten `pffexport` voivat muuntaa PST/OST-sisällöt rakenteellisiksi tekstitiedostoiksi, säilyttäen kansiorakenteen ja viestien metatiedot. Kehittäjät voivat myös käyttää kirjastoa ohjelmallisesti rakentaakseen mukautettuja viejiä—esim. kartoittamalla MAPI-ominaisuuksia JSON-objekteiksi hakukoneiden tai analytiikka-alustojen syötteeksi. Tämä vientiominaisuus on ratkaisevan tärkeä tietojen siirrossa, varmuuskopioinnissa ja integroinnissa nykyaikaisiin pilvipalveluihin, jotka vaativat standardoituja syötteitä. libpff:n joustava suunnittelu mahdollistaa kehittäjille vientilogiikan räätälöinnin erityisiin vaatimuksiin tai työnkulkuvaatimuksiin.

Kuinka viedä PST-sisältö JSON-muotoon CLI:n kautta?

# 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
 Suomen