Skip to main content
To segregate applications on the HSM, you must create an application partition specifically for your use case. Application partitions segment the permissions and keys between applications on an HSM. Choose one of the following options to create and configure an application partition:

Excrypt Manager

1
Go to the Application Partitions menu and select [ Add ].
2
In the Basic Information tab, configure all of the fields as follows:
OptionRequired configuration
Role NameSpecify any name that you would like for this new application partition.
Logins Required Set to 1
If the HSM is in FIPS mode, you must set Logins Required to 2.
PortsSet to Prod.
Connection SourcesSet to Ethernet.
Managed RolesLeave blank because you specify the exact Permissions, Key Slots, and Commands for this application partition or role to have access to.
Use Dual FactorSet to Never.
Upgrade PermissionsLeave unchecked.
3
In the Permissions tab, select the following key permissions:
PermissionDescription
KeysTop-level permission
AuthorizedAllows for keys that require login
No Usage Wrap Enables interoperable key wrapping without defining key usage as part of the wrapped key. Use this only if you want to exchange keys with external entities or use the HSM to wrap externally used keys.
4
In the Key Slots tab, we recommend you create a range of 1000 total keys that do not overlap with another application partition. Within the specified range, you should have ranges for both symmetric and asymmetric keys. If the application requires more keys, configure it accordingly.
5
Based on application requirements, enable specific functions on the application partition to use the HSM functionality. You can enable the following commands according to your use case in the Commands tab.PKCS #11 Communication commands:
CommandDescription
ECHOCommunication Test/Retrieve Version
HASHRetrieve device serial
GPKMRetrieve key table information
GPKSGeneral-purpose key settings get/change
TIMERetrieve HSM time
Key Operations commands:
CommandDescription
APFPGenerate PKI Public Key from Private Key
ASYLLoad asymmetric key into key table
GECCGenerate an ECC Key Pair
GPCAGeneral-purpose add certificate to key table
GRSAGenerate RSA Key
RSARGenerate PKCS #10 Certificate Request
LRSALoad RSA Key into Key Table
Data encryption commands:
CommandDescription
GPSRGeneral Purpose RSA Operations
Signing commands:
CommandDescription
ASYSGenerate a Signature by using a PKI Private Key

FXCLI

1
Run the following role FXCLI commands to create the new application partition and enable all required functions:
FXCLI
  role add --name [role_name] --application --key-range (0,999) --perm "Keys:Authorized" --perm "Keys:No Usage Wrap"
Shell
role modify --name [role_name] --add-perm Excrypt:APFP --add-perm Excrypt:ASYL --add-perm Excrypt:ASYS --add-perm Excrypt:ECHO --add-perm Excrypt:GECC --add-perm Excrypt:GPCA --add-perm Excrypt:GPKM --add-perm Excrypt:GPKS --add-perm Excrypt:HASH --add-perm Excrypt:TIME