libpff

 
 

ספריית C בקוד פתוח לפורמטים של קבצי Outlook

קרא, נתח והוצא נתונים מקבצי PST, OST, PAB & OFF דרך API חינמי בקוד פתוח של C.

מהו libpff?

libpff היא ספריית C קוד פתוח חזקה שנועדה לגשת לפורמטים של Personal Folder File (PFF) ו-Offline Folder File (OFF) המשמשים ב-Microsoft Outlook. היא מאפשרת למפתחים לקרוא, לנתח ולחלץ באופן תכנותי אימייל, אנשי קשר, פריטי לוח שנה ונתונים אחרים המאוחסנים בקבצי PST, OST, PAB ו-OFF. הספרייה תומכת בקידודי מחרוזות ANSI של 32‑ביט ו‑Unicode של 64‑ביט, וכן בפורמטים דחוסים כגון קבצי OST דחוסי DEFLATE בגודל דף של 4K שהוצגו ב-Outlook 2013. עם מנוע הניתוח החזק שלה, libpff היא בעלת ערך גבוה במיוחד בפורנזיקה דיגיטלית, במעבר אימיילים ובתהליכי שחזור נתונים.

הספרייה מתוחזקת באופן פעיל תחת רישיון LGPL-3.0-or-later וכעת במצב אלפא, משמעותו שהיא פונקציונלית אך עשויה לחסר שלמות תכונות מלאה או יציבות לשימוש בייצור. היא כוללת כלי לשחזור פריטים ויכולה להתמודד עם קבצים פגומים או מוצפנים שבהם סוג ההצפנה הוא ללא הצפנה. libpff גם משולבת עם פרויקטים קשורים כמו libfmapi להגדרות MAPI ומספקת תיעוד פורנסי מפורט כדי לסייע בניתוח מבני קבצי Outlook מורכבים. מפתחים יכולים לבנות מהמקור או להשתמש בבינאריים מקומפלים מראש, והפרויקט מתארח ב‑GitHub לתרומות קהילתיות ומעקב אחר בעיות.

Previous Next

התחלה עם libpff

להתחיל להשתמש ב‑libpff, ניתן לשכפל את קוד המקור מהמאגר הרשמי שלו ב‑[GitHub של libpff](https://github.com/libyal/libpff) ולבנות אותו באמצעות CMake או autotools. קבצים בינאריים מוכנים מראש אינם מופצים רשמית, ולכן בנייה מהמקור היא הגישה המומלצת. הפרויקט כולל הוראות בנייה מפורטות ותלויות כגון libyal/libcerror ו‑libyal/libcdata. לאחר הבנייה, ניתן להשתמש בכלי שורת הפקודה המסופקים (למשל `pffexport`, `pffinfo`) כדי לבדוק ולחלץ נתונים מקבצי PST/OST. לשימוש תכנותי, יש לקשר נגד הספרייה המוכנת ביישום C/C++ שלך. הספרייה קלה משקל ויש לה תלויות חיצוניות מינימליות, מה שהופך אותה למתאימה לסביבות משובצות או פורנסיות.

התקנת libpff באמצעות בניית מקור

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

חילוץ הודעות דוא"ל וקבצים מצורפים מקבצי PST

libpff מספקת פונקציונליות חזקה לניתוח קבצי PST ולחילוץ הודעות דוא"ל בודדות יחד עם הקבצים המצורפים שלהן. מפתחים יכולים לעבור על היררכיית התיקיות, לגשת למאפייני ההודעה (למשל, נושא, שולח, נמענים, חותמות זמן), ולייצא תוכן MIME גולמי או נתונים מובנים. הספרייה תומכת הן בקידודי מחרוזות ANSI והן Unicode, ומבטיחה תאימות לגרסאות Outlook משנות ה‑1990 ועד גרסאות מודרניות. היא גם מטפלת בקבצי OST דחוסים (DEFLATE של דף 4K), הנפוצים בגרסאות Outlook חדשות יותר. זה עושה את libpff אידיאלית לכלי הגירת דוא"ל, פלטפורמות e-discovery וניתוח פורנזי שבו חילוץ מדויק של גופי ההודעות והקבצים המצורפים הוא קריטי. ה‑API חושף גישה ברמת נמוכה למאפייני MAPI, ומאפשר שליטה מדויקת על שליפת הנתונים.

איך לחלץ הודעות דוא"ל מקובץ PST באמצעות 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);

ניתוח פורנזי של קבצי Outlook פגומים

libpff כולל יכולות מתמחות לניתוח פורנזי של קבצי Outlook פגומים או חלקית מושחתים. הוא יכול לנתח קבצים עם כותרות חסרות או לא עקביות, לשחזר פריטים יתומים ולבנות מחדש עצי הודעות גם כאשר אינדקסים פנימיים פגומים. הספרייה תומכת בקבצים עם סוג הצפנה "none" ויכולה לעקוף שגיאות מבניות מסוימות כדי לחלץ נתונים ברי שימוש. זה במיוחד בעל ערך בחקירות פורנזיות דיגיטליות שבהן ראיות עשויות להימצא בקבצי PST/OST מושחתים. libpff גם מספקת רישום מפורט ודיווח על שגיאות, המאפשרים לאנליסטים לעקוב אחרי החלטות הניתוח ולזהות נקודות אובדן נתונים. בשילוב עם חילוץ תכונות MAPI, libpff משמשת כבסיס אמין לבניית כלי פורנזה העומדים בתקנים משפטיים ותקנות ציות.

איך לשחזר פריטים מקובץ PST פגום?

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 ונתוני מטא

libpff מאפשר חקירה מעמיקה של תכונות MAPI המשובצות בפריטי Outlook. מפתחים יכולים לאחזר תכונות סטנדרטיות כגון `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, ותכונות מותאמות שהוגדרו על ידי יישומים. הספרייה חושפת API של קבוצת תכונות המאפשר איטרציה על כל התכונות של הודעה, תיקייה או קובץ מצורף. זה חיוני ליישומים הדורשים ביקורת ציות, חילוץ מטה-נתונים, או אינטגרציה עם מערכות מבוססות MAPI. libpff תומכת גם במזהי תכונות בשם וגם במספריים, ומטפלת גם בסוגי ערכים של 32‑ביט ו‑64‑ביט (למשל, מחרוזות, שלמים, בלובי בינאריים). האינטגרציה ההדוקה שלה עם libfmapi מבטיחה פרשנות מדויקת של הגדרות MAPI, מה שהופך אותה למתאימה לבניית כלי ניתוח נתוני Outlook מתקדמים.

איך לחלץ מאפייני MAPI מפריט הודעה?

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

ייצוא נתונים לפורמטים סטנדרטיים (CSV, JSON, XML)

בזמן ש‑libpff היא בעיקר ספרייה ב‑C לניתוח ברמת נמוכה, היא כוללת כלי שורת פקודה ו‑APIs שמקלים על ייצוא נתוני Outlook לפורמטים נפוצים כמו CSV, JSON ו‑XML. כלים כגון `pffexport` יכולים להמיר תוכן PST/OST לקבצי טקסט מובנים, תוך שמירה על היררכיית התיקיות ונתוני המטא של ההודעות. מפתחים יכולים גם להשתמש בספרייה באופן תכנותי כדי לבנות מייצאים מותאמים אישית — למשל, מיפוי תכונות MAPI לאובייקטים ב‑JSON לצורך הכנסתן למנועי חיפוש או פלטפורמות אנליטיות. יכולת הייצוא הזו קריטית למעבר נתונים, גיבוי ושילוב עם שירותי ענן מודרניים הדורשים פורמטים קלט סטנדרטיים. העיצוב הגמיש של libpff מאפשר למפתחים להתאים את לוגיקת הייצוא לדרישות ציות או זרימת עבודה ספציפיות.

איך לייצא את תוכן PST ל-JSON באמצעות 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
 עִברִית