Branding

Branding

概要

ブランディングサブシステムは、評価期間中に生成された PDF へ目に見える評価ブランディングを適用し、有料ライセンスの下では何も適用しません。これは nextpdf/enterprise パッケージで提供され、エディション全体にわたって評価の挙動を統制し、アプリケーションコードではなくライセンスによって完全に駆動されます。エンドツーエンドの評価ストーリーについては、トライアルと評価ブランディングを参照してください。このページでは、ブランディングサブシステム自体を説明します。

インストール

composer require nextpdf/enterprise:^3

概念の概要

ランタイムには、BrandingMode によってモデル化された 2 つの状態を持つブランディングモードがあります。

• None — 評価ブランディングなし。有料および通常の出力は決して変更されません。これがデフォルトです。
• EvaluationWatermark — 目に見える評価ブランディングが、生成された PDF に適用されます。

BrandingStrategyFactory は、モードをストラテジーにマッピングします。None には NullBrandingStrategy (何も行わず、変更も生成しない)、EvaluationWatermark には EvaluationBrandingStrategy です。モードを選択するのは、アプリケーションコードではなくライセンス状態です。有料ライセンスがブランディングされた出力を生成することは決してなく、切り替えるべき本番ビルドも、反転させるべきコードフラグもありません。

このページでは、ランタイムの挙動のみを説明します。保証や、資格または法的効果に関する記述は一切行いません。お客様の評価またはサブスクリプションに適用される条件は、お客様のライセンス契約によってのみ定められます。

API サーフェス

概念	挙動
BrandingMode	2 つの状態: None (デフォルト、変更なし) または EvaluationWatermark。
BrandingStrategyFactory	BrandingMode をストラテジーに解決する。
EvaluationBrandingStrategy	評価用透かしとメタデータ装飾を適用する。
NullBrandingStrategy	有料 / 通常の出力向けの no-op ストラテジー。
EvaluationBrandingConfig	不変の透かしテキスト、メタデータ装飾、フォントサイズ、グレーレベル、角度。

ブランディングサブシステムは、enterprise.branding 機能コードの下で nextpdf/enterprise パッケージに同梱され、エディション全体にわたって評価の挙動を統制します。ここでは挙動レベルで文書化されており、ライセンスによって完全に駆動されます。

呼び出すべきアプリケーション API はありません。ブランディングモードはアプリケーションコードではなくライセンスエンベロープによって選択されるため、このページでは、呼び出し可能な API リファレンスが持つ Code sample — Quick start / Code sample — Production のセクションを省略します。実行可能な唯一の構成は、パッケージとライセンスのインストールです。以下の決定論的ビルドフロントマターは、再現性プロファイルでブランディングなしの出力をアサートする方法を示しています。

# Front matter for a reproducible (no-evaluation-branding) build profile.
# BrandingMode::None is the default; a paid license keeps it None.
reproducibility_profile: structural
branding_mode_expected: none   # assert null strategy: no watermark, no metadata markers

評価ブランディングが行うこと

アクティブなライセンスが EvaluationWatermark を選択すると、評価ストラテジーは次を行います。

• 各ページに薄いグレーの斜めの透かしテキストを描画します。これは、周囲のコンテンツやお客様のレイアウトを変更しないよう、分離されたグラフィックス状態でページコンテンツストリームとしてレンダリングされます。
• ドキュメントのプロデューサーメタデータに評価サフィックスを追加します。
• ドキュメントのサブジェクトメタデータに評価プレフィックスを先頭付与します。

透かしは、Base14 フォントと回転行列を使用して、テキストをページ中央を横切って斜めに配置します。構成オブジェクトは不変であり、入力を検証します (たとえば、透かしテキストは空にできず、フォントサイズは正でなければなりません)。

有料ライセンスがブランディングを除去する仕組み

有料 (非評価) ライセンスの下では、ブランディングモードは None であり、null ストラテジーが選択されます。透かしなし、プロデューサーサフィックスなし、サブジェクトプレフィックスなしです。出力は、ブランディングサブシステムがまったくない状態で生成された出力と同一です。評価ブランディングの除去にコード変更は不要です — 有料ライセンスをインストールすれば、次に生成されるドキュメントはブランディングされません。

エッジケースと注意点

• ライセンス状態が評価スタイルのときにブランディングが現れます。これはライセンス状態を反映したものであり、不具合ではありません。ライセンスステータスを確認し、ライセンスポータルを通じて更新してください。
• 透かしは、評価出力が明確になるよう、設計上、中央かつ斜めです。本番向けにチューニングすることを意図したものではありません。有料ライセンスはそれを完全に除去します。
• プロデューサーおよびサブジェクトのメタデータは、評価期間中は評価マーカーを保持し、有料ライセンスの下では存在しません。

パフォーマンス

透かしは、小さく固定されたページごとのコンテンツストリームであり、生成時間やドキュメントサイズへの影響はごくわずかです。有料ライセンスの下では、サブシステムは何も行いません。ページのパフォーマンス予算は、ドキュメントのレンダリングを反映しています。

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

