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 را بخوانند، تجزیه و استخراج کنند. این کتابخانه از رمزگذاری‌های رشته‌ای 32‑بیتی ANSI و 64‑بیتی Unicode، همچنین فرمت‌های فشرده مانند فایل‌های OST فشرده‌شده با DEFLATE صفحه 4K که در Outlook 2013 معرفی شدند، پشتیبانی می‌کند. با موتور تجزیه قوی خود، libpff به‌ویژه در زمینه‌های جرم‌شناسی دیجیتال، مهاجرت ایمیل و جریان‌های کاری بازیابی داده‌ها ارزشمند است.

کتابخانه به‌طور فعال تحت مجوز LGPL-3.0-or-later نگهداری می‌شود و در حال حاضر处于 وضعیت آلفا است، به این معنی که عملکرد دارد اما ممکن است کامل بودن ویژگی‌ها یا پایداری برای استفاده در تولید را نداشته باشد. این شامل ابزارهایی برای بازیابی آیتم است و می‌تواند فایل‌های خراب یا رمزگذاری‌شده را که نوع رمزگذاری none است، مدیریت کند. libpff همچنین با پروژه‌های مرتبط مانند libfmapi برای تعاریف MAPI یکپارچه می‌شود و مستندات قانونی جزئی ارائه می‌دهد تا به تحلیل ساختارهای پیچیده فایل‌های Outlook کمک کند. توسعه‌دهندگان می‌توانند از منبع بسازند یا از باینری‌های پیش‌کامپایل‌شده استفاده کنند، و پروژه در GitHub میزبانی می‌شود برای مشارکت‌های جامعه و پیگیری مشکلات.

Previous Next

شروع کار با libpff

برای شروع استفاده از libpff، می‌توانید کد منبع را از مخزن رسمی [libpff GitHub](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 صفحه ۴کیلوبایتی) را که در نسخه‌های جدید 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 هم شناسه‌های نام‌دار و هم شناسه‌های عددی ویژگی‌ها را پشتیبانی می‌کند و انواع مقدار ۳۲ بیتی و ۶۴ بیتی (مانند رشته‌ها، اعداد صحیح، بلوک‌های باینری) را مدیریت می‌کند. ادغام نزدیک آن با 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 برای تجزیه سطح پایین است، شامل ابزارهای خط فرمان و APIهایی است که صادرات داده‌های 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
 فارسی