Enterprise エディション

コンプライアンス

概要

NextPDF Enterprise は、完成した PDF を外部の検証ツール — veraPDF、EU DSS、または Mustang/KoSIT — にルーティングし、統一された構造化された結果を返します。この結果は、外部ツールが何をチェックしたかを記録したものです。証明書、法的見解、またはドキュメントが何らかの規制を満たすという保証ではありません。

提供とライセンス

この機能は NextPDF Enterprise (nextpdf/enterprise) に同梱され、Enterprise ティアのライセンスエンベロープで有効化されます。その権限を持たないデプロイメントでは、この機能のクラスはロードされません。エディションを比較してライセンスを取得。

インストール

composer require nextpdf/enterprise:^3

概念の概要

このモジュールはゲートウェイであり、バリデーターではありません。適合性の判定は外部ツールから得られます。ゲートウェイは適切なツールを選択し、それに委譲し、回答を正規化します。

ComplianceGateway は、ComplianceProfile と PDF バイト列を受け取ります。そのプロファイルを処理する登録済みの ExternalValidator を解決し、サイドカーが到達可能であることをチェックし、チェックを委譲し、ExternalValidationResult を返します。ComplianceProfile は、サポートされるターゲットを列挙します。PDF/A-1b/2b/3b/4/4f、PDF/UA-1/2、PDF 2.0 Arlington 構造モデル、PAdES B-B/B-T/B-LT/B-LTA、ZUGFeRD 2.4 / Factur-X 1.08、および EN 16931 です。各ケースは、規範的な参照と 1 つの外部ツールにマッピングされます。

ExternalValidator は、すべてのサイドカーブリッジが実装するコントラクトです。VeraPdfValidator (veraPDF REST)、DssValidator (EU DSS REST)、ZugferdExternalValidator (Mustang/KoSIT) です。それぞれが PSR-18 HTTP クライアントを介して自身のサイドカーと通信し、ツール固有のレスポンスを 1 つの ExternalValidationResult に変換します。

フェイルクローズポリシーがサイドカーの不在を統制します。デフォルトでは、利用できないサイドカーは ComplianceSidecarUnavailableException を発生させます。バリデーターの欠落は、合格ではなく、チェックできないことを意味します。明示的なオプショナルモードは、その状態をログ記録された警告と null 結果に降格させるため、呼び出し元は「未チェック」を検出して自身で判断できます。AiReadyCertifier は別個のシームです。3 つの準備基準を評価し、nextpdf: XMP プロビナンスブロックをスタンプします。その「certified」レベルは NextPDF 内部の準備状態ラベルです。標準への認証ではなく、規制上のステータスを付与しません。

ここでの「コンプライアンス」の意味

このモジュールは、チェックを委譲し、結果を報告します。ドキュメントが法的に準拠している、認証されている、または法的拘束力があるとは主張しません。

適合性は、最終ファイルとバリデーターの組み合わせの性質であり、このライブラリの性質ではありません。ISO 19005-4:2020 §5.2 は、その義務を適合プロセッサに課し、適合性を、生成ソフトウェアではなくチェックツールによって、標準の規範的要件に対して判定します。
不適合がゼロという結果は、外部ツールが実装する条項に対してチェックされた結果です。包括的な証明書ではありません。
利用できないサイドカーは未チェックを意味します。合格を意味することは決してありません。

あるプロファイルをサポートしていることは、それへの適合と同じではなく、適合は認証でもありません。NextPDF はいかなる認証も保有しておらず、いかなる認証も付与しません。規制上の十分性を判断するには、お客様のコンプライアンスチームにご相談ください。

ティアの境界

エディションを正確に読んでください。それぞれ異なることを行います。

NextPDF Core Conformance / Compliance は、インプロセスのバイトストリームと文法のチェックを実行し、適合性モードの判別子を保持します。Core は標準が定義する構造を出力します。結果を認証することはありません。
NextPDF Pro Compliance (EInvoiceValidator) は、外部サイドカーなしで、EN 16931 / Factur-X / ZUGFeRD をインプロセスで検証します。
NextPDF Enterprise Compliance (このページ) は、外部バリデーターサイドカー (veraPDF、EU DSS、Mustang/KoSIT) に委譲し、フェイルクローズポリシーで結果を正規化します。

