Branding

Branding

W skrócie

Podsystem brandingu nakłada widoczny branding ewaluacyjny na generowane pliki PDF podczas ewaluacji, a pod płatną licencją nie nakłada niczego. Jest dostarczany w pakiecie nextpdf/enterprise, reguluje zachowanie ewaluacyjne we wszystkich edycjach i jest sterowany w całości przez licencję — a nie przez kod aplikacji. Pełną historię ewaluacji od początku do końca opisuje Wersja próbna i branding ewaluacyjny; ta strona dokumentuje sam podsystem brandingu.

Instalacja

composer require nextpdf/enterprise:^3

Przegląd koncepcyjny

Środowisko uruchomieniowe ma tryb brandingu o dwóch stanach, modelowany przez BrandingMode:

• None — brak brandingu ewaluacyjnego. Wynik płatny i normalny nigdy nie jest modyfikowany. To wartość domyślna.
• EvaluationWatermark — widoczny branding ewaluacyjny jest nakładany na generowane pliki PDF.

BrandingStrategyFactory mapuje tryb na strategię: NullBrandingStrategy dla None (nie wykonuje żadnej pracy i nie powoduje żadnej modyfikacji) oraz EvaluationBrandingStrategy dla EvaluationWatermark. Tryb wybiera stan licencji — a nie kod aplikacji. Płatna licencja nigdy nie wytwarza wyniku z brandingiem; nie ma kompilacji produkcyjnej do przełączenia ani flagi w kodzie do przestawienia.

Ta strona opisuje wyłącznie zachowanie w czasie wykonania. Nie udziela żadnej gwarancji ani nie formułuje żadnego twierdzenia o uprawnieniach lub skutkach prawnych; warunki mające zastosowanie do Twojej ewaluacji lub subskrypcji są zdefiniowane wyłącznie przez Twoją umowę licencyjną.

Powierzchnia API

Koncepcja	Zachowanie
BrandingMode	Dwa stany: None (domyślny, brak modyfikacji) lub EvaluationWatermark.
BrandingStrategyFactory	Rozwiązuje BrandingMode na strategię.
EvaluationBrandingStrategy	Nakłada znak wodny ewaluacji oraz dekorację metadanych.
NullBrandingStrategy	Strategia bez efektu (no-op) dla wyniku płatnego / normalnego.
EvaluationBrandingConfig	Niemutowalny tekst znaku wodnego, dekoracja metadanych, rozmiar czcionki, poziom szarości oraz kąt.

Podsystem brandingu jest dostarczany w pakiecie nextpdf/enterprise pod kodem możliwości enterprise.branding i reguluje zachowanie ewaluacyjne we wszystkich edycjach. Jest tu udokumentowany na poziomie zachowania i jest sterowany w całości przez licencję.

Nie istnieje wywoływalne API aplikacji do uruchomienia: tryb brandingu jest wybierany przez kopertę licencyjną, a nie przez kod aplikacji, więc ta strona pomija sekcje Code sample — Quick start / Code sample — Production, które niosą referencje wywoływalnego API. Jedyną możliwą do wykonania konfiguracją jest zainstalowanie pakietu i licencji; poniższy nagłówek (front matter) deterministycznej kompilacji pokazuje, jak potwierdzić wynik bez brandingu w profilu odtwarzalności:

# 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

Co robi branding ewaluacyjny

Gdy aktywna licencja wybiera EvaluationWatermark, strategia ewaluacji:

• rysuje jasnoszary, diagonalny tekst znaku wodnego na każdej stronie, renderowany jako strumień treści strony w odizolowanym stanie graficznym, tak aby nie zmieniał otaczającej treści ani Twojego układu;
• dołącza ewaluacyjny przyrostek do metadanych producenta dokumentu;
• poprzedza ewaluacyjnym przedrostkiem metadane tematu dokumentu.

Znak wodny używa czcionki Base14 oraz macierzy obrotu, aby umieścić tekst diagonalnie przez środek strony. Obiekt konfiguracji jest niemutowalny i waliduje swoje dane wejściowe (na przykład tekst znaku wodnego nie może być pusty, a rozmiar czcionki musi być dodatni).

