署名侵害の検出

署名の侵害検出

SignaturesCompromiseDetector は本ガイドのエントリーポイントです。署名された文書のリビジョン履歴を検査し、最後の署名が適用された後にコンテンツが追加されたことを示す指標を探し、見つかったものを CompromiseCheckResult として報告します。これはナレッジベースのこのクラスターがカバーするセキュリティ領域であり、署名の作成や適用、文書の暗号化は対象外です。既に文書に存在する署名のみを調査します。

侵害チェックの実行

調査したい文書で SignaturesCompromiseDetector を構築し、続いて SignaturesCompromiseDetector.check() を呼び出します。このチェックは文書に既に存在するすべての署名をたどり、最後の署名されたリビジョンの後に追加された未署名バイトがないかを確認します――これはコンテンツが後から重ねられた可能性を示すサインです――ただし、後から付加されたカバリング署名による正当な長期検証用資料（例：文書セキュリティストアやアーカイブタイムスタンプ）については許容します。

結果の解釈

SignaturesCompromiseDetector.check() は四つのプロパティを持つ CompromiseCheckResult を返します:

• CompromiseCheckResult.has_compromised_signatures — いずれかの署名が改ざん指標を示した場合の True。
• CompromiseCheckResult.compromised — CompromiseCheckResult.has_compromised_signatures のミラーで、読み取り専用の便利なエイリアスとして提供されます。
• CompromiseCheckResult.signatures_coverage — 検出器が文書上で調査した署名の数。
• CompromiseCheckResult.reasons — 文書がフラグ付けされた理由やタイミングを説明する短い文字列のリスト。

署名が全くない文書、あるいは文書自体が存在しない場合は、侵害されていないと報告され、CompromiseCheckResult.signatures_coverage は 0 に等しくなります。

ヒントとベストプラクティス

• CompromiseCheckResult.compromised と CompromiseCheckResult.has_compromised_signatures を互換的に扱ってください — 常に同じ値を報告します。
• False の結果を信頼する前に CompromiseCheckResult.signatures_coverage を確認してください — カバレッジが 0 であるということは、検出器が調査すべき署名を見つけられなかったことを意味し、既存の署名が無傷であると検証されたことを意味するわけではありません。
• CompromiseCheckResult.has_compromised_signatures が True のときは CompromiseCheckResult.reasons を参照してください — リストはどのヒューリスティックがトリガーされたかを説明し、ログ記録やレビュー担当者への結果提示時に役立ちます。
• SignaturesCompromiseDetector は改訂履歴を検査して改ざん指標を探しますが、暗号署名の完全性を自ら検証するわけではありません；そのため、ワークフローで重要な場合は、文書自身の署名検証結果と組み合わせて使用してください。

一般的な問題

FAQ

CompromiseCheckResult.compromised は実際に何をチェックしますか？

それは CompromiseCheckResult.has_compromised_signatures と同じ値を報告します：SignaturesCompromiseDetector.check() が文書の署名全体で改ざん指標を検出したかどうか。

signatures_coverage が 0 であることは、文書が安全であることを意味しますか？

いいえ — それは調査すべき署名が見つからなかったことを意味します。SignaturesCompromiseDetector は見えない署名について報告できないため、0 のカバレッジは「チェックすべきものがない」結果であり、完全性の確認ではありません。

SignaturesCompromiseDetector は暗号署名を作成または検証できますか？

いいえ。このクラスは、ドキュメントの既存のリビジョン履歴を調べ、最後の署名後にコンテンツが追加されたかどうかの指標を確認するだけです。署名の作成、適用、または暗号的に検証することは、このクラスの範囲外です。

署名後に正当なタイムスタンプを追加すると、常にコンプロマイズ検出がトリガーされますか？

必ずしもそうとは限りません。検出器は、後で追加されたものがその後の署名でカバーされている場合や、新しいコンテンツではなく検証用の資料だけを追加する場合に耐えられるよう設計されています。予期しない検出が出た場合は、CompromiseCheckResult.reasonsを確認してください。

API Reference の概要

参照

• Aspose.PDF for Python — Enterprise Documentation