EJBCA

Avertissement

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. Therefor this documentation is only a Proof-of-Concept. Support for EJBCA will be introduced by NetHSM software 3.0.

EJBCA est un logiciel d’autorité de certification PKI disponible en open source.

Pour pouvoir utiliser NetHSM avec EJBCA, vous devez d’abord installer ` <pkcs11-setup.html>`__ le module NetHSM PKCS#11.

Configurez ensuite EJBCA pour qu’il utilise le module NetHSM PKCS#11 en ajoutant une entrée dans le fichier /etc/ejbca/conf/web.properties :

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

Note

Le nom 418 est un index qui doit être unique pour chaque module PKCS#11 dans le fichier de configuration.

Pour pouvoir générer des clés à partir de l’interface, vous devez définir l’option enable_set_attribute_value sur true dans le fichier p11nethsm.conf.

Après avoir redémarré EJBCA, vous pouvez ajouter un nouveau Crypto Token dans l’interface graphique d’administration d’EJBCA https://mycahostname/ejbca/adminweb/cryptotoken/cryptotokens.xhtml. Le type de jeton de cryptage est PKCS#11 Crypto Token et le nom du jeton de cryptage est NetHSM.

Exécution de l’exemple

Si vous souhaitez expérimenter avec l’exemple donné, vous pouvez utiliser git pour cloner le dépôt nethsm-pkcs11 et exécuter les commandes suivantes :

  • Configure a NetHSM, either a real one or a container. Refer to chapter Getting Started to learn more.

  • Modifiez la configuration de libnethsm_pkcs11 pour qu’elle corresponde à votre NetHSM dans container/ejbca/p11nethsm.conf.

  • Construire le conteneur.

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

  • Exécuter le conteneur.

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

Le conteneur sera disponible à l’adresse suivante : https://localhost:9443/.