Enterprise phiên bản

Thương hiệu

Tổng quan nhanh

Hệ thống con thương hiệu áp dụng thương hiệu dùng thử hiển thị lên các PDF được tạo trong quá trình dùng thử và không áp dụng gì dưới một giấy phép trả phí. Nó được cung cấp trong gói nextpdf/enterprise, chi phối hành vi dùng thử trên các phiên bản, và được điều khiển hoàn toàn bởi giấy phép — không phải bởi mã ứng dụng. Để biết câu chuyện dùng thử từ đầu đến cuối, xem Dùng thử và thương hiệu dùng thử; trang này ghi tài liệu cho chính hệ thống con thương hiệu.

Tình trạng khả dụng & cấp phép

Năng lực này đi kèm trong NextPDF Enterprise (nextpdf/enterprise) và kích hoạt với một gói giấy phép cấp Enterprise. Một triển khai không có quyền đó sẽ không nạp các lớp của năng lực này. So sánh các phiên bản và nhận giấy phép.

Khác với hầu hết các bề mặt Enterprise, nó mang một mã năng lực riêng, enterprise.branding, vì nó chi phối hành vi dùng thử trên mọi phiên bản — bao gồm cả các triển khai chỉ-Core và chỉ-Pro. Chế độ thương hiệu được phân giải từ gói giấy phép đã ký lúc chạy; không có cờ ứng dụng nào chọn nó, và một giấy phép trả phí trong bất kỳ phiên bản nào đều phân giải thành BrandingMode::None.

Cài đặt

composer require nextpdf/enterprise:^3

Tổng quan khái niệm

Runtime có một chế độ thương hiệu với hai trạng thái, được mô hình hóa bởi BrandingMode:

None — không có thương hiệu dùng thử. Kết quả trả phí và bình thường không bao giờ bị sửa đổi. Đây là mặc định.
EvaluationWatermark — thương hiệu dùng thử hiển thị được áp dụng lên các PDF được tạo.

BrandingStrategyFactory ánh xạ chế độ tới một chiến lược: NullBrandingStrategy cho None (nó không làm gì và không tạo ra sửa đổi nào) và EvaluationBrandingStrategy cho EvaluationWatermark. Trạng thái giấy phép — không phải mã ứng dụng — chọn chế độ. Một giấy phép trả phí không bao giờ tạo ra kết quả có thương hiệu, và không có bản dựng sản phẩm nào để chuyển đổi và không có cờ mã nào để bật/tắt.

Trang này chỉ mô tả hành vi lúc chạy. Nó không đưa ra bảo hành nào và không phát biểu gì về tính đủ điều kiện hay hiệu lực pháp lý; các điều khoản áp dụng cho việc dùng thử hay gói thuê bao của bạn được xác định duy nhất bởi thỏa thuận giấy phép của bạn.

Bề mặt API

Khái niệm	Hành vi
`BrandingMode`	Hai trạng thái: `None` (mặc định, không sửa đổi) hoặc `EvaluationWatermark`.
`BrandingStrategyFactory`	Phân giải một `BrandingMode` thành một chiến lược.
`EvaluationBrandingStrategy`	Áp dụng hình mờ dùng thử và phần trang trí siêu dữ liệu.
`NullBrandingStrategy`	Chiến lược không-thao-tác cho kết quả trả phí / bình thường.
`EvaluationBrandingConfig`	Văn bản hình mờ, phần trang trí siêu dữ liệu, cỡ chữ, mức độ xám, và góc nghiêng — bất biến.
`BrandingStrategy`	Hợp đồng mà tầng tích hợp tiêu thụ: `isActive()`, `buildPageWatermark()`, `decorateProducer()`, `decorateSubject()`.
`BrandingApplicator`	Áp dụng một chiến lược đã phân giải lên các byte PDF đã kết xuất; fail-closed — ném `BrandingApplicationException` khi thương hiệu đang hoạt động không thể được đánh dấu.

Hệ thống con phơi bày một bề mặt có thể gọi nhỏ cho tầng tích hợp áp dụng chiến lược mà giấy phép đã phân giải; mã ứng dụng không bao giờ chọn có gắn thương hiệu hay không. Các mẫu dưới đây cho thấy hai điểm chạm: đọc một chiến lược đã phân giải, và đánh dấu các byte đã kết xuất bằng applicator fail-closed.

Mẫu mã — Bắt đầu nhanh

