libpff

 
 

Thư viện C mã nguồn mở cho các định dạng tệp Outlook

Đọc, phân tích & trích xuất dữ liệu từ các tệp PST, OST, PAB & OFF qua API C miễn phí mã nguồn mở.

libpff là gì?

libpff là một thư viện C mã nguồn mở mạnh mẽ được thiết kế để truy cập các định dạng Personal Folder File (PFF) và Offline Folder File (OFF) được Microsoft Outlook sử dụng. Nó cho phép các nhà phát triển đọc, phân tích và trích xuất email, danh bạ, mục lịch và các dữ liệu khác lưu trong các tệp PST, OST, PAB và OFF một cách lập trình. Thư viện hỗ trợ cả mã hóa chuỗi 32-bit ANSI và 64-bit Unicode, cũng như các định dạng nén như tệp OST nén DEFLATE 4K-page được giới thiệu trong Outlook 2013. Với công cụ phân tích mạnh mẽ, libpff đặc biệt hữu ích trong các quy trình pháp y kỹ thuật số, di chuyển email và khôi phục dữ liệu.

Thư viện đang được bảo trì tích cực dưới giấy phép LGPL-3.0-or-later và hiện tại处于 trạng thái alpha, có nghĩa là nó hoạt động nhưng có thể thiếu đầy đủ tính năng hoặc độ ổn định cho việc sử dụng trong môi trường sản xuất. Nó bao gồm các công cụ phục hồi mục và có thể xử lý các tệp bị hỏng hoặc được mã hóa khi loại mã hóa là none. libpff cũng tích hợp với các dự án liên quan như libfmapi cho các định nghĩa MAPI và cung cấp tài liệu pháp y chi tiết để giúp phân tích cấu trúc tệp Outlook phức tạp. Các nhà phát triển có thể biên dịch từ mã nguồn hoặc sử dụng các binary đã biên dịch trước, và dự án được lưu trữ trên GitHub để cộng đồng đóng góp và theo dõi vấn đề.

Previous Next

Bắt đầu với libpff

Để bắt đầu sử dụng libpff, bạn có thể sao chép mã nguồn từ kho [libpff GitHub](https://github.com/libyal/libpff) chính thức và biên dịch nó bằng CMake hoặc autotools. Các binary đã biên dịch trước không được phân phối chính thức, vì vậy việc biên dịch từ nguồn là cách được khuyến nghị. Dự án bao gồm hướng dẫn biên dịch chi tiết và các phụ thuộc như libyal/libcerror và libyal/libcdata. Sau khi biên dịch, bạn có thể sử dụng các công cụ dòng lệnh được cung cấp (ví dụ, `pffexport`, `pffinfo`) để kiểm tra và trích xuất dữ liệu từ các tệp PST/OST. Đối với việc sử dụng lập trình, hãy liên kết với thư viện đã biên dịch trong ứng dụng C/C++ của bạn. Thư viện này nhẹ và có ít phụ thuộc bên ngoài, phù hợp cho môi trường nhúng hoặc pháp y.

Cài đặt libpff qua biên dịch nguồn

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

Trích xuất email và tệp đính kèm từ các tệp PST

libpff cung cấp chức năng mạnh mẽ để phân tích tệp PST và trích xuất các tin nhắn email riêng lẻ cùng với tệp đính kèm của chúng. Các nhà phát triển có thể duyệt cấu trúc thư mục, truy cập các thuộc tính của tin nhắn (ví dụ: tiêu đề, người gửi, người nhận, thời gian), và xuất nội dung MIME thô hoặc dữ liệu có cấu trúc. Thư viện hỗ trợ cả mã hóa chuỗi ANSI và Unicode, đảm bảo tương thích với các phiên bản Outlook từ những năm 1990 đến các bản phát hành hiện đại. Nó cũng xử lý các tệp OST nén (DEFLATE 4K-page), thường gặp trong các phiên bản Outlook mới hơn. Điều này làm cho libpff trở thành lựa chọn lý tưởng cho các công cụ di chuyển email, nền tảng e-discovery và phân tích pháp y, nơi việc trích xuất chính xác nội dung tin nhắn và tệp đính kèm là rất quan trọng. API cung cấp quyền truy cập cấp thấp vào các thuộc tính MAPI, cho phép kiểm soát chi tiết quá trình lấy dữ liệu.

Cách trích xuất email từ tệp PST qua 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);

