EJBCA#

EJBCA is a PKI Certificate Authority software available as open source.

To be able to use NetHSM with EJBCA you need to setup the NetHSM PKCS#11 module first.

Then configure EJBCA to use the NetHSM PKCS#11 module by adding an entry in the /etc/ejbca/conf/web.properties file:

cryptotoken.p11.lib.418.name=NetHSM
cryptotoken.p11.lib.418.file=/usr/lib/nitrokey/libnethsm_pkcs11.so

Note

The 418 in the name is an index that must be unique for each PKCS#11 module in the configuration file.

To be able to generate keys from the interface you need to set the enable_set_attribute_value option to true in the p11nethsm.conf file.

Warning

Because of some integration problems with the Sun PKCS11 provider, keys generated from EJBCA will have a random name instead of the name given in the interface.

After restarting EJBCA you can add a new Crypto Token in the EJBCA Admin GUI https://mycahostname/ejbca/adminweb/cryptotoken/cryptotokens.xhtml. The Crypto Token type is PKCS#11 Crypto Token and the Crypto Token name is NetHSM.

Executing The Example#

If you want to experiment with the given example you can use git to clone the nethsm-pkcs11 repository and run the following commands:

  • Configure a NetHSM, either a real one or a container. See the getting-started guide for more information.

  • Change the libnethsm_pkcs11 configuration to match your NetHSM in container/ejbca/p11nethsm.conf.

  • Build the container.

    docker build -f container/ejbca/Dockerfile . -t pkcs-ejbca

  • Run the container.

    docker run --rm -it -p 9443:8443 -p 9080:8080 -h mycahostname -e TLS_SETUP_ENABLED="simple" pkcs-ejbca

The container will be available at https://localhost:9443/.