Skip to content

datalogics-robl/pdf-java-toolkit-hsm-samples

 
 

Repository files navigation

PDF Java Toolkit HSM Sample repository

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.

Requirements

  • 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:

Providing an HSM password

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.

Using with an evaluation version of PDFJT

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.

License file

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.

Tested IDEs

The samples were developed and tested using Mars 4.5.0

Using remote input PDF files

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.

Contributing

See CONTRIBUTING.md

About

PDF Java Toolkit Samples for Hardware Security Modules

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 98.3%
  • sed 1.6%
  • Shell 0.1%