Marca

De un vistazo

El subsistema de marca aplica una marca de evaluación visible a los PDF generados durante una evaluación y no aplica nada bajo una licencia de pago. Se distribuye en el paquete nextpdf/enterprise, gobierna el comportamiento de evaluación en todas las ediciones y está gobernado por completo por la licencia — no por el código de la aplicación. Para el relato de evaluación de extremo a extremo, consulte Prueba y marca de evaluación; esta página documenta el subsistema de marca en sí.

Instalación

composer require nextpdf/enterprise:^3

Descripción conceptual

El tiempo de ejecución tiene un modo de marca con dos estados, modelado por BrandingMode:

None — sin marca de evaluación. La salida de pago y normal nunca se modifica. Este es el valor predeterminado.
EvaluationWatermark — se aplica una marca de evaluación visible a los PDF generados.

BrandingStrategyFactory asigna el modo a una estrategia: NullBrandingStrategy para None (no realiza ningún trabajo y no produce ninguna modificación) y EvaluationBrandingStrategy para EvaluationWatermark. El estado de la licencia —no el código de la aplicación— selecciona el modo. Una licencia de pago nunca produce salida con marca, y no hay ninguna compilación de producción que cambiar ni ningún indicador de código que activar.

Esta página describe únicamente el comportamiento en tiempo de ejecución. No ofrece ninguna garantía ni declaración sobre elegibilidad o efecto legal; los términos que se aplican a su evaluación o suscripción están definidos únicamente por su acuerdo de licencia.

Superficie de la API

Concepto	Comportamiento
`BrandingMode`	Dos estados: `None` (predeterminado, sin modificación) o `EvaluationWatermark`.
`BrandingStrategyFactory`	Resuelve un `BrandingMode` a una estrategia.
`EvaluationBrandingStrategy`	Aplica la marca de agua de evaluación y la decoración de metadatos.
`NullBrandingStrategy`	Estrategia sin operación para la salida de pago / normal.
`EvaluationBrandingConfig`	Texto de marca de agua, decoración de metadatos, tamaño de fuente, nivel de gris y ángulo inmutables.

El subsistema de marca se distribuye en el paquete nextpdf/enterprise bajo el código de capacidad enterprise.branding y gobierna el comportamiento de evaluación en todas las ediciones. Aquí se documenta a nivel de comportamiento y está gobernado por completo por la licencia.

No hay ninguna API de aplicación invocable que llamar: el modo de marca lo selecciona el sobre de la licencia, no el código de la aplicación, por lo que esta página omite las secciones Code sample — Quick start / Code sample — Production que llevan las referencias de API invocables. La única configuración accionable es instalar el paquete y la licencia; el frontmatter de compilación determinista que aparece a continuación muestra cómo afirmar una salida sin marca en un perfil de reproducibilidad:

# 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

Qué hace la marca de evaluación

Cuando la licencia activa selecciona EvaluationWatermark, la estrategia de evaluación:

dibuja un texto de marca de agua diagonal en gris claro en cada página, representado como un flujo de contenido de página en un estado gráfico aislado, de modo que no altera el contenido circundante ni su maquetación;
añade un sufijo de evaluación a los metadatos de productor del documento;
antepone un prefijo de evaluación a los metadatos de asunto del documento.

La marca de agua utiliza una fuente Base14 y una matriz de rotación para posicionar el texto en diagonal a través del centro de la página. El objeto de configuración es inmutable y valida sus entradas (por ejemplo, el texto de la marca de agua no puede estar vacío y el tamaño de fuente debe ser positivo).

Cómo una licencia de pago elimina la marca

Bajo una licencia de pago (no de evaluación), el modo de marca es None y se selecciona la estrategia nula: sin marca de agua, sin sufijo de productor, sin prefijo de asunto. La salida es idéntica a la salida producida sin ningún subsistema de marca en absoluto. Eliminar la marca de evaluación no requiere ningún cambio de código — instale una licencia de pago y el siguiente documento generado no llevará marca.

Casos límite y trampas

La marca aparece cuando el estado de la licencia es de tipo evaluación. Esto refleja el estado de la licencia, no un defecto; compruebe el estado de la licencia y renuévela a través del portal de licencias.
La marca de agua está centrada y es diagonal por diseño para que la salida de evaluación sea inequívoca; no está pensada para ajustarse para producción. Una licencia de pago la elimina por completo.
Los metadatos de productor y de asunto transportan marcadores de evaluación durante una evaluación y están ausentes bajo una licencia de pago.

Rendimiento

La marca de agua es un flujo de contenido por página pequeño y fijo, con un impacto insignificante en el tiempo de generación o el tamaño del documento. Bajo una licencia de pago, el subsistema no realiza ningún trabajo. El presupuesto de rendimiento de la página refleja la representación de la documentación.

Notas de seguridad

La marca de evaluación es un marcador de visibilidad, no un control de seguridad. Indica una salida de evaluación. No es una firma digital y no se debe confiar en ella como tal. Para una salida con evidencia de manipulación, utilice las capacidades de firma descritas en la matriz de funciones. La licencia que selecciona el modo de marca es un sobre firmado cuya firma del emisor verifica el tiempo de ejecución.