Jak płatna licencja usuwa branding

Pod płatną (nieewaluacyjną) licencją tryb brandingu to None i wybierana jest strategia null: brak znaku wodnego, brak przyrostka producenta, brak przedrostka tematu. Wynik jest identyczny z wynikiem wytworzonym całkowicie bez podsystemu brandingu. Usunięcie brandingu ewaluacyjnego nie wymaga żadnej zmiany w kodzie — zainstaluj płatną licencję, a następny wygenerowany dokument będzie bez brandingu.

Przypadki brzegowe i pułapki

• Branding pojawia się, gdy stan licencji jest typu ewaluacyjnego. Odzwierciedla to stan licencji, a nie defekt; sprawdź status licencji i odnów ją przez portal licencyjny.
• Znak wodny jest z założenia wyśrodkowany i diagonalny, aby wynik ewaluacyjny był jednoznaczny; nie jest przeznaczony do dostrajania na potrzeby produkcji. Płatna licencja usuwa go w całości.
• Metadane producenta i tematu niosą znaczniki ewaluacyjne podczas ewaluacji i są nieobecne pod płatną licencją.

Wydajność

Znak wodny to mały, stały strumień treści na każdą stronę, o pomijalnym wpływie na czas generowania lub rozmiar dokumentu. Pod płatną licencją podsystem nie wykonuje żadnej pracy. Budżet wydajności strony odzwierciedla renderowanie dokumentacji.

Uwagi dotyczące bezpieczeństwa

Branding ewaluacyjny to znacznik widoczności, a nie mechanizm kontroli bezpieczeństwa. Wskazuje wynik ewaluacyjny. Nie jest podpisem cyfrowym i nie wolno na nim polegać jak na podpisie. Aby uzyskać wynik z wykrywalną manipulacją, użyj możliwości podpisywania opisanych w macierzy funkcji. Licencja, która wybiera tryb brandingu, to podpisana koperta, której podpis wystawcy środowisko uruchomieniowe weryfikuje.

Rezydencja danych i środki ograniczające dla danych osobowych (PII)

Podsystem brandingu dodaje stały znak wodny oraz znaczniki metadanych; nie odczytuje ani nie przesyła treści dokumentu i nie wykonuje żadnych wywołań sieciowych.

Bezpieczna telemetria i czyszczenie logów

Podsystem nie loguje treści dokumentu. Przejścia stanu licencji, które zmieniają tryb brandingu, są ujawniane przez podsystem licencjonowania, a nie tutaj.

Zgodność ze standardami

Dla tej strony nie jest deklarowana żadna zgodność ze standardami. Opisuje ona wyłącznie zachowanie w czasie wykonania. Nie stwierdza ani nie sugeruje żadnej gwarancji, certyfikacji ani uprawnień. Warunki Twojej ewaluacji lub subskrypcji są zdefiniowane wyłącznie przez Twoją umowę licencyjną.

Zachowanie w trybie FIPS

Ten moduł nie wykonuje żadnych operacji kryptograficznych. Weryfikacja podpisu licencji jest obsługiwana przez podsystem licencjonowania.

Model zagrożeń

Sam podsystem brandingu nie przetwarza żadnych danych wejściowych z zewnątrz poza rozwiązanym trybem brandingu. Koperta licencyjna, która wybiera tryb, jest podpisana, a jej podpis wystawcy jest weryfikowany przez środowisko uruchomieniowe; sfałszowanie trybu wymagałoby podrobienia tego podpisu.

Kontekst komercyjny

Oceń kompletny zestaw funkcji z brandingiem ewaluacyjnym, a następnie usuń branding, instalując płatną licencję — bez zmian w kodzie, bez osobnej kompilacji. Pełny cykl życia ewaluacji opisuje Wersja próbna i branding ewaluacyjny. Aby rozpocząć ewaluację, odwiedź portal licencyjny.

Brama edycji

Ten podsystem jest dostarczany w pakiecie NextPDF Enterprise pod kodem możliwości enterprise.branding i reguluje zachowanie ewaluacyjne we wszystkich edycjach. Jego tryb jest wybierany przez licencję, a nie przez kod aplikacji. Uzyskaj licencję.

