Pdftools SDK license management

Learn how to manage the Pdftools SDK license keys. The information on this page applies to legacy and page-based licenses. The Pdftools SDK also includes the Toolbox add-on that can be used with the same license key.

Request trial or full license

You can use the Pdftools SDK and the SDK Shell Tool without a license key with watermarked results. To get a full license and remove the watermarks, or to evaluate the Toolbox add-on:

1. Reach out to the sales team through the Contact page and mark the Pdftools SDK as the product of your interest for a trial license.

Find the license key

To find and copy a license key:

1. Log in to My PDF Tools Portal.
2. Click Licenses & Kits.
3. Click Pdftools SDK.
4. In the License section, click the LICENSE button to reveal the license key, and then click COPY.

Use the license key in the same format as you copied it. Include the less-than (<) and greater-than (>) signs.

Trial license

The Pdftools SDK and Pdftools SDK Shell Tool don't require a trial license key, but the Toolbox add-on requires it. You can use the same license key for Pdftools SDK, Pdftools Shell Tool, and the Toolbox add-on.

SDK	To try the SDK	Output files	Get a license key
Pdftools SDK	No trial license key is needed.	Watermarked results without a license key.	To remove the watermark from the output files, contact the sales team through the Contact page.
Pdftools SDK Shell Tool
Toolbox add-on	Obtain a license key to try the SDK.	Obtain a license key to use the SDK.	To try the SDK, contact sales team through the Contact page.

Licensing credit count

Credit-based pricing charges a page credit for each operation performed on a document page.

A page credit is used for:

• Each page of a document.
• Each operation applied to that page.

Review the following table for more information about the credit count in the Pdftools SDK and the Toolbox-add-on for specific operations:

Operation	Page credits used
Annotate	1
Add or remove content	1
Add and fill form fields	1
Archive PDF/A-2	2
Archive PDF/A-3	2
Archive PDF/A-1	2
Redact	1
Compress and optimize	1
Convert	1
Create layout for printing	1
Extract	1
Embed e-invoice	1
Generate PDFs	1
Manage metadata	1
Merge and split PDFs	1
Archive TIFF	1
Sign and secure	1
Validate	1

Only PDF to PDF/A conversion is charged at 2 page credits per operation; all other operations cost 1 page credit.

Operations

An operation is any action performed on a document using the Pdftools SDK. Common operations include:

• File conversions: Converting files to or from PDF (for example, TIFF to PDF, PDF to image).
• Compressing or optimizing PDFs.
• Merging files or extracting pages, adding signatures, encrypting, or annotating PDFs.

Each time you apply an operation to one or more pages, page credits are charged based on each page affected by the operation. Pages that are not affected by the operation are not charged. For example, if you have a 10-page document and only use the extract operation on five pages, only 5 page credits are used.

Calculating credits

To determine how many page credits you'll need for your tasks using the Pdftools SDK, follow this formula:

Number of pages x number of operations = total page credits used

For example:

• Three-page PDF, one operation: Converting a three-page TIFF to PDF requires 3 page credits (1 per page).
• Three-page PDF, two operations: Converting a three-page PDF and then compressing it requires 6 page credits (3 pages x 2 operations).
• Three-page PDF, PDF/A conversion: Converting a three-page PDF to PDF/A requires 6 page credits (3 pages x 2 page credits).

Page credits are calculated for every operation applied. If multiple actions are performed on a file, page credits are consumed for each operation. For example:

• Four pages, one operation: Signing four individual pages of PDF costs 4 page credits (4 pages x 1 operation).
• Four pages, two operations: Converting and compressing a four-page PDF costs 8 page credits (4 pages x 2 operations).
• Four pages, three operations: Converting, compressing, and adding a watermark to a four-page PDF costs 12 page credits (4 pages x 3 operations).

License key validation

License keys are validated using the Pdftools Licensing Service. The SDK connects to the Pdftools Licensing Service to provide information on usage and retrieve new licensing parameters after processing a document.

The Pdftools Licensing Service collects the following statistics and information:

• License number
• Pdftools SDK functions used and the number of pages processed

For information on managing your license key with the Pdftools Licensing Service, see Pdftools Licensing Service.

Activate the Pdftools SDK license

Learn how to activate a license key for the Pdftools SDK. Review the appropriate link for your programming language:

• Initialize the SDK C
• Initialize the SDK Java
• Initialize the SDK .NET
• Initialize the SDK Python
• Initialize the SDK Other languages and frameworks

Activate the Toolbox add-on license

Learn how to activate a license key for the Toolbox add-on. Review the appropriate link for your programming language:

• Initialize the SDK C
• Initialize the SDK Java
• Initialize the SDK .NET

Use Pdftools SDK Shell Tool license

Learn how to use the Pdftools SDK Shell Tool license key:

• Use of license key

Default license configuration

By default, when the Pdftools SDK is initialized, it attempts to connect to the Pdftools Licensing Service directly. This requires an internet connection to the default licensing service URL:

https://licensing.pdf-tools.com/api/v1/licenses/

caution

By default, if the Pdftools SDK cannot connect to the licensing service URL, the SDK initialization fails.

Use the Licensing Gateway

Use the Licensing Gateway Service (LGS) if the Pdftools SDK needs to operate without a direct connection to the Pdftools Licensing Service.

To configure the SDK to use the Licensing Gateway Service, set the LicensingService property of the Sdk class before calling Sdk.Initialize.

.NET

static void Main(string[] args)
{
    try
    {
        // Set the URL to the Licensing Gateway Service.
        Sdk.LicensingService = new Uri("http://my.gateway.com:9999");

        // Set and check license key. If the license key is not valid, an exception is thrown.
        Sdk.Initialize("$LicenseKey$");

Java

public static void main(String[] args)
{
    try
    {
        // Set the URL to the Licensing Gateway Service.
        Sdk.setLicensingService(new java.net.URI("http://my.gateway.com:9999"));

        // Set and check license key. If the license key is not valid, an exception is thrown.
        Sdk.initialize("$LicenseKey$");

note

More information about the LicensingService property is available in the SDK documentation for .NET and Java.

Check the license status

When the Pdftools SDK is successfully initialized, check your license status by accessing the LicenseInfoSnapshot property of the SDK class. This property provides the following information about the current license:

• IsValid: License validity.
• ExpirationDate: The date and time when the license expires.
• RemainingPages: The number of pages available to be processed, based on the license agreement.
• Overconsumption: The number of pages available to be processed, before the SDK stops functioning.

If the RemainingPages value reaches zero, the Pdftools SDK provides a limited number of Overconsumption pages. The Overconsumption pages give you time to update your license agreement without disrupting your business processes.

caution

If both the RemainingPages and Overconsumption values reach zero, the Pdftools SDK stops functioning until the licensing service is updated with new license information.

note

More information about the LicenseInfoSnapshot property is available in the SDK documentation for .NET and Java.

Configure proxy

Configure proxy settings when you need all your HTTPS and HTTP communication to go through one central point in your network. If your implementation of the Pdftools SDK requires connectivity to services external to your network that are not directly reachable by your application (for example, time-stamp authority (TSA), or you are using page credit-based license key with configured LGS), or the SDK is operating in an environment where direct internet access is restricted, such as behind a firewall.

Configure proxy if:

• You have a central point in your network through which you wire all your HTTPS and HTTP communication.
• If you have a page credit-based license key and a central point in your network through which you wire all your HTTPS and HTTP communication.

Condition	Proxy Required?	Notes
All HTTPS/HTTP communication must go through a central network point	Yes	General requirement when routing traffic through a proxy.
SDK must connect to external services not directly reachable (for example, TSA, LGS)	Yes	Includes scenarios behind firewalls or restrictive environments.
Page credit-based license key and centralized HTTPS/HTTP routing	Yes	LGS or credit license usage behind a proxy requires configuration.
Trial license key in use	No	Proxy isn't required even if centralized routing exists.
Page credit-based license key without the need for centralized HTTPS/HTTP routing	No	Proxy isn't required if the app can directly access the internet.

For specific steps to enable the proxy server, review the following resources depending on your use case:

• Digital signing proxy configuration, review Using a proxy server.
• For other use cases, review the following Procedure.

Procedure

To configure a proxy, assign the PdfTools.Sdk class a Proxy server URI that the SDK will use for all HTTP and HTTPS communications with remote services. Follow these steps to configure a proxy:

1. In your application code, set the proxy before initializing the SDK:

   http[s]://[USER[:PASSWORD]@]HOST[:PORT]

   Where:

   • http/https: Protocol for connection to proxy.
   • USER:PASSWORD (optional): Credentials for connection to proxy (basic authorization).
   • HOST: Hostname of proxy.
   • PORT: Port for connection to proxy.

   For example, in C#:

   Sdk.Proxy = new Uri("https://myuser:mypassword@proxy.example.com:8080");

2. After setting the proxy configuration, initialize the SDK using your license key. It is important to call the initialization after the proxy configuration. For more information about the Pdftools SDK initialization, review Activate the Pdftools SDK license.

In the Pdftools SDK Shell Tool, you can configure the proxy using the -proxy URL option. In this option, replace the URL with your actual proxy URL.

Notes

• You can also find information about the proxy configuration in the API references, for example Sdk.Proxy Property in the .NET API documentation.
• Toolbox add-on currently doesn't support proxy configuration.