
libpff
Nyílt forráskódú C könyvtár Outlook fájlformátumokhoz
Olvasd, elemezd és nyerd ki az adatokat PST, OST, PAB és OFF fájlokból ingyenes nyílt forráskódú C API-n keresztül.
Mi az a libpff?
A libpff egy hatékony nyílt forráskódú C könyvtár, amely a Microsoft Outlook által használt Personal Folder File (PFF) és Offline Folder File (OFF) formátumok elérésére lett tervezve. Lehetővé teszi a fejlesztők számára, hogy programozottan olvassák, elemezzék és kinyerjék az e‑mail, névjegyek, naptárbejegyzések és egyéb adatok, amelyek PST, OST, PAB és OFF fájlokban tárolódnak. A könyvtár támogatja a 32 bites ANSI és a 64 bites Unicode karakterkódolásokat, valamint a tömörített formátumokat, például a Outlook 2013‑ban bevezetett 4K‑oldalas DEFLATE‑tömörített OST fájlokat. Robusztus elemzőmotorjával a libpff különösen értékes a digitális kriminalisztikában, az e‑mail migrációban és az adat‑helyreállítási munkafolyamatokban.
A könyvtárat aktívan karbantartják az LGPL-3.0-vagy későbbi licenc alatt, és jelenleg alfa állapotban van, ami azt jelenti, hogy funkcionális, de hiányozhat a teljes funkciókészlet vagy a stabilitás a termelésben való használathoz. Tartalmaz eszközöket az elemek helyreállításához, és képes kezelni sérült vagy titkosított fájlokat, ahol a titkosítás típusa nincs. A libpff integrálódik kapcsolódó projektekhez, például a libfmapi-hez a MAPI definíciókhoz, és részletes forenzikus dokumentációt biztosít a komplex Outlook fájlstruktúrák elemzéséhez. A fejlesztők a forrásból építhetnek vagy előre lefordított binárisokat használhatnak, a projekt a GitHub-on van hosztolva a közösségi hozzájárulások és a hibajelentések kezelésére.
Első lépések a libpff használatához
A libpff használatának megkezdéséhez klónozhatja a forráskódot a hivatalos [libpff GitHub](https://github.com/libyal/libpff) tárolóból, és felépítheti CMake vagy autotools segítségével. Az előre lefordított binárisok nincsenek hivatalosan terjesztve, ezért a forrásból történő fordítás a javasolt megközelítés. A projekt részletes build‑utasításokat és olyan függőségeket tartalmaz, mint a libyal/libcerror és a libyal/libcdata. A felépítés után használhatja a biztosított parancssori eszközöket (például `pffexport`, `pffinfo`) a PST/OST fájlok vizsgálatához és adatkinyeréséhez. Programozási célokra linkeljen a lefordított könyvtárra a C/C++ alkalmazásában. A könyvtár könnyűsúlyú és minimális külső függőségekkel rendelkezik, így alkalmas beágyazott vagy kriminalisztikai környezetekben.
A libpff telepítése forráskódból
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
E-mailek és mellékletek kinyerése PST fájlokból
libpff robusztus funkcionalitást biztosít a PST fájlok elemzéséhez és az egyes e‑mail üzenetek valamint azok mellékleteinek kinyeréséhez. A fejlesztők bejárhatják a mappahierarchiát, elérhetik az üzenettulajdonságokat (pl. tárgy, feladó, címzettek, időbélyegek), és exportálhatják a nyers MIME tartalmat vagy strukturált adatokat. A könyvtár támogatja mind az ANSI, mind a Unicode karakterkódolásokat, biztosítva a kompatibilitást a 1990-es évektől a modern kiadásokig terjedő Outlook verziókkal. Kezeli a tömörített OST fájlokat (4K-oldalas DEFLATE), amelyek gyakoriak az újabb Outlook verziókban. Ez teszi a libpff-et ideálissá e‑mail migrációs eszközök, e‑felfedezési platformok és forenzikus elemzés számára, ahol a üzenettörzs és a mellékletek pontos kinyerése kritikus. Az API alacsony szintű hozzáférést biztosít a MAPI tulajdonságokhoz, lehetővé téve a finomhangolt adatlekérdezést.
Hogyan nyerhetők ki e-mailek egy PST fájlból C API-n keresztül?
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);
Forenzikus elemzés sérült Outlook fájlokban
libpff speciális képességeket tartalmaz a sérült vagy részben korrupt Outlook fájlok kriminalisztikai elemzéséhez. Képes hiányzó vagy ellentmondásos fejlécekkel rendelkező fájlok elemzésére, árván maradt elemek helyreállítására, és az üzenetfák újraépítésére még akkor is, ha a belső indexek megsérültek. A könyvtár támogatja a "none" titkosítási típussal rendelkező fájlokat, és képes bizonyos szerkezeti hibákat megkerülni a használható adatok kinyerése érdekében. Ez különösen értékes a digitális kriminalisztikai vizsgálatok során, amikor a bizonyítékok degradált PST/OST fájlokban lehetnek. A libpff részletes naplózást és hibajelentést is biztosít, lehetővé téve az elemzők számára, hogy nyomon kövessék az elemzési döntéseket és azonosítsák az adatveszteség pontjait. A MAPI tulajdonságok kinyerésével kombinálva a libpff megbízható alapot nyújt kriminalisztikai eszközök építéséhez, amelyek megfelelnek a jogi és megfelelőségi szabványoknak.
Hogyan állítsuk vissza az elemeket egy sérült PST-fájlból?
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);
MAPI tulajdonságok és metaadatok feldolgozása
libpff lehetővé teszi a MAPI tulajdonságok mélyreható vizsgálatát, amelyek az Outlook elemekben vannak beágyazva. A fejlesztők lekérhetik a szabványos tulajdonságokat, mint például `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, valamint az alkalmazások által definiált egyéni tulajdonságokat. A könyvtár egy tulajdonságkészlet API-t biztosít, amely lehetővé teszi az összes tulajdonság iterálását egy üzenet, mappa vagy melléklet esetén. Ez elengedhetetlen azoknak az alkalmazásoknak, amelyek megfelelőségi auditot, metaadat‑kivonatolást vagy integrációt igényelnek MAPI‑alapú rendszerekkel. A libpff támogatja mind a név szerinti, mind a numerikus tulajdonságazonosítókat, és kezeli a 32‑bites és 64‑bites értéktípusokat is (például karakterláncok, egész számok, bináris blobok). Szoros integrációja a libfmapi‑val biztosítja a MAPI definíciók pontos értelmezését, így alkalmas fejlett Outlook adat‑elemző eszközök létrehozására.
Hogyan nyerjük ki a MAPI tulajdonságokat egy üzenet elemből?
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);
}
Adatok exportálása szabványos formátumokba (CSV, JSON, XML)
Miközben a libpff elsősorban egy C könyvtár az alacsony szintű elemzéshez, tartalmaz parancssori segédprogramokat és API‑kat, amelyek megkönnyítik az Outlook adatok exportálását széles körben használt formátumokba, mint a CSV, JSON és XML. Az olyan eszközök, mint a `pffexport`, képesek a PST/OST tartalmakat strukturált szövegfájlokká konvertálni, megőrizve a mappahierarchiát és az üzenet metaadatait. A fejlesztők programozottan is használhatják a könyvtárat egyedi exportálók létrehozásához – például a MAPI tulajdonságok JSON objektumokká történő leképezésével a keresőmotorok vagy elemző platformok számára. Ez az exportálási képesség kulcsfontosságú az adatátvitel, biztonsági mentés és a modern felhőszolgáltatásokkal való integráció során, amelyek szabványos bemeneti formátumokat igényelnek. A libpff rugalmas tervezése lehetővé teszi a fejlesztők számára, hogy az export logikát a specifikus megfelelőségi vagy munkafolyamat‑igényekhez igazítsák.
Hogyan exportáljuk a PST tartalmát JSON formátumba CLI-n keresztül?
# 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