Residencia de datos y mitigaciones de PII

El subsistema de marca añade una marca de agua fija y marcadores de metadatos; no lee ni transmite contenido del documento y no realiza llamadas de red.

Telemetría segura y depuración de registros

El subsistema no registra el contenido del documento. Las transiciones de estado de la licencia que cambian el modo de marca se exponen a través del subsistema de licenciamiento, no aquí.

Conformidad

No se reclama ninguna conformidad con estándares para esta página. Describe únicamente el comportamiento en tiempo de ejecución. No declara ni implica ninguna garantía, certificación ni elegibilidad. Los términos de su evaluación o suscripción están definidos únicamente por su acuerdo de licencia.

Comportamiento en modo FIPS

Este módulo no realiza operaciones criptográficas. La verificación de la firma de la licencia la gestiona el subsistema de licenciamiento.

Modelo de amenazas

El subsistema de marca en sí no procesa ninguna entrada externa más allá del modo de marca resuelto. El sobre de la licencia que selecciona el modo está firmado y su firma de emisor la verifica el tiempo de ejecución; suplantar el modo requeriría falsificar esa firma.

Contexto comercial

Evalúe el conjunto completo de funciones con la marca de evaluación y, después, elimine la marca instalando una licencia de pago — sin cambios de código, sin una compilación independiente. Consulte Prueba y marca de evaluación para el ciclo de vida de evaluación completo. Para iniciar una evaluación, visite el portal de licencias.

Compuerta de edición

Este subsistema se distribuye en el paquete de NextPDF Enterprise bajo el código de capacidad enterprise.branding y gobierna el comportamiento de evaluación en todas las ediciones. Su modo lo selecciona la licencia, no el código de la aplicación. Obtenga una licencia.

Indicador de característica de licencia

Este subsistema está restringido por el código de capacidad enterprise.branding en el paquete nextpdf/enterprise. A diferencia de la mayoría de las superficies de Enterprise, tiene un código de capacidad dedicado porque gobierna el comportamiento de evaluación en todas las ediciones. El modo de marca se resuelve a partir del sobre de la licencia en tiempo de ejecución; ningún indicador de la aplicación lo selecciona.

Contrato de comportamiento

BrandingMode tiene dos estados: None (predeterminado; sin modificación de la salida) y EvaluationWatermark.
Bajo una licencia de pago (no de evaluación), el modo es None y se selecciona la estrategia nula: la salida es idéntica a la salida producida sin ningún subsistema de marca en absoluto.
Bajo una licencia de evaluación, la estrategia dibuja una marca de agua diagonal en un estado gráfico aislado y añade marcadores de evaluación a los metadatos de productor y de asunto.
El objeto de configuración es inmutable y valida sus entradas (texto de marca de agua no vacío, tamaño de fuente positivo).

Estado del escaneo de NDA

Esta página pública describe únicamente el comportamiento observable externamente. No contiene rutas internas de espacio de nombres, ni nombres de trait internos, ni nombres de archivos de runbook, ni prefijos de tickets internos. Los detalles internos están en la referencia profunda restringida bajo NDA.

Alternativa de Core

El subsistema de marca se distribuye en el paquete nextpdf/enterprise, pero gobierna el comportamiento de evaluación en todas las ediciones, incluidas las implementaciones solo con Core y solo con Pro que utilizan una licencia de evaluación. No hay ningún subsistema de marca solo de Core al que recurrir; una licencia de pago en cualquier edición se resuelve en BrandingMode::None.

Alternativa de Pro

No hay ningún subsistema de marca de Pro independiente. El mismo subsistema de marca de nextpdf/enterprise gobierna el comportamiento de evaluación para las implementaciones de Pro; una licencia de pago de Pro se resuelve en BrandingMode::None exactamente igual que una licencia de pago de Enterprise.

Nota sobre el límite de Enterprise

La resolución del modo de marca, la representación de la marca de agua y la decoración de metadatos se describen únicamente a nivel de comportamiento. El mapeo interno de estado de licencia a modo, la geometría interna de la marca de agua y el cableado interno de la fábrica de estrategias quedan fuera del alcance de la superficie pública y no se reproducen aquí.

Límite de despliegue

El sobre de la licencia que selecciona el modo de marca es un artefacto firmado cuya firma de emisor verifica el tiempo de ejecución; el aprovisionamiento de la licencia, su renovación y el almacenamiento seguro de la licencia son responsabilidad del operador. El subsistema no realiza llamadas de red ni lee contenido del documento.

Límite de cumplimiento legal

Esta página describe únicamente el comportamiento en tiempo de ejecución. No declara ni implica ninguna garantía, certificación ni elegibilidad, y no constituye asesoramiento legal. Los términos de su evaluación o suscripción —incluido qué marca se aplica y durante cuánto tiempo— están definidos únicamente por su acuerdo de licencia. Consulte ese acuerdo o contacte con ventas.

Consulte también

Prueba y marca de evaluación — el relato de evaluación de extremo a extremo.
Activación de licencia
Visión general de Enterprise
Matriz de funciones: núcleo frente a Pro frente a Enterprise