Branding

Branding

En bref

Le sous-système d’image de marque applique une image de marque d’évaluation visible aux PDF générés pendant une évaluation et n’applique rien sous une licence payante. Il est livré dans le paquet nextpdf/enterprise, régit le comportement d’évaluation à travers les éditions, et est entièrement piloté par la licence — non par le code de l’application. Pour le parcours d’évaluation de bout en bout, voir Évaluation et image de marque d’essai ; cette page documente le sous-système d’image de marque lui-même.

Installation

composer require nextpdf/enterprise:^3

Vue d’ensemble conceptuelle

Le runtime a un mode d’image de marque à deux états, modélisé par BrandingMode :

• None — aucune image de marque d’évaluation. La sortie payante et normale n’est jamais modifiée. C’est la valeur par défaut.
• EvaluationWatermark — une image de marque d’évaluation visible est appliquée aux PDF générés.

BrandingStrategyFactory associe le mode à une stratégie : NullBrandingStrategy pour None (elle n’effectue aucun travail et ne produit aucune modification) et EvaluationBrandingStrategy pour EvaluationWatermark. L’état de la licence — non le code de l’application — sélectionne le mode. Une licence payante ne produit jamais de sortie marquée, et il n’y a aucune compilation de production à basculer ni aucun indicateur de code à activer.

Cette page décrit uniquement le comportement à l’exécution. Elle ne formule aucune garantie ni aucune déclaration sur l’éligibilité ou l’effet juridique ; les conditions qui s’appliquent à ton évaluation ou à ton abonnement sont définies uniquement par ton contrat de licence.

Surface d’API

Concept	Comportement
BrandingMode	Deux états : None (par défaut, aucune modification) ou EvaluationWatermark.
BrandingStrategyFactory	Résout un BrandingMode vers une stratégie.
EvaluationBrandingStrategy	Applique le filigrane d’évaluation et la décoration de métadonnées.
NullBrandingStrategy	Stratégie sans effet pour la sortie payante / normale.
EvaluationBrandingConfig	Texte de filigrane immuable, décoration de métadonnées, taille de police, niveau de gris et angle.

Le sous-système d’image de marque est livré dans le paquet nextpdf/enterprise sous le code de capacité enterprise.branding et régit le comportement d’évaluation à travers les éditions. Il est documenté ici au niveau du comportement et est entièrement piloté par la licence.

Il n’y a aucune API applicative appelable à invoquer : le mode d’image de marque est sélectionné par l’enveloppe de licence, non par le code de l’application, de sorte que cette page omet les sections Code sample — Quick start / Code sample — Production que portent les références d’API appelables. La seule configuration actionnable est l’installation du paquet et de la licence ; le frontmatter de compilation déterministe ci-dessous montre comment affirmer une sortie sans image de marque dans un profil de reproductibilité :

# 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

Ce que fait l’image de marque d’évaluation

Lorsque la licence active sélectionne EvaluationWatermark, la stratégie d’évaluation :

• dessine un texte de filigrane diagonal gris clair sur chaque page, rendu comme un flux de contenu de page dans un état graphique isolé afin qu’il n’altère pas le contenu environnant ni ta mise en page ;
• ajoute un suffixe d’évaluation aux métadonnées de producteur du document ;
• préfixe les métadonnées de sujet du document par un préfixe d’évaluation.

Le filigrane utilise une police Base14 et une matrice de rotation pour positionner le texte en diagonale à travers le centre de la page. L’objet de configuration est immuable et valide ses entrées (par exemple, le texte du filigrane ne peut pas être vide et la taille de police doit être positive).

Comment une licence payante retire l’image de marque

Sous une licence payante (non d’évaluation), le mode d’image de marque est None et la stratégie nulle est sélectionnée : aucun filigrane, aucun suffixe de producteur, aucun préfixe de sujet. La sortie est identique à une sortie produite sans aucun sous-système d’image de marque. Retirer l’image de marque d’évaluation ne nécessite aucun changement de code — installe une licence payante et le prochain document généré est sans image de marque.

Cas limites & pièges

• L’image de marque apparaît lorsque l’état de la licence est de type évaluation. Cela reflète l’état de la licence, et non un défaut ; vérifie le statut de la licence et renouvelle via le portail de licences.
• Le filigrane est centré et diagonal par conception afin que la sortie d’évaluation soit sans ambiguïté ; il n’est pas destiné à être ajusté pour la production. Une licence payante le retire entièrement.
• Les métadonnées de producteur et de sujet portent des marqueurs d’évaluation pendant une évaluation et sont absentes sous une licence payante.

Performance

Le filigrane est un petit flux de contenu par page, fixe, avec un impact négligeable sur le temps de génération ou la taille du document. Sous une licence payante, le sous-système n’effectue aucun travail. Le budget de performance de la page reflète le rendu de la documentation.

Notes de sécurité

L’image de marque d’évaluation est un marqueur de visibilité, et non un contrôle de sécurité. Elle indique une sortie d’évaluation. Ce n’est pas une signature numérique et elle ne doit pas être utilisée comme telle. Pour une sortie résistante à l’altération, utilise les capacités de signature décrites dans la matrice des fonctionnalités. La licence qui sélectionne le mode d’image de marque est une enveloppe signée dont le runtime vérifie la signature de l’émetteur.

Résidence des données & mesures d’atténuation des PII

Le sous-système d’image de marque ajoute un filigrane fixe et des marqueurs de métadonnées ; il ne lit ni ne transmet le contenu du document et n’effectue aucun appel réseau.

Télémétrie sûre & nettoyage des journaux

Le sous-système ne journalise pas le contenu du document. Les transitions d’état de licence qui changent le mode d’image de marque sont exposées par le sous-système de licence, et non ici.

Conformité

Aucune conformité à des normes n’est revendiquée pour cette page. Elle décrit uniquement le comportement à l’exécution. Elle n’énonce ni n’implique aucune garantie, certification ou éligibilité. Les conditions de ton évaluation ou de ton abonnement sont définies uniquement par ton contrat de licence.

Comportement en mode FIPS

Ce module n’effectue aucune opération cryptographique. La vérification de la signature de licence est gérée par le sous-système de licence.

Modèle de menace

Le sous-système d’image de marque lui-même ne traite aucune entrée externe au-delà du mode d’image de marque résolu. L’enveloppe de licence qui sélectionne le mode est signée et sa signature d’émetteur est vérifiée par le runtime ; usurper le mode nécessiterait de falsifier cette signature.

Contexte commercial

Évalue l’ensemble complet des fonctionnalités avec l’image de marque d’évaluation, puis retire l’image de marque en installant une licence payante — aucun changement de code, aucune compilation distincte. Voir Évaluation et image de marque d’essai pour le cycle de vie complet de l’évaluation. Pour démarrer une évaluation, visite le portail de licences.

Verrou d’édition

Ce sous-système est livré dans le paquet NextPDF Enterprise sous le code de capacité enterprise.branding et régit le comportement d’évaluation à travers les éditions. Son mode est sélectionné par la licence, non par le code de l’application. Obtenir une licence.

Indicateur de fonctionnalité de licence

Ce sous-système est restreint par le code de capacité enterprise.branding dans le paquet nextpdf/enterprise. Contrairement à la plupart des surfaces Enterprise, il dispose d’un code de capacité dédié parce qu’il régit le comportement d’évaluation à travers toutes les éditions. Le mode d’image de marque est résolu depuis l’enveloppe de licence à l’exécution ; aucun indicateur applicatif ne le sélectionne.

Contrat de comportement

• BrandingMode a deux états : None (par défaut ; aucune modification de la sortie) et EvaluationWatermark.
• Sous une licence payante (non d’évaluation), le mode est None et la stratégie nulle est sélectionnée : la sortie est identique à une sortie produite sans aucun sous-système d’image de marque.
• Sous une licence d’évaluation, la stratégie dessine un filigrane diagonal dans un état graphique isolé et ajoute des marqueurs d’évaluation aux métadonnées de producteur et de sujet.
• L’objet de configuration est immuable et valide ses entrées (texte de filigrane non vide, taille de police positive).

Statut de l’analyse NDA

Cette page publique décrit uniquement le comportement observable de l’extérieur. Elle ne contient aucun chemin d’espace de noms interne, aucun nom de trait interne, aucun nom de fichier de runbook et aucun préfixe de ticket interne. Les détails internes figurent dans la référence approfondie restreinte, sous NDA.

Repli sur le Core

Le sous-système d’image de marque est livré dans le paquet nextpdf/enterprise mais régit le comportement d’évaluation à travers toutes les éditions, y compris les déploiements Core et Pro uniquement qui utilisent une licence d’évaluation. Il n’y a aucun sous-système d’image de marque réservé au Core sur lequel se replier ; une licence payante dans n’importe quelle édition se résout à BrandingMode::None.

Repli sur Pro

Il n’y a aucun sous-système d’image de marque Pro distinct. Le même sous-système d’image de marque nextpdf/enterprise régit le comportement d’évaluation pour les déploiements Pro ; une licence Pro payante se résout à BrandingMode::None exactement comme une licence Enterprise payante.

Note sur la frontière Enterprise

La résolution du mode d’image de marque, le rendu du filigrane et la décoration de métadonnées sont décrits uniquement au niveau du comportement. La correspondance interne entre l’état de licence et le mode, la géométrie interne du filigrane et le câblage interne de la fabrique de stratégies sont hors du périmètre de la surface publique et ne sont pas reproduits ici.

Frontière de déploiement

L’enveloppe de licence qui sélectionne le mode d’image de marque est un artefact signé dont le runtime vérifie la signature de l’émetteur ; l’approvisionnement de la licence, son renouvellement et le stockage sécurisé de la licence relèvent de la responsabilité de l’opérateur. Le sous-système n’effectue aucun appel réseau et ne lit aucun contenu de document.

Frontière de conformité légale

Cette page décrit uniquement le comportement à l’exécution. Elle n’énonce ni n’implique aucune garantie, certification ou éligibilité, et elle ne constitue pas un avis juridique. Les conditions de ton évaluation ou de ton abonnement — y compris l’image de marque qui s’applique et pour combien de temps — sont définies uniquement par ton contrat de licence. Consulte ce contrat ou contacte le service commercial.

Voir aussi

• Évaluation et image de marque d’essai — le parcours d’évaluation de bout en bout.
• Activation de licence
• Vue d’ensemble Enterprise
• Matrice des fonctionnalités cœur vs Pro vs Enterprise