Flaga funkcji licencji

Ten podsystem jest objęty bramą kodu możliwości enterprise.branding w pakiecie nextpdf/enterprise. W przeciwieństwie do większości powierzchni Enterprise ma dedykowany kod możliwości, ponieważ reguluje zachowanie ewaluacyjne we wszystkich edycjach. Tryb brandingu jest rozwiązywany z koperty licencyjnej w czasie wykonania; żadna flaga aplikacji go nie wybiera.

Kontrakt zachowania

• BrandingMode ma dwa stany: None (domyślny; brak modyfikacji wyniku) oraz EvaluationWatermark.
• Pod płatną (nieewaluacyjną) licencją tryb to None i wybierana jest strategia null: wynik jest identyczny z wynikiem wytworzonym całkowicie bez podsystemu brandingu.
• Pod licencją ewaluacyjną strategia rysuje diagonalny znak wodny w odizolowanym stanie graficznym i dołącza znaczniki ewaluacyjne do metadanych producenta i tematu.
• Obiekt konfiguracji jest niemutowalny i waliduje swoje dane wejściowe (tekst znaku wodnego niepusty, rozmiar czcionki dodatni).

Stan skanowania NDA

Ta publiczna strona opisuje wyłącznie zachowanie obserwowalne z zewnątrz. Nie zawiera wewnętrznych ścieżek przestrzeni nazw, żadnych wewnętrznych nazw cech (trait), żadnych nazw plików runbooków ani wewnętrznych prefiksów zgłoszeń. Szczegółowe mechanizmy wewnętrzne znajdują się w głębokiej referencji objętej bramą, pod NDA.

Rozwiązanie awaryjne w Core

Podsystem brandingu jest dostarczany w pakiecie nextpdf/enterprise, ale reguluje zachowanie ewaluacyjne we wszystkich edycjach, w tym we wdrożeniach wyłącznie z Core i Pro, które używają licencji ewaluacyjnej. Nie ma podsystemu brandingu wyłącznie w Core, do którego można by się odwołać; płatna licencja w dowolnej edycji rozwiązuje się na BrandingMode::None.

Rozwiązanie awaryjne w Pro

Nie ma osobnego podsystemu brandingu w Pro. Ten sam podsystem brandingu nextpdf/enterprise reguluje zachowanie ewaluacyjne dla wdrożeń Pro; płatna licencja Pro rozwiązuje się na BrandingMode::None dokładnie tak, jak płatna licencja Enterprise.

Uwaga o granicy Enterprise

Rozwiązanie trybu brandingu, renderowanie znaku wodnego oraz dekoracja metadanych są opisane wyłącznie na poziomie zachowania. Wewnętrzne mapowanie stanu licencji na tryb, wewnętrzna geometria znaku wodnego oraz wewnętrzne połączenie fabryki strategii są poza zakresem powierzchni publicznej i nie są tu odtwarzane.

Granica wdrożenia

Koperta licencyjna, która wybiera tryb brandingu, to podpisany artefakt, którego podpis wystawcy środowisko uruchomieniowe weryfikuje; udostępnianie licencji, jej odnawianie oraz bezpieczne przechowywanie są w gestii operatora. Podsystem nie wykonuje żadnych wywołań sieciowych i nie odczytuje treści dokumentu.

Granica zgodności prawnej

Ta strona opisuje wyłącznie zachowanie w czasie wykonania. Nie stwierdza ani nie sugeruje żadnej gwarancji, certyfikacji ani uprawnień i nie stanowi porady prawnej. Warunki Twojej ewaluacji lub subskrypcji — w tym jaki branding ma zastosowanie i na jak długo — są zdefiniowane wyłącznie przez Twoją umowę licencyjną. Skonsultuj się z tą umową lub skontaktuj się z działem sprzedaży.

Zobacz także

• Wersja próbna i branding ewaluacyjny — historia ewaluacji od początku do końca.
• Aktywacja licencji
• Przegląd Enterprise
• Macierz funkcji: Core vs Pro vs Enterprise