Důležité

Tento ovladač je zatím ranou zkušební implementací, která implementuje pouze funkce nezbytné pro provoz serverů TLS, jako je například server HTTPS.

Přístup k modulu NetHSM pomocí ovladače PKCS#11#

  1. Stáhněte si ovladač PKCS#11 pro NetHSM.

  2. Upravte konfigurační soubor p11nethsm.conf podle svého nastavení (např. adresa, jméno operátora) a uložte jej do $HOME/.nitrokey, /etc/nitrokey/ nebo do složky, kde je spuštěna vaše aplikace.

Šifrování a dešifrování#

Po vytvoření klíče (zde: ID 42) pomocí příslušného mechanismu jej můžete použít k šifrování a dešifrování, ale nejprve byste měli vytvořit klíč:

$ KEYID=42

$ HEXID=$(echo ${KEYID}'\c' | xxd -ps)

$ curl -s -X GET https://nethsmdemo.nitrokey.com/api/v1/keys/$KEYID/public.pem -o public.pem

Nyní můžete šifrovat:

$ echo 'NetHSM rulez!' | openssl pkeyutl -encrypt -pubin -inkey public.pem -pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha512 -pkeyopt rsa_mgf1_md:sha512 -out encrypted.data

… A dešifrovat:

$ pkcs11-tool --module p11nethsm.so -v --decrypt --mechanism RSA-PKCS-OAEP --input-file encrypted.data --id $HEXID --hash-algorithm SHA512

Podepisování#

Nejprve znovu vytvořte klíč:

$ KEYID=23

$ HEXID=$(echo ${KEYID}'\c' | xxd -ps)

$ curl -s -X GET https://nethsmdemo.nitrokey.com/api/v1/keys/$KEYID/public.pem -o public.pem

Po vytvoření klíče (zde: ID 23) pomocí příslušného mechanismu jej můžete použít k podepisování:

$ echo 'NetHSM rulez!' | pkcs11-tool --module p11nethsm.so -v --sign --mechanism SHA512-RSA-PKCS-PSS --output-file sig.data --id $HEXID

$ echo 'NetHSM rulez!' | openssl dgst -keyform PEM -verify public.pem -sha512 -sigopt rsa_padding_mode:pss -sigopt rsa_pss_saltlen:-1 -signature sig.data