Phân giải chiến lược mà giấy phép đã chọn và đọc hành vi của nó. Một giấy phép trả phí phân giải thành BrandingMode::None, mà chiến lược của nó không hoạt động và chuyển mọi giá trị qua nguyên vẹn.

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

Mẫu mã — Sản phẩm

Đánh dấu các byte PDF đã kết xuất bằng chiến lược mà giấy phép đã phân giải. BrandingApplicator::apply() trả về đầu vào nguyên vẹn cho một giấy phép trả phí và, với một giấy phép dùng thử, nối thêm hình mờ và các dấu hiệu siêu dữ liệu trong khi vẫn giữ nguyên các byte gốc. Nó ném BrandingApplicationException khi thương hiệu đang hoạt động không thể được áp dụng một cách an toàn — hãy xem đó là điểm cuối và không bao giờ commit các byte chưa được đánh dấu.

<?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;
    }
}

Thương hiệu dùng thử làm gì

Khi giấy phép đang hoạt động chọn EvaluationWatermark, chiến lược dùng thử:

vẽ một văn bản hình mờ chéo màu xám nhạt trên mỗi trang, được kết xuất dưới dạng một luồng nội dung trang trong một trạng thái đồ họa cô lập để nó không làm thay đổi nội dung xung quanh hay bố cục của bạn;
nối thêm một hậu tố dùng thử vào siêu dữ liệu producer của tài liệu;
thêm vào đầu một tiền tố dùng thử cho siêu dữ liệu subject của tài liệu.

Hình mờ dùng một phông chữ Base14 và một ma trận xoay để đặt văn bản theo đường chéo qua tâm trang. Đối tượng cấu hình là bất biến và xác thực các đầu vào của nó (ví dụ, văn bản hình mờ không được rỗng và cỡ chữ phải dương).

Cách một giấy phép trả phí gỡ bỏ thương hiệu

Dưới một giấy phép trả phí (không phải dùng thử), chế độ thương hiệu là None và chiến lược null được chọn: không có hình mờ, không có hậu tố producer, không có tiền tố subject. Kết quả giống hệt kết quả được tạo mà hoàn toàn không có hệ thống con thương hiệu. Việc gỡ bỏ thương hiệu dùng thử không cần thay đổi mã — hãy cài đặt một giấy phép trả phí và tài liệu được tạo tiếp theo sẽ không có thương hiệu.

Trường hợp biên & điều cần lưu ý

Thương hiệu xuất hiện khi trạng thái giấy phép là kiểu dùng thử. Điều này phản ánh trạng thái giấy phép, không phải một lỗi; hãy kiểm tra tình trạng giấy phép và gia hạn qua cổng giấy phép.
Hình mờ được căn giữa và đặt theo đường chéo theo thiết kế để kết quả dùng thử không bị nhầm lẫn; nó không nhằm được tinh chỉnh cho sản phẩm. Một giấy phép trả phí gỡ bỏ nó hoàn toàn.
Siêu dữ liệu producer và subject mang theo các dấu hiệu dùng thử trong quá trình dùng thử và không có dưới một giấy phép trả phí.

Hiệu năng

Hình mờ là một luồng nội dung theo trang nhỏ, cố định, với tác động không đáng kể lên thời gian tạo hay kích thước tài liệu. Dưới một giấy phép trả phí, hệ thống con không làm gì. Ngân sách hiệu năng của trang phản ánh việc kết xuất tài liệu.

Lưu ý bảo mật

Thương hiệu dùng thử là một dấu hiệu hiển thị, không phải một biện pháp kiểm soát bảo mật. Nó cho biết kết quả là bản dùng thử. Nó không phải là một chữ ký số và không được dựa vào như một chữ ký số. Để có kết quả chống giả mạo, hãy dùng các năng lực ký được mô tả trong ma trận tính năng. Giấy phép chọn chế độ thương hiệu là một gói đã ký mà runtime xác minh chữ ký của bên phát hành.

Lưu trú dữ liệu & biện pháp giảm thiểu PII

Hệ thống con thương hiệu thêm một hình mờ cố định và các dấu hiệu siêu dữ liệu; nó không đọc hay truyền nội dung tài liệu và không thực hiện cuộc gọi mạng nào.

Đo từ xa an toàn & làm sạch nhật ký

Hệ thống con không ghi nhật ký nội dung tài liệu. Các chuyển đổi trạng thái giấy phép làm thay đổi chế độ thương hiệu được phơi bày thông qua hệ thống con cấp phép, không phải ở đây.

