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.
- Use the
vault-api-hsmimage, which includes PKCS#11 support. - 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- 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