Брендирование

Брендирование

Кратко

Подсистема брендирования применяет видимое оценочное брендирование к создаваемым PDF во время оценки и не применяет ничего при платной лицензии. Она поставляется в пакете nextpdf/enterprise, управляет оценочным поведением во всех редакциях и полностью управляется лицензией — а не кодом приложения. Полный сценарий оценки см. в Пробный период и оценочное брендирование; эта страница документирует саму подсистему брендирования.

Установка

composer require nextpdf/enterprise:^3

Концептуальный обзор

У среды выполнения есть режим брендирования с двумя состояниями, моделируемый BrandingMode:

• None — нет оценочного брендирования. Платный и обычный вывод никогда не изменяется. Это значение по умолчанию.
• EvaluationWatermark — к создаваемым PDF применяется видимое оценочное брендирование.

BrandingStrategyFactory сопоставляет режим со стратегией: NullBrandingStrategy для None (она не выполняет работы и не вносит изменений) и EvaluationBrandingStrategy для EvaluationWatermark. Режим выбирает состояние лицензии — а не код приложения. Платная лицензия никогда не создаёт брендированный вывод, и нет ни продакшн-сборки для переключения, ни флага в коде для изменения.

Эта страница описывает только поведение во время выполнения. Она не даёт никакой гарантии и не делает заявления о праве на участие или юридическом эффекте; условия, применимые к вашей оценке или подписке, определяются исключительно вашим лицензионным соглашением.

Программный интерфейс

Понятие	Поведение
BrandingMode	Два состояния: None (по умолчанию, без изменений) или EvaluationWatermark.
BrandingStrategyFactory	Разрешает BrandingMode в стратегию.
EvaluationBrandingStrategy	Применяет оценочный водяной знак и декорирование метаданных.
NullBrandingStrategy	Стратегия-заглушка для платного / обычного вывода.
EvaluationBrandingConfig	Неизменяемые текст водяного знака, декорирование метаданных, размер шрифта, уровень серого и угол.

Подсистема брендирования поставляется в пакете nextpdf/enterprise под кодом возможности enterprise.branding и управляет оценочным поведением во всех редакциях. Здесь она документирована на уровне поведения и полностью управляется лицензией.

Нет вызываемого API приложения: режим брендирования выбирается конвертом лицензии, а не кодом приложения, поэтому эта страница опускает разделы Code sample — Quick start / Code sample — Production, которые несут справочники с вызываемым API. Единственная действенная настройка — это установка пакета и лицензии; приведённая ниже фронтматтер детерминированной сборки показывает, как утверждать вывод без брендирования в профиле воспроизводимости:

# 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, и выбирается стратегия-заглушка: нет водяного знака, нет суффикса производителя, нет префикса темы. Вывод идентичен выводу, созданному вообще без подсистемы брендирования. Удаление оценочного брендирования не требует изменения кода — установите платную лицензию, и следующий созданный документ будет без брендирования.

Граничные случаи и подводные камни

• Брендирование появляется, когда состояние лицензии соответствует оценочному типу. Это отражает состояние лицензии, а не дефект; проверьте статус лицензии и продлите её через портал лицензий.
• Водяной знак по замыслу центрирован и расположен диагонально, чтобы оценочный вывод был однозначным; он не предназначен для тонкой настройки под продакшн. Платная лицензия удаляет его полностью.
• Метаданные производителя и темы несут оценочные маркеры во время оценки и отсутствуют при платной лицензии.

Производительность

Водяной знак — это небольшой фиксированный поток содержимого на страницу с пренебрежимо малым влиянием на время генерации или размер документа. При платной лицензии подсистема не выполняет работы. Бюджет производительности страницы отражает отрисовку документации.

Примечания по безопасности

Оценочное брендирование — это маркер видимости, а не средство контроля безопасности. Оно указывает на оценочный вывод. Это не цифровая подпись, и на него нельзя полагаться как на таковую. Для вывода с защитой от подделки используйте возможности подписания, описанные в матрице возможностей. Лицензия, выбирающая режим брендирования, — это подписанный конверт, подпись издателя которого среда выполнения проверяет.

Резидентность данных и меры по защите PII

Подсистема брендирования добавляет фиксированный водяной знак и маркеры метаданных; она не читает и не передаёт содержимое документа и не делает сетевых вызовов.

Безопасная телеметрия и очистка журналов

