Enterprise エディション
Forensics — 詳細リファレンス
この詳細リファレンスでは、リビジョンの境界がどのように定められ、オブジェクトの変更がリビジョンチェーン全体でどのように分類され、イベントがどのようにグループ化されるかを説明します。
提供とライセンス
「提供とライセンス」という見出しのセクションこの機能は NextPDF Enterprise（nextpdf/enterprise）に同梱され、Enterprise ティアのライセンスエンベロープで有効化されます。そのエンタイトルメントを持たないデプロイメントでは、この機能のクラスはロードされません。エディションを比較してライセンスを取得。
アナライザーは読み取り専用であり、入力を変更しません。
挙動コントラクト
「挙動コントラクト」という見出しのセクションForensicAnalyzer::analyze は、すべてのクロスリファレンスセクションを解析し、リビジョンごとのバイト境界（開始、終了、サイズ）を導出し、リビジョンごとのサマリーを構築します。その後、最新のリビジョンから最も古いリビジョンへと辿り、各リビジョンについて、そのクロスリファレンスエントリを次に古いリビジョンと比較します。
- 現在は存在するが、古いリビジョンには存在せず、フリーエントリでもないオブジェクトは、
Addedに分類されます。 - 現在はフリーエントリだが、以前はフリーではなかったオブジェクトは、以前のリビジョンを記録したうえで
Deletedに分類されます。 - 両方のリビジョンでアクティブだが、バイトオフセットが異なるオブジェクトは、以前のリビジョンを記録したうえで
Modifiedに分類されます。
オブジェクトの変更はリビジョンごとにイベントにグループ化されます。古いリビジョンでは署名されていなかった署名リビジョンは SignatureAdded を生成し、root の更新は CatalogUpdated を生成し、出現する暗号化ディクショナリは EncryptionChanged を生成します。そして、追加、変更、または削除されたオブジェクトのセットは、対応するオブジェクトイベントを生成します。署名の存在は構造的なヒューリスティック（トレーラー内の Document Security Store エントリ）です。これは存在検出であり、検証ではなく、完全性の改ざん防止判定でもありません。
更新のクロスリファレンスセクションには、その更新で追加、変更、または削除されたオブジェクトのみが列挙されます（ISO 32000-2:2020 §7.5.5）。変更されたオブジェクトは新しいコピーとして追記され、そのオフセットが古いものを上書きします（§7.5.6）。Document Security Store は、後のリビジョンで出現する場合があります（§12.8.4）。
パブリック API サーフェス
「パブリック API サーフェス」という見出しのセクションNextPDF\Enterprise\Forensics\ForensicAnalyzer、
NextPDF\Enterprise\Forensics\ForensicReport、
NextPDF\Enterprise\Forensics\RevisionSummary、
NextPDF\Enterprise\Forensics\ForensicEvent、
NextPDF\Enterprise\Forensics\ForensicEventType、
NextPDF\Enterprise\Forensics\ObjectChange、
NextPDF\Enterprise\Forensics\ObjectChangeType。シグネチャは公開ページに記載されています。
この分類は、ISO 32000-2:2020 §7.5.5–§7.5.6 の増分更新モデルを反映しています。アナライザーは、チェーンに対するパーサーの見方を報告します。完全性を認証するものではなく、それ単独では法廷で証拠能力を持ちません。
エッジケースと FIPS モードの挙動
「エッジケースと FIPS モードの挙動」という見出しのセクションDeletedの分類はフリーエントリへの遷移です。そのオブジェクトの古いコピーがまだ解決可能な場合があります。回復不能性の保証ではありません。- トレーラー情報は安全なキーセットにフィルタリングされます。機微なキーは、その値を公開することなく、存在することのみが記録されます。
- このモジュールでは暗号操作は発生しないため、FIPS モード固有の挙動はありません。
公開範囲の境界
「公開範囲の境界」という見出しのセクションこのページは、外部から観測可能な挙動とサポート対象のパブリック API サーフェスのみを記載しています。内部の名前空間パス、ヘルパークラス、メカニズムの表、ランブックのファイル名、チケットのプレフィックスは対象外です。
Core フォールバック
「Core フォールバック」という見出しのセクションNextPDF Core（Apache-2.0）にはリビジョン履歴のフォレンジックアナライザーがありません — なし。この機能には Core ティアの同等品がありません。Core は信頼できる署名検証サーフェスを提供し、アナライザーはそれと組み合わせますが、置き換えることはありません。
Pro フォールバック
「Pro フォールバック」という見出しのセクションNextPDF Pro にはリビジョン履歴のフォレンジックアナライザーがありません — なし。この機能には Pro ティアの同等品がありません。オブジェクトごとの変更分類と JSON シリアライズ可能なレポートは nextpdf/enterprise パッケージにのみ同梱されています。
Enterprise の境界に関する注記
「Enterprise の境界に関する注記」という見出しのセクションリビジョン境界の導出、オブジェクト変更分類ルール、およびイベントタイムラインのグループ化は、挙動レベルで記述されています。署名の存在は構造的なヒューリスティックにすぎません。署名の有効性は、ここでは意図的に対象外としています — それは Core の署名サーフェスの責務です。トレーラー情報は安全なキーセットにフィルタリングされ、機微なキーは、その値を公開することなく、存在することのみが記録されます。
デプロイメントの境界
「デプロイメントの境界」という見出しのセクション分析は、PDF を保持するホスト上でインプロセスに実行されます。ドキュメントコンテンツがホストを離れることはありません。入力 PDF やレポートが個人データを含むかどうか、およびそれぞれをどこに保存するかは、ライブラリの境界外にあるデプロイメントの責任です。オペレーターはレポートから結論を導きます。ライブラリはリビジョンチェーンに対するパーサーの見方を報告し、完全性を認証することはありません。
法令遵守の境界
「法令遵守の境界」という見出しのセクションこのサーフェスには輸出管理上の制限は適用されません。レポートはそれ単独では法廷で証拠能力を持たず、ドキュメント完全性の認証済み判定として提示してはなりません。このリファレンスは法的意見ではありません。