Tính phù hợp

Không có tuyên bố nào về tính phù hợp tiêu chuẩn cho trang này. Trang chỉ mô tả hành vi lúc chạy. Trang không nêu hay ngụ ý bất kỳ bảo hành, chứng nhận, hay tính đủ điều kiện nào. Các điều khoản của việc dùng thử hay gói thuê bao của bạn được xác định duy nhất bởi thỏa thuận giấy phép của bạn.

Hành vi ở chế độ FIPS

Module này không thực hiện thao tác mã hóa nào. Việc xác minh chữ ký giấy phép do hệ thống con cấp phép xử lý.

Mô hình mối đe dọa

Bản thân hệ thống con thương hiệu không xử lý đầu vào bên ngoài nào ngoài chế độ thương hiệu đã được phân giải. Gói giấy phép chọn chế độ là đã ký và chữ ký của bên phát hành được runtime xác minh; việc giả mạo chế độ sẽ đòi hỏi làm giả chữ ký đó.

Hợp đồng hành vi

BrandingMode có hai trạng thái: None (mặc định; không sửa đổi kết quả) và EvaluationWatermark.
Dưới một giấy phép trả phí (không phải dùng thử), chế độ là None và chiến lược null được chọn: kết quả giống hệt kết quả được tạo mà hoàn toàn không có hệ thống con thương hiệu.
Dưới một giấy phép dùng thử, chiến lược vẽ một hình mờ chéo trong một trạng thái đồ họa cô lập và nối thêm các dấu hiệu dùng thử vào siêu dữ liệu producer và subject.
Đối tượng cấu hình là bất biến và xác thực các đầu vào của nó (văn bản hình mờ không rỗng, cỡ chữ dương).

Ranh giới công bố

Trang này chỉ ghi tài liệu về hành vi có thể quan sát được từ bên ngoài và bề mặt API công khai được hỗ trợ. Các đường dẫn namespace nội bộ, các lớp trợ giúp, các bảng cơ chế, các tên tệp runbook, và các tiền tố ticket nằm ngoài phạm vi.

Phương án dự phòng Core

Hệ thống con thương hiệu đi kèm trong gói nextpdf/enterprise nhưng chi phối hành vi dùng thử trên mọi phiên bản, bao gồm các triển khai chỉ có Core và chỉ có Pro dùng một giấy phép dùng thử. Không có hệ thống con thương hiệu chỉ-Core nào để dự phòng; một giấy phép trả phí trong bất kỳ phiên bản nào đều phân giải thành BrandingMode::None.

Phương án dự phòng Pro

Không có hệ thống con thương hiệu Pro riêng. Cùng hệ thống con thương hiệu nextpdf/enterprise chi phối hành vi dùng thử cho các triển khai Pro; một giấy phép Pro trả phí phân giải thành BrandingMode::None y hệt như một giấy phép Enterprise trả phí.

Lưu ý về ranh giới Enterprise

Chi tiết cơ chế nội bộ nằm trong tài liệu nội bộ của kho mã nguồn và ngoài phạm vi của sổ tay này.

Ranh giới triển khai

Gói giấy phép chọn chế độ thương hiệu là một tạo phẩm đã ký mà runtime xác minh chữ ký của bên phát hành; việc cấp phát giấy phép, gia hạn, và lưu trữ giấy phép an toàn là trách nhiệm của người vận hành. Hệ thống con không thực hiện cuộc gọi mạng nào và không đọc nội dung tài liệu nào.

Ranh giới tuân thủ pháp lý

Trang này chỉ mô tả hành vi lúc chạy. Trang không nêu hay ngụ ý bất kỳ bảo hành, chứng nhận, hay tính đủ điều kiện nào, và nó không cấu thành tư vấn pháp lý. Các điều khoản của việc dùng thử hay gói thuê bao của bạn — bao gồm thương hiệu nào áp dụng và trong bao lâu — được xác định duy nhất bởi thỏa thuận giấy phép của bạn. Hãy tham khảo thỏa thuận đó hoặc liên hệ bộ phận bán hàng.

Xem thêm

Thương hiệu — Tham chiếu chuyên sâu — API công khai và hợp đồng hành vi cho hệ thống con này.
Dùng thử và thương hiệu dùng thử — câu chuyện dùng thử từ đầu đến cuối.
Kích hoạt giấy phép
Tổng quan Enterprise
Ma trận tính năng Core so với Pro so với Enterprise