Edit on GitHub

Using PKI Express on Java

This articles describes how to use PKI Express on Java

Samples project

The samples project shows the usage of PKI Express together with the Web PKI browser component on a Java 7+ web application (including 8 and 9) using the Spring MVC framework. It is hosted on GitHub:

https://github.com/LacunaSoftware/PkiSuiteSamples/tree/master/java/springmvc

Note

If you are using a previous version of Java, please contact us.

Running the project

To run the project, it's necessary to have the Java Development Kit installed. You can use the following tools:

Using Gradle

  1. Install PKI Express

  2. Download the project or clone the repository

  3. In a command prompt, navigate to the folder Java and run the command gradlew bootRun (on Linux ./gradlew bootRun). If you are using Windows, you can alternatively double-click the file Run-Sample.bat

  4. Once you see the message "Started Application in x.xxx seconds" (the on-screen percentage will not reach 100%), open a web browser and go the URL http://localhost:60695/

Note

If you are on Linux, you may have to add the execution permission to gradlew file by executing the command chmod +x gradlew.

Using Maven

  1. Install PKI Express

  2. Download the project or clone the repository

  3. In a command prompt, navigate to the folder Java and run the command mvn spring-boot:run. To run the command, it's necessary to have the Apache Maven installed.

  4. Once you see the message "Started Application in x.xxx seconds" (the on-screen percentage will not reach 100%), open a web browser and go the URL http://localhost:60695/

Maven package

In order to use PKI Express on Java you must include the Maven package pki-express

If your project uses Maven, add this to your pom.xml:

<dependencies>
    ...
    <dependency>
        <groupId>com.lacunasoftware.pkiexpress</groupId>
        <artifactId>pki-express</artifactId>
        <version>1.18.0</version>
    </dependency>
    ...
</dependencies>

If your project uses Gradle, add this to your build.gradle:

repositories {
    mavenCentral()
} 

dependencies {
    implementation 'com.lacunasoftware.pkiexpress:pki-express:1.18.0'
}

The package is open-source, hosted on GitHub. Feel free to fork it if you need to make any customizations, and even submit and pull request.

See also