> ## 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.

# Create a Java keystore

> Procedural guide to generate keys, CSRs, and import certificates into a Java keystore using keytool.

This section shows how to use the 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.

These steps ensure that you can use APKSigner and the signed certificate to sign an APK file in the next section.

<Note>
  The JDK 8 installation includes the keytool application, so you can run the keytool commands in this section with no additional configuration.
</Note>

## Generate a  key pair and certificate

Perform the following steps to generate a server key pair and self-signed certificate:

<Steps>
  <Step>
    Execute the following command:

    <Note>
      The -alias field sets a name to identify the key pair and certificate to be generated. It can be any name (for example, apksignerdemo).
    </Note>

    ```shell expandable lines wrap title="Shell" theme={null}
    keytool -genkeypair -keyalg RSA -keysize 2048 -alias apksignerdemo -keystore NONE -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
    ```
  </Step>

  <Step>
    When prompted, answer questions about the server certificate shown in the following example and enter the keystore password, which all **keytool** and **jarsigner** commands use moving forward:

    ```none expandable lines wrap title="None" theme={null}
    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
    ```
  </Step>
</Steps>

## Generate and export a CSR

Perform the following steps to generate and export a CSR:

<Steps>
  <Step>
    To generate and export a CSR, run the following command:

    ```shell expandable lines wrap title="Shell" theme={null}
    keytool -certreq -alias apksignerdemo -file example.csr -keystore NONE -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
    ```
  </Step>

  <Step>
    Enter the keystore password.
  </Step>

  <Step>
    Get the CSR signed by a CA, either third-party or internal.

    <Check>
      After it is signed, the server certificate returned by the CA is imported along with the CA certificate.
    </Check>
  </Step>
</Steps>

## Import a CA root certificate

Perform the following steps to import a CA root certificate:

<Steps>
  <Step>
    To import the CA root certificate, run the following command:

    ```shell expandable lines wrap title="Shell" theme={null}
    keytool -import -trustcacerts -alias apksignerdemoCA -keystore NONE -file ssl-ca-cert.pem -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
    ```
  </Step>

  <Step>
    Enter the keystore password.
  </Step>

  <Step>
    When prompted to trust the certificate, enter **Yes**.

    ```shell expandable lines wrap title="Shell" theme={null}
    Trust this certificate?
    [no]: yes

    Certificate was added to keystore.
    ```
  </Step>
</Steps>

## Import a server certificate

Perform the following steps to import a server certificate signed by a CA:

<Steps>
  <Step>
    To import the signed server certificate, run the following command:

    ```shell expandable lines wrap title="Shell" theme={null}
    keytool -importcert -alias KeytoolDemo -keystore NONE -file signed-example-cert.pem -storetype PKCS11 -providerclass sun.security.pkcs11.SunPKCS11 -providerName SunPKCS11-Futurex
    ```
  </Step>

  <Step>
    Enter the keystore password.

    <Check>
      If the command succeeds, you should see an output similar to the following:

      Certificate reply was installed in keystore.
    </Check>
  </Step>
</Steps>