
libpff
Outlookファイル形式のためのオープンソースCライブラリ
無料のオープンソースC APIを使用して、PST、OST、PAB、OFFファイルからデータを読み取り、解析し、抽出します。
libpff とは何ですか?
libpff は、Microsoft Outlook が使用する Personal Folder File (PFF) および Offline Folder File (OFF) フォーマットにアクセスするために設計された、強力なオープンソースの C ライブラリです。開発者はこのライブラリを使用して、PST、OST、PAB、OFF ファイルに格納されたメール、連絡先、カレンダー アイテム、その他のデータをプログラムで読み取り、解析、抽出できます。このライブラリは 32 ビット ANSI と 64 ビット Unicode の文字エンコーディングの両方、および Outlook 2013 で導入された 4K ページの DEFLATE 圧縮 OST ファイルなどの圧縮フォーマットをサポートしています。堅牢なパーシングエンジンにより、libpff はデジタルフォレンジック、メール移行、データ復旧ワークフローで特に有用です。
このライブラリは LGPL-3.0 以降のライセンスの下で積極的に保守されており、現在はアルファステータスです。つまり機能はありますが、製品での使用に必要な機能の完全性や安定性が不足している可能性があります。アイテム復旧用のツールが含まれており、暗号化タイプが none の場合の破損したファイルや暗号化されたファイルを処理できます。libpff は libfmapi のような関連プロジェクトと統合され、MAPI 定義を提供し、複雑な Outlook ファイル構造の解析に役立つ詳細なフォレンジックドキュメントも提供します。開発者はソースからビルドするか、事前コンパイル済みバイナリを使用でき、プロジェクトは GitHub でホストされており、コミュニティによる貢献や課題追跡が行われています。
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 ファイルを解析し、個々のメールメッセージとその添付ファイルを抽出するための堅牢な機能を提供します。開発者はフォルダー階層をたどり、メッセージプロパティ(例:件名、送信者、受信者、タイムスタンプ)にアクセスし、RAW MIME コンテンツまたは構造化データをエクスポートできます。このライブラリは ANSI と Unicode の文字エンコーディングの両方をサポートしており、1990 年代から最新のリリースまでの Outlook バージョンとの互換性を確保します。また、圧縮された OST ファイル(4K ページ DEFLATE)も処理でき、これは新しい Outlook バージョンで一般的です。これにより、libpff はメール移行ツール、e‑discovery プラットフォーム、フォレンジック分析に最適であり、メッセージ本文と添付ファイルの正確な抽出が重要です。API は MAPI プロパティへの低レベルアクセスを提供し、データ取得の細かな制御を可能にします。
C API を使用して PST ファイルからメールを抽出する方法は?
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 は Outlook アイテムに埋め込まれた MAPI プロパティの詳細な検査を可能にします。開発者は `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 ライブラリですが、コマンドラインユーティリティや API が含まれており、Outlook データを CSV、JSON、XML などの広く使用されているフォーマットへエクスポートすることを容易にします。`pffexport` のようなツールは、PST/OST の内容を構造化テキストファイルに変換し、フォルダー階層やメッセージメタデータを保持します。開発者はライブラリをプログラムから利用して、カスタムエクスポーターを構築することも可能です—例えば、MAPI プロパティを JSON オブジェクトにマッピングして検索エンジンや分析プラットフォームに取り込むことができます。このエクスポート機能は、データ移行、バックアップ、標準化された入力フォーマットを必要とする最新のクラウドサービスとの統合において重要です。libpff の柔軟な設計により、開発者は特定のコンプライアンスやワークフロー要件に合わせてエクスポートロジックを調整できます。
CLI を使用して 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