Pro のインプロセス電子インボイスバリデーターと Enterprise の外部 ZUGFeRD サイドカーは、別個のサーフェスです。これらを混同しないでください。

この仕組みが機能する理由

適合性は、チェックツールによって測定される完成ファイルの性質であり、生成ライブラリの性質ではありません。そのため、ゲートウェイは判定を権威ある外部ツールに委譲し、解決、委譲、正規化のみを行います。インプロセスで適合性を自己主張することは、「標準に合わせて構築された」ことと「独立して確認された」ことを混同することになり、それは標準が禁じています。フェイルクローズのデフォルトはそこから導かれます。到達不能なサイドカーはチェックできないことを意味するため、合格させるのではなく発生させます。これにより、欠落したチェックが適合性を装うことを防ぎ、認証を保有していないという点で NextPDF を誠実に保ちます。

設計の背景: 監査人に手渡せるコンプライアンス。

API サーフェス

クラス	責務
`ComplianceGateway`	プロファイルのツールを解決し、委譲し、フェイルクローズポリシーを適用する。
`ComplianceProfile`	サポートされるプロファイルの enum。それぞれ標準参照とツールを持つ。
`ExternalValidator`	外部サイドカーブリッジのコントラクト。
`ExternalValidationResult`	統一された結果: プロファイル、ツール、適合フラグ、不適合。
`NonConformance`	外部ツールからの 1 件の不適合の検出結果。
`VeraPdfValidator`	veraPDF REST ブリッジ (PDF/A、PDF/UA、Arlington)。
`DssValidator`	EU DSS REST ブリッジ (PAdES レベル)。
`ZugferdExternalValidator`	Mustang/KoSIT ブリッジ (ZUGFeRD / Factur-X / EN 16931)。
`AiReadyCertifier`	準備状態の評価と `nextpdf:` XMP プロビナンススタンプ。

コードサンプル — クイックスタート

use NextPDF\Enterprise\Compliance\ComplianceProfile;

$result = $gateway->validate($pdfBytes, ComplianceProfile::PdfA4);
$passed = $result?->passes(); // null = sidecar unavailable (not checked)

コードサンプル — 本番

$result = $gateway->validate($pdfBytes, ComplianceProfile::PdfA4);

if ($result === null) {
    $logger->error('compliance.not_checked', ['profile' => 'pdfa-4']);
    // Treat "not checked" as a blocker, never as a pass.
    return;
}

foreach ($result->nonConformances as $nc) {
    $logger->warning('compliance.nonconformance', ['profile' => $result->profile->value]);
}
// A conformant=true result is one input to your decision, not a verdict you own.

エッジケースと注意点

利用できないサイドカーは、デフォルトで ComplianceSidecarUnavailableException を発生させます。オプショナルモードは null を返します。いずれの場合も、ドキュメントは未チェックでした。
登録済みのバリデーターがないプロファイルは、サイレントに合格するのではなく、引数エラーを発生させます。
buildComplianceMatrix() は、トレーサビリティのためにツールバージョンとコミット SHA を記録します。マトリクスはツール出力を報告するものであり、それを認証するものではありません。

パフォーマンス

コストは、外部サイドカーのラウンドトリップと、それに送信されるドキュメントサイズによって支配されます。ゲートウェイの解決と結果の正規化は、呼び出しごとに定数です。

セキュリティに関する注意

PDF バイト列は、PSR-18 クライアントを介してサイドカーに送信されます。VeraPdfValidator は JSON レスポンスのみを解析します (XML なし、XXE クリーン)。サイドカーエンドポイントは信頼境界として扱ってください。サイドカーをピン留めし、そのネットワーク到達範囲を制限し、その TLS を検証してください。

データレジデンシーと PII の緩和策

完全な PDF バイトストリームが、構成されたサイドカーに送信されます。ドキュメントに個人データや規制対象データが含まれる場合は、お客様独自の管理策の下でサイドカーをリージョン内にホストしてください。ゲートウェイはその他のアウトバウンド呼び出しを行いません。結果とログに対して、保持および最小化の管理策を適用してください。

安全なテレメトリとログのスクラブ

ゲートウェイのログには、プロファイル名、ツール名、アサーション数、および不適合数が含まれます。ドキュメントコンテンツは含まれません。プロファイルやファイル名のフィールドが機密である場合は、ログを転送する前にスクラブしてください。