Phân tích pháp y các tệp Outlook bị hỏng

libpff bao gồm các khả năng chuyên biệt cho việc phân tích pháp y các tệp Outlook bị hỏng hoặc chỉ một phần. Nó có thể phân tích các tệp có tiêu đề thiếu hoặc không nhất quán, khôi phục các mục mồ côi, và tái cấu trúc cây tin nhắn ngay cả khi các chỉ mục nội bộ bị hỏng. Thư viện hỗ trợ các tệp với loại mã hóa "none" và có thể bỏ qua một số lỗi cấu trúc để trích xuất dữ liệu có thể sử dụng được. Điều này đặc biệt có giá trị trong các cuộc điều tra pháp y kỹ thuật số, nơi bằng chứng có thể nằm trong các tệp PST/OST đã suy giảm. libpff cũng cung cấp ghi nhật ký chi tiết và báo cáo lỗi, cho phép các nhà phân tích theo dõi quyết định phân tích và xác định các điểm mất dữ liệu. Khi kết hợp với khả năng trích xuất thuộc tính MAPI, libpff đóng vai trò là nền tảng đáng tin cậy để xây dựng các công cụ pháp y đáp ứng các tiêu chuẩn pháp lý và tuân thủ.

Cách khôi phục các mục từ tệp PST bị hỏng?

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

Phân tích các thuộc tính và siêu dữ liệu MAPI

libpff cho phép kiểm tra sâu các thuộc tính MAPI được nhúng trong các mục Outlook. Các nhà phát triển có thể truy xuất các thuộc tính tiêu chuẩn như `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, và các thuộc tính tùy chỉnh do ứng dụng định nghĩa. Thư viện cung cấp một API bộ thuộc tính cho phép lặp lại tất cả các thuộc tính của một tin nhắn, thư mục hoặc tệp đính kèm. Điều này là thiết yếu cho các ứng dụng cần kiểm toán tuân thủ, trích xuất siêu dữ liệu, hoặc tích hợp với các hệ thống dựa trên MAPI. libpff hỗ trợ cả định danh thuộc tính có tên và số, và xử lý cả các kiểu giá trị 32-bit và 64-bit (ví dụ: chuỗi, số nguyên, binary blobs). Sự tích hợp chặt chẽ với libfmapi đảm bảo việc diễn giải chính xác các định nghĩa MAPI, làm cho nó phù hợp để xây dựng các công cụ phân tích dữ liệu Outlook nâng cao.

Cách trích xuất các thuộc tính MAPI từ một mục tin nhắn?

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

Xuất dữ liệu sang các định dạng tiêu chuẩn (CSV, JSON, XML)

Trong khi libpff chủ yếu là một thư viện C cho việc phân tích cấp thấp, nó bao gồm các tiện ích dòng lệnh và API giúp xuất dữ liệu Outlook sang các định dạng phổ biến như CSV, JSON và XML. Các công cụ như `pffexport` có thể chuyển đổi nội dung PST/OST thành các tệp văn bản có cấu trúc, bảo tồn cấu trúc thư mục và siêu dữ liệu của tin nhắn. Các nhà phát triển cũng có thể sử dụng thư viện này một cách lập trình để xây dựng các bộ xuất tùy chỉnh—ví dụ, ánh xạ các thuộc tính MAPI sang các đối tượng JSON để nhập vào các công cụ tìm kiếm hoặc nền tảng phân tích. Khả năng xuất này rất quan trọng cho việc di chuyển dữ liệu, sao lưu và tích hợp với các dịch vụ đám mây hiện đại yêu cầu định dạng đầu vào tiêu chuẩn. Thiết kế linh hoạt của libpff cho phép các nhà phát triển tùy chỉnh logic xuất phù hợp với các yêu cầu tuân thủ hoặc quy trình làm việc cụ thể.

Cách xuất nội dung PST sang JSON qua 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
 Tiếng Việt