Подсистема не логирует содержимое документа. Переходы состояния лицензии, изменяющие режим брендирования, отражаются подсистемой лицензирования, а не здесь.

Соответствие

Для этой страницы не заявляется никакого соответствия стандартам. Она описывает только поведение во время выполнения. Она не заявляет и не подразумевает никакой гарантии, сертификации или права на участие. Условия вашей оценки или подписки определяются исключительно вашим лицензионным соглашением.

Поведение в режиме FIPS

Этот модуль не выполняет криптографических операций. Проверка подписи лицензии обрабатывается подсистемой лицензирования.

Модель угроз

Сама подсистема брендирования не обрабатывает внешнего ввода сверх разрешённого режима брендирования. Конверт лицензии, выбирающий режим, подписан, и его подпись издателя проверяется средой выполнения; подмена режима потребовала бы подделки этой подписи.

Коммерческий контекст

Оцените полный набор возможностей с оценочным брендированием, затем удалите брендирование, установив платную лицензию, — без изменения кода, без отдельной сборки. Полный жизненный цикл оценки см. в Пробный период и оценочное брендирование. Чтобы начать оценку, посетите портал лицензий.

Ограничение по редакции

Эта подсистема поставляется в пакете NextPDF Enterprise под кодом возможности enterprise.branding и управляет оценочным поведением во всех редакциях. Её режим выбирается лицензией, а не кодом приложения. Получить лицензию.

Флаг возможности лицензии

Эта подсистема ограничена кодом возможности enterprise.branding в пакете nextpdf/enterprise. В отличие от большинства поверхностей Enterprise, у неё есть выделенный код возможности, потому что она управляет оценочным поведением во всех редакциях. Режим брендирования разрешается из конверта лицензии во время выполнения; его не выбирает никакой флаг приложения.

Контракт поведения

• У BrandingMode два состояния: None (по умолчанию; без изменения вывода) и EvaluationWatermark.
• При платной (неоценочной) лицензии режим — None, и выбирается стратегия-заглушка: вывод идентичен выводу, созданному вообще без подсистемы брендирования.
• При оценочной лицензии стратегия рисует диагональный водяной знак в изолированном графическом состоянии и добавляет оценочные маркеры к метаданным производителя и темы.
• Объект конфигурации неизменяем и проверяет свои входные данные (текст водяного знака непустой, размер шрифта положительный).

Статус сканирования на NDA

Эта публичная страница описывает только внешне наблюдаемое поведение. Она не содержит внутренних путей пространств имён, имён внутренних трейтов, имён файлов runbook и внутренних префиксов тикетов. Подробные внутренние детали находятся в закрытом подробном справочнике под NDA.

Резервный вариант Core

Подсистема брендирования поставляется в пакете nextpdf/enterprise, но управляет оценочным поведением во всех редакциях, включая развёртывания только с Core и Pro, использующие оценочную лицензию. Нет отдельной подсистемы брендирования только для Core, к которой можно было бы откатиться; платная лицензия в любой редакции разрешается в BrandingMode::None.

Резервный вариант Pro

Нет отдельной подсистемы брендирования Pro. Та же подсистема брендирования nextpdf/enterprise управляет оценочным поведением для развёртываний Pro; платная лицензия Pro разрешается в BrandingMode::None точно так же, как платная лицензия Enterprise.

Примечание о границе Enterprise

Разрешение режима брендирования, отрисовка водяного знака и декорирование метаданных описаны только на уровне поведения. Внутреннее сопоставление состояния лицензии с режимом, внутренняя геометрия водяного знака и внутренняя связка фабрики стратегий находятся вне области публичного интерфейса и здесь не воспроизводятся.

Граница развёртывания

Конверт лицензии, выбирающий режим брендирования, — это подписанный артефакт, подпись издателя которого среда выполнения проверяет; подготовка, продление и безопасное хранение лицензии — это ответственность оператора. Подсистема не делает сетевых вызовов и не читает содержимое документа.

Граница юридического соответствия

Эта страница описывает только поведение во время выполнения. Она не заявляет и не подразумевает никакой гарантии, сертификации или права на участие и не является юридической консультацией. Условия вашей оценки или подписки — включая то, какое брендирование применяется и как долго, — определяются исключительно вашим лицензионным соглашением. Обращайтесь к этому соглашению или в отдел продаж.

См. также

• Пробный период и оценочное брендирование — полный сценарий оценки.
• Активация лицензии
• Обзор Enterprise
• Матрица возможностей Core, Pro и Enterprise