Document toolboxDocument toolbox

Trust store

This article describes how to create a trust store that is used by the Nexus OCSP Responder.

The trust store is a file containing certificates for all trusted CAs – the trust anchors. The immediate issuers of the certificates and CRLs/CILs, that certificate status requests are made for, always need to be present in the trust store.

To create a trust store, use the command line tool certadm, located in the /bin directory, relative to the directory where Nexus OCSP Responder is installed. See certadm commands below for more information.

Create a trust store in Windows

This is an example work flow on how to create a trust store and perform some common commands. When you have created the trust store or performed updates, you must restart Nexus OCSP Responder to make the updates take effect, that is, to be inserted into the cache.

  • Create an empty trust store.

    certadm new --store="C:\ProgramFiles\Nexus\OCSP Responder\certs\trust.store" certadm new --store=..\certs\trust.store

Examples:

  • Add the certificate located in the file newCA.crt to the trust store.

    certadm add --store=../certs/trust.store --file=newCA.crt
  • List the contents of the trust store.

    certadm list --store=../certs/trust.store

    Example of a list result:

  • Example: Extract the certificate of the second issuer in this list to the file A.crt.

  • Example: Delete the certificate of the first issuer in the list.

Specify the trust store in OCSP configuration file

  1. In the OCSP configuration file, specify as follows:

    See this table for description of constants and values:

Constants and Values

Description

Constants and Values

Description

<directory>

Replace <directory> with the directory path to the trust store. Default: certs

<filename>

Replace <filename> with the trust store filename. Default: trust.store

certadm commands

These are some useful certadm commands:

See this table for explanations of the commands:

Options and arguments

Description

Options and arguments

Description

help

Use this option to display a description of the options and arguments.

new

Use this option to create an empty trust store.

store <store>

Use this option to specify the trust store file. Replace <store> with the path to the trust store file. Write file paths that include spaces within quotation marks.

Default: trust.store in the current working directory.

add

Use this option to add a certificate to the trust store.

file <file>

Use this option to specify the file to read/write a certificate from/to. Replace <file> with the path to the certificate file. Write file paths that include spaces within quotation marks.

list

Use this option to list the contents of the trust store. You will get a list of all the certificates. Each certificate will be preceded by an integer.

show <i>

Use this option to display the contents of a specified certificate from the trust store. Replace <i> with the integer that specifies the certificate. You have to execute the list option to get this integer.

extract <i>

Use this option to extract a specified certificate from the trust store. Replace <i> with the integer that specifies the certificate. You have to execute the list option to get this integer.

delete <i>

Use this option to delete a specified certificate from the trust store. Replace <i> with the integer that specifies the certificate. You have to execute the list option to get this integer.

The options store and file must be preceded by "--".

 

Copyright 2024 Technology Nexus Secured Business Solutions AB. All rights reserved.
Contact Nexus | https://www.nexusgroup.com | Disclaimer | Terms & Conditions