評価ブランディングは可視性マーカーであり、セキュリティ管理策ではありません。これは評価出力を示します。デジタル署名ではなく、署名として依拠してはなりません。改ざん検知性のある出力には、機能マトリクスで説明されている署名機能を使用してください。ブランディングモードを選択するライセンスは、発行者署名をランタイムが検証する署名済みエンベロープです。

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

ブランディングサブシステムは、固定された透かしとメタデータマーカーを追加します。ドキュメントコンテンツを読み取ったり送信したりすることはなく、ネットワーク呼び出しも行いません。

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

サブシステムはドキュメントコンテンツをログに記録しません。ブランディングモードを変更するライセンス状態の遷移は、ここではなく、ライセンスサブシステムを通じて表面化されます。

適合性

このページについて、標準への適合は主張しません。ランタイムの挙動のみを説明します。いかなる保証、認証、または資格も記述または示唆しません。お客様の評価またはサブスクリプションの条件は、お客様のライセンス契約によってのみ定められます。

FIPS モードの挙動

このモジュールは暗号操作を実行しません。ライセンス署名の検証は、ライセンスサブシステムが処理します。

脅威モデル

ブランディングサブシステム自体は、解決されたブランディングモード以外の外部入力を処理しません。モードを選択するライセンスエンベロープは署名されており、その発行者署名はランタイムによって検証されます。モードを偽装するには、その署名を偽造する必要があります。

商業的コンテキスト

評価ブランディングとともに完全な機能セットを評価し、その後、有料ライセンスをインストールすることでブランディングを除去します — コード変更も、個別のビルドも不要です。完全な評価ライフサイクルについては、トライアルと評価ブランディングを参照してください。評価を開始するには、ライセンスポータルをご利用ください。

エディションゲート

このサブシステムは、enterprise.branding 機能コードの下で NextPDF Enterprise パッケージに同梱され、エディション全体にわたって評価の挙動を統制します。そのモードは、アプリケーションコードではなくライセンスによって選択されます。ライセンスを取得。

ライセンス機能フラグ

このサブシステムは、nextpdf/enterprise パッケージの enterprise.branding 機能コードによってゲートされます。ほとんどの Enterprise サーフェスとは異なり、これは専用の機能コードを持ちます。すべてのエディションにわたって評価の挙動を統制するためです。ブランディングモードは、実行時にライセンスエンベロープから解決されます。それを選択するアプリケーションフラグはありません。

挙動コントラクト

• BrandingMode には 2 つの状態があります: None (デフォルト。出力を変更しない) と EvaluationWatermark。
• 有料 (非評価) ライセンスの下では、モードは None であり、null ストラテジーが選択されます。出力は、ブランディングサブシステムがまったくない状態で生成された出力と同一です。
• 評価ライセンスの下では、ストラテジーは分離されたグラフィックス状態で斜めの透かしを描画し、プロデューサーおよびサブジェクトのメタデータに評価マーカーを追加します。
• 構成オブジェクトは不変であり、入力を検証します (透かしテキストは空でないこと、フォントサイズは正であること)。

NDA スキャンステータス

この公開ページでは、外部から観測できる挙動のみを説明します。内部の名前空間パス、内部のトレイト名、ランブックのファイル名、内部のチケットプレフィックスは一切含まれていません。詳細な内部仕様は、NDA の対象であるゲートされた詳細リファレンスに記載されています。

Core フォールバック

ブランディングサブシステムは nextpdf/enterprise パッケージに同梱されていますが、評価ライセンスを使用する Core 専用および Pro 専用のデプロイメントを含め、すべてのエディションにわたって評価の挙動を統制します。フォールバックする Core 専用のブランディングサブシステムはありません。いずれのエディションでも、有料ライセンスは BrandingMode::None に解決されます。

Pro フォールバック

個別の Pro ブランディングサブシステムはありません。同じ nextpdf/enterprise ブランディングサブシステムが、Pro デプロイメントの評価の挙動を統制します。有料の Pro ライセンスは、有料の Enterprise ライセンスとまったく同様に BrandingMode::None に解決されます。

Enterprise の境界に関する注記

ブランディングモードの解決、透かしのレンダリング、およびメタデータの装飾は、挙動レベルでのみ記述しています。内部のライセンス状態からモードへのマッピング、内部の透かしのジオメトリ、および内部のストラテジーファクトリの配線は、公開サーフェスの範囲外であり、ここでは複製していません。

デプロイメントの境界

ブランディングモードを選択するライセンスエンベロープは、発行者署名をランタイムが検証する署名済みアーティファクトです。ライセンスのプロビジョニング、更新、およびライセンスの安全な保管は、オペレーターの責任です。サブシステムはネットワーク呼び出しを行わず、ドキュメントコンテンツを読み取りません。

法令遵守の境界

このページでは、ランタイムの挙動のみを説明します。いかなる保証、認証、または資格も記述または示唆せず、法的助言を構成するものでもありません。お客様の評価またはサブスクリプションの条件 — どのブランディングがどれだけの期間適用されるかを含む — は、お客様のライセンス契約によってのみ定められます。その契約をご確認いただくか、営業担当者にお問い合わせください。

関連項目

• トライアルと評価ブランディング — エンドツーエンドの評価ストーリー。
• ライセンスのアクティベーション
• Enterprise の概要
• Core・Pro・Enterprise の機能マトリクス