適合性

挙動	参照	ステータス
生成者ではなくチェックツールによって判定される適合性	ISO 19005-4:2020 §5.2	設計に反映済み (フェイルクローズゲートウェイ)
PDF/A-4 ファイル要件	ISO 19005-4:2020 §6.6.4	veraPDF に委譲
PDF/UA-2 適合性 (ファイルの性質)	ISO 14289-2:2024 §6	veraPDF に委譲
PAdES ベースラインレベル	ETSI EN 319 142-1 §5.4.3	EU DSS に委譲

この表は、NextPDF が合わせて構築されている仕様と、外部ツールがチェックする内容を記録したものです。認証または規制上の十分性に関する表明ではありません。

FIPS モードの挙動

このモジュールは暗号署名を実行しません。署名の適合性は EU DSS に委譲されます。鍵の保管と FIPS モード署名はその範囲外です (Signature および Security モジュールを参照)。

脅威モデル

主要な入力は、信頼できない PDF バイト列とサイドカーのレスポンスです。緩和策は、VeraPdfValidator における JSON のみのレスポンス解析、ピン留めされたサイドカー信頼境界、および、到達不能なバリデーターが決して合格に解決されないようにするフェイルクローズポリシーです。

挙動コントラクト

このモジュールはゲートウェイであり、バリデーターではありません。適合性の判定は外部ツール (veraPDF、EU DSS、または Mustang/KoSIT) から得られ、ゲートウェイはツールを選択し、委譲し、回答を正規化します。
不適合がゼロという結果は、外部ツールが実装する条項に対してチェックされた結果であり、包括的な証明書ではありません。
利用できないサイドカーはフェイルクローズします。デフォルトでは例外を発生させ、明示的なオプショナルモードでは null 結果を返します。いずれの場合も、ドキュメントは未チェックであり、合格ではありません。
登録済みのバリデーターがないプロファイルは、サイレントに合格するのではなく、引数エラーを発生させます。
AiReadyCertifier の「certified」レベルは NextPDF 内部の準備状態ラベルであり、標準への認証ではなく、規制上のステータスを付与しません。

公開範囲の境界

このページは、外部から観測できる挙動とサポート対象の公開 API サーフェスのみを説明します。内部の名前空間パス、ヘルパークラス、メカニズムの表、ランブックのファイル名、およびチケットプレフィックスは範囲外です。

Core フォールバック

NextPDF Core Conformance / Compliance は、インプロセスのバイトストリームと文法のチェックを実行し、適合性モードの判別子を保持します。標準が定義する構造を出力しますが、結果を認証することはなく、外部サイドカーに委譲することもありません。外部バリデーターゲートウェイには Core ティアの同等品はありません。

Pro フォールバック

NextPDF Pro Compliance は、外部サイドカーなしで、EN 16931 / Factur-X / ZUGFeRD をインプロセスで検証します。Pro のインプロセス電子インボイスバリデーターと Enterprise の外部 ZUGFeRD サイドカーは別個のサーフェスです。外部バリデーターゲートウェイは nextpdf/enterprise パッケージにのみ同梱されています。これらを混同しないでください。

Enterprise の境界に関する注記

ゲートウェイ、プロファイルからツールへの解決、および結果の正規化は、挙動レベルで記述しています。サイドカーごとのブリッジの内部、ツール固有のレスポンス変換、および内部のオーケストレーションの詳細は、公開サーフェスの範囲外です。

デプロイメントの境界

完全な PDF バイトストリームが、構成されたサイドカーに送信されます。オペレーターはサイドカーをホストして運用し、ピン留めし、そのネットワーク到達範囲を制限し、その TLS を検証します — サイドカーエンドポイントは信頼境界です。ドキュメントに個人データや規制対象データが含まれる場合は、お客様独自の管理策の下でサイドカーをリージョン内にホストし、結果とログに対して保持および最小化の管理策を適用してください。

法令遵守の境界

あるプロファイルをサポートしていることは、それへの適合ではなく、適合は認証でもありません — NextPDF はいかなる認証も保有しておらず、いかなる認証も付与しません。このドキュメントは法的見解ではありません。規制上の十分性を判断するには、お客様のコンプライアンスチームにご相談ください。