Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.futurex.com/llms.txt

Use this file to discover all available pages before exploring further.

This section uses Java keytool commands to generate a new key pair on the Vectera Plus, create a Certificate Signing Request (CSR), issue a certificate through an internal or external CA, and import the signed certificate and its accompanying CA certificate into a Java KeyStore. Perform the following tasks to ensure that you can use jarsigner and the signed certificate to sign a JAR file in the next section:
  1. Generate a server key pair and self-signed certificate.
  2. Generate and export a CSR.
  3. Import a CA root certificate.
  4. Import the server certificate signed by the CA.
Because the JDK 8 installation includes keytool, you can run the commands without additional configuration.

Generate a key pair and certificate

Perform the following steps to generate a server key pair and self-signed certificate:
1
Execute the following command:
-alias sets a name to identify the key pair and certificate to be generated. It can be any name (for example, JarSignerDemo).
Shell
keytool -genkeypair -keyalg RSA -keysize 2048 -alias KeytoolDemo -keystore NONE -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
2
When prompted, enter the following information for the server certificate you want to generate and enter a new KeyStore password, which all subsequent keytool and jarsigner commands use:
None
What is your first and last name?
[Unknown]: www.example.com

What is the name of your organizational unit?
[Unknown]: Engineering

What is the name of your organization?
[Unknown]: Futurex

What is the name of your City or Locality?
[Unknown]: Bulverde

What is the name of your State or Province?
[Unknown]: TX

What is the two-letter country code for this unit?
[Unknown]: US

Is CN=www.example.com, OU=Engineering, O=Futurex, L=Bulverde, ST=TX, C=US correct?
[no]: yes

Generate and export a CSR

Perform the following steps to generate and export a CSR:
1
To generate and export a CSR, run the following command:
Shell
keytool -certreq -alias KeytoolDemo -file example.csr -keystore NONE -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
2
Enter the KeyStore password.
3
Send the CSR to a third-party or internal CA to get it signed.
The CA returns the server certificate and CA certificate for you to import.

Import a certificate

Perform the following steps to import a CA root certificate:
1
To import the CA root certificate, run the following command:
Shell
keytool -import -trustcacerts -alias KeytoolDemoCA -keystore NONE -file ssl-ca-cert.pem -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
2
Enter the KeyStore password.
3
When prompted to trust the certificate, enter Yes as shown in the following example:
Shell
Trust this certificate?
[no]: yes

Certificate was added to keystore.

Import the signed certificate

Perform the following steps to import a server certificate signed by CA:
1
To import the signed server certificate, run the following command:
Shell
keytool -importcert -alias KeytoolDemo -keystore NONE -file signed-example-cert.pem -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
2
Enter the KeyStore password.
If the command was successful, you should see an output similar to the following:
Shell
Certificate reply was installed in keystore.