Skip to Content
Onshore is in early access. Don’t load real customer data until the items in Known limits are closed.
Run it yourselfHardware security modules

Hardware security modules

Banks can keep the master key in their own HSM. Onshore talks to it over PKCS#11: data keys are wrapped under a key created inside the HSM, which never leaves it.

  1. Use the vault-api-hsm image, which includes PKCS#11 support.
  2. Set in .env:
KEY_BACKEND=pkcs11 PKCS11_MODULE=/usr/lib/your-hsm/libpkcs11.so PKCS11_SLOT_LABEL=onshore PKCS11_PIN=… PKCS11_KEY_LABEL=onshore-kek
  1. Mount the module and any client configuration your HSM vendor needs into the vault API container, and restart it.

Tested against SoftHSM, a software HSM. Not yet tested on a hardware HSM. Try it on your HSM in a test environment first.

Last updated on