This repository contains samples demonstrating the use of the Datalogics PDF Java Toolkit with a Hardware Security Module (HSM) device.
Please note that even though the samples are MIT licensed, you still require a license from Datalogics for PDF Java Toolkit in order to run these samples. Please sign up for an evaluation here or contact us to learn more before evaluating Datalogics PDF Java Toolkit.
- Java SE 1.7
- Maven 3.3.9
- To use these samples, you will need an HSM device, and the associated JARs and development software provided by the HSM supplier. Currently supported HSM devices:
You will need to supply a login password for your HSM device. The sample is written to retrieve the password from a properties file. This file is not included in the repo—you will need to add it to your system.
By default, this file is named hsm.properties and contains a single entry:
hsm.password=SPAAbQDhVOzF+t9ANEg
It will search for this file in the current working directory, or the user's home directory, in that order.
The evaluation version of PDF Java Toolkit has license management, and a different artifact name: pdfjt-lm. There's also a corresponding talkeetna-lm which similarly depends on pdfjt-lm. Switching to use these versions of PDF Java Toolkit and Talkeetna is provided with Maven profiles.
Evaluation copies will come with a license file, with a name ending in .l4j.
Move the license file to the top-level directory of the samples, so that it is in the current directory when running samples.
To use license-managed PDFJT, create a file called .use-pdfjt-lm in the top directory of this project. This will activate profiles automatically for Maven and Eclipse.
If this project was received as part of an evaluation, then the .use-pdfjt-lm file is already created.
The samples were developed and tested using Mars 4.5.0
By default, the samples run with pre-packaged input PDF files that are treated as resources of the samples. However, you can use your own input PDF files including those that are stored remotely on a shared network with the samples. As long as the shared network where the PDF files reside is mounted on your local machine it's treated a part of your local file system.
For more information on working with files in java please see file path java tutorial.
See CONTRIBUTING.md