Image de marque

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 Essai et image de marque d’évaluation ; cette page documente le sous-système d’image de marque lui-même.

Disponibilité et licence

Cette capacité est livrée dans NextPDF Enterprise (nextpdf/enterprise) et s’active avec une enveloppe de licence de niveau Enterprise. Un déploiement sans cette autorisation ne charge pas les classes de la capacité. Comparer les éditions et obtenir une licence.

Contrairement à la plupart des surfaces Enterprise, elle porte un code de capacité dédié, enterprise.branding, parce qu’elle régit le comportement d’évaluation à travers toutes les éditions — y compris les déploiements Core uniquement et Pro uniquement. Le mode d’image de marque est résolu depuis l’enveloppe de licence signée à l’exécution ; aucun indicateur applicatif ne le sélectionne, et une licence payante dans n’importe quelle édition se résout à BrandingMode::None.

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.
BrandingStrategy	Contrat que consomme la couche d’intégration : isActive(), buildPageWatermark(), decorateProducer(), decorateSubject().
BrandingApplicator	Applique une stratégie résolue aux octets de PDF rendus ; fail-closed — lève BrandingApplicationException lorsque l’image de marque active ne peut pas être marquée.

Le sous-système expose une petite surface appelable pour la couche d’intégration qui applique la stratégie que la licence a résolue ; le code de l’application ne choisit jamais s’il faut appliquer une image de marque. Les exemples ci-dessous montrent les deux points de contact : lire une stratégie résolue, et marquer les octets rendus avec l’applicateur fail-closed.

Exemple de code — Démarrage rapide

Résous la stratégie que la licence a sélectionnée et lis son comportement. Une licence payante se résout à BrandingMode::None, dont la stratégie est inactive et laisse passer chaque valeur inchangée.

resolve-strategy.php

<?php

declare(strict_types=1);

use NextPDF\Enterprise\Branding\BrandingMode;
use NextPDF\Enterprise\Branding\BrandingStrategyFactory;

// The license resolves the mode; None is what a paid license produces.
$strategy = BrandingStrategyFactory::create(BrandingMode::None);

\var_dump($strategy->isActive());                 // bool(false)
echo $strategy->decorateProducer('NextPDF 3.1');  // NextPDF 3.1 (unchanged)

Exemple de code — Production

Marque des octets de PDF déjà rendus avec la stratégie que la licence a résolue. BrandingApplicator::apply() retourne l’entrée inchangée pour une licence payante et, pour une licence d’évaluation, ajoute le filigrane et les marqueurs de métadonnées tout en laissant les octets d’origine intacts. Elle lève BrandingApplicationException lorsque l’image de marque active ne peut pas être appliquée en toute sécurité — traite cela comme terminal et ne valide jamais les octets non marqués.

apply-evaluation-branding.php

<?php

declare(strict_types=1);

use NextPDF\Enterprise\Branding\BrandingApplicationException;
use NextPDF\Enterprise\Branding\BrandingApplicator;
use NextPDF\Enterprise\Branding\BrandingMode;
use NextPDF\Enterprise\Branding\BrandingStrategyFactory;
use NextPDF\Enterprise\Branding\EvaluationBrandingConfig;

/**
 * Apply the branding the license resolved to freshly rendered PDF bytes.
 *
 * @param string       $renderedPdf Bytes from the render engine.
 * @param BrandingMode $mode        Resolved from the signed license envelope.
 *
 * @throws BrandingApplicationException When active branding cannot be marked.
 */
function markEvaluationOutput(string $renderedPdf, BrandingMode $mode): string
{
    $strategy = BrandingStrategyFactory::create(
        $mode,
        new EvaluationBrandingConfig(
            watermarkText: 'EVALUATION COPY — Not for Production Use',
        ),
    );

    try {
        return (new BrandingApplicator())->apply($renderedPdf, $strategy);
    } catch (BrandingApplicationException $e) {
        // Fail-closed: never emit unbranded evaluation output. Dead-letter.
        throw $e;
    }
}

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.

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).

Frontière de publication

Cette page documente uniquement le comportement observable de l’extérieur et la surface d’API publique prise en charge. Les chemins d’espace de noms internes, les classes utilitaires, les tables de mécanismes, les noms de fichiers de runbook et les préfixes de ticket sont hors du périmètre.

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

Les détails internes du mécanisme restent dans la documentation interne du dépôt source et sont hors du périmètre de ce manuel.

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

• Image de marque — Référence approfondie — API publique et contrat de comportement pour ce sous-système.
• Essai et image de marque d’évaluation — le parcours d’évaluation de bout en bout.
• Activation de licence
• Vue d’ensemble Enterprise
• Matrice des fonctionnalités Core vs Pro vs Enterprise