This guide shows how to integrate the EJBCA Cloud with AWS CloudHSM.
The AWS CloudHSM is the newer offering from AWS based on Marvell, not to be confused with the SafeNet-based AWS CloudHSM Classic. For more information, refer to the AWS CloudHSM User Guide.
This EJBCA Cloud and AWS CloudHSM integration guide includes the topics listed below.
If you already have a CloudHSM cluster configured, proceed to step 4 - Assigning the Security Group to the EJBCA Instance and then 5b - Configure the cloudhsm-client - SDK3. This will get the EJBCA Cloud instance configured to talk to the CloudHSM cluster so that key creation can begin.
It is necessary to configure the CloudHSM cluster creation and initialization on an EC2 instance that is not an EJBCA instance. The CloudHSM configuration needs sudo access to be completed. Sudo access is not granted to EJBCA instances until after the Wizard setup is complete. Once CloudHSM initialization is completed on another EC2 instance, bring the credentials to EJBCA Cloud configuration wizard and complete EJBCA setup and integration with CloudHSM. For more information, please see the EJBCA Cloud AWS Launch Guide.
Note that users of EJBCA Cloud before 2.6 and EJBCA 7.5.0 need to convert their public keys that were previously stored on the local disk of the EJBCA host and import them into CloudHSM, see CloudHSM Liquidsec Key Conversion.
-
CloudHSM Liquidsec Key Conversion - Important pre 2.6 Notes -
Multiple Crypto Tokens with AWS CloudHSM -
1 - Create CloudHSM Cluster -
2 - Validate the HSM -
3 - Initialize the CloudHSM -
4 - Assigning the Security Group to the EJBCA Instance -
5a - Configure the cloudhsm-client - SDK5 -
5b - Configure the cloudhsm-client - SDK3 -
6 - PKCS11 PIN -
7a - Activate the Cluster - SDK5 -
7b - Activate the Cluster - SDK3 -
8a - Create a CloudHSM Crypto User - SDK5 -
8b - Create a CloudHSM Crypto User - SDK3 -
9 - Create a Keystore in the HSM -
10 - Verify the Keypair for use with EJBCA -
11a - Create a CryptoToken in EJBCA - SDK5 -
11b - Create a CryptoToken in EJBCA - SDK3 -
Appendix A - Restoring an HSM Backup to a New Instance -
Appendix B - Troubleshooting HSM Issues -
Appendix C - Converting liquidsec Public Keys to P11NG Compatible Key Pairs -
Appendix D - Installing the CloudHSM Client -
Appendix E - Importing full CA Keypairs into CloudHSM -
Appendix F - Migrating from SDK3 to SDK5