
libpff
مكتبة C مفتوحة المصدر لتنسيقات ملفات Outlook
قراءة، تحليل واستخراج البيانات من ملفات PST و OST و PAB و OFF عبر واجهة برمجة تطبيقات C مجانية ومفتوحة المصدر.
ما هو libpff؟
libpff هي مكتبة C مفتوحة المصدر قوية صُممت للوصول إلى صيغ ملفات Personal Folder File (PFF) و Offline Folder File (OFF) المستخدمة في Microsoft Outlook. تمكّن المطورين من قراءة وتحليل واستخراج البريد الإلكتروني، جهات الاتصال، عناصر التقويم، وغيرها من البيانات المخزنة في ملفات PST و OST و PAB و OFF برمجيًا. تدعم المكتبة كل من ترميزات السلاسل 32‑bit ANSI و 64‑bit Unicode، بالإضافة إلى الصيغ المضغوطة مثل ملفات OST المضغوطة بتقنية DEFLATE بصفحات 4K التي تم تقديمها في Outlook 2013. بفضل محرك التحليل القوي لديها، تُعد libpff ذات قيمة خاصة في مجال الطب الشرعي الرقمي، وهجرة البريد الإلكتروني، وسير عمل استعادة البيانات.
المكتبة تُصان بنشاط تحت رخصة LGPL-3.0-or-later وتوجد حاليًا في حالة ألفا، مما يعني أنها تعمل ولكن قد تفتقر إلى اكتمال كامل للميزات أو الاستقرار للاستخدام في الإنتاج. تشمل أدوات لاستعادة العناصر ويمكنها التعامل مع الملفات التالفة أو المشفرة حيث نوع التشفير هو لا شيء. libpff يدمج أيضًا مع مشاريع ذات صلة مثل libfmapi لتعريفات MAPI ويوفر وثائق جنائية مفصلة للمساعدة في تحليل هياكل ملفات Outlook المعقدة. يمكن للمطورين بناء المكتبة من المصدر أو استخدام الثنائيات المجمعة مسبقًا، والمشروع مستضاف على GitHub للمساهمات المجتمعية وتتبع المشكلات.
البدء مع libpff
لبدء استخدام libpff، يمكنك استنساخ شفرة المصدر من مستودعها الرسمي [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 منذ التسعينيات وحتى الإصدارات الحديثة. كما تتعامل مع ملفات OST المضغوطة (DEFLATE بصفحات 4K)، والتي شائعة في إصدارات Outlook الأحدث. يجعل ذلك libpff مثالية لأدوات ترحيل البريد الإلكتروني، ومنصات الاكتشاف الإلكتروني، والتحليل الجنائي حيث يكون استخراج محتوى الرسائل والمرفقات بدقة أمرًا حيويًا. تُظهر واجهة برمجة التطبيقات (API) وصولًا منخفض المستوى إلى خصائص MAPI، مما يتيح تحكمًا دقيقًا في استرجاع البيانات.
كيفية استخراج رسائل البريد الإلكتروني من ملف PST عبر واجهة برمجة التطبيقات 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 للتحليل منخفض المستوى، فإنها تتضمن أدوات سطر الأوامر وواجهات برمجة التطبيقات التي تسهل تصدير بيانات Outlook إلى صيغ شائعة الاستخدام مثل CSV وJSON وXML. أدوات مثل `pffexport` يمكنها تحويل محتويات PST/OST إلى ملفات نصية منظمة، مع الحفاظ على هيكل المجلدات وبيانات تعريف الرسائل. يمكن للمطورين أيضًا استخدام المكتبة برمجيًا لبناء مُصدِّرات مخصصة—مثلاً، تحويل خصائص MAPI إلى كائنات JSON لتغذيتها في محركات البحث أو منصات التحليل. هذه القدرة على التصدير حاسمة لهجرة البيانات، النسخ الاحتياطي، والتكامل مع خدمات السحابة الحديثة التي تتطلب صيغ إدخال موحدة. التصميم المرن لـ libpff يسمح للمطورين بتخصيص منطق التصدير وفقًا لمتطلبات الامتثال أو سير العمل المحددة.
كيفية تصدير محتويات PST إلى JSON عبر سطر الأوامر؟
# 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
