This page provides information about the hicli commands for managing cloud service providers (CSPs), keysets, cloud keys, and BYOK logs.
Syntax Notation
Notation | Description |
|---|---|
| Specify a value for this parameter. |
| The parameter is optional. |
| Choose one of the listed values. |
| Enable the option by including the flag in the command; no value is shown in the syntax. |
CSP Management
Commands
| Description |
|---|---|
| List configured CSPs. |
| Create a CSP configuration for AWS, Azure, GCP, OCI, or Salesforce. |
| Display details for a CSP. |
| Check a CSP configuration. |
| Remove a CSP configuration. |
| Update a CSP's description, credentials, or provider-specific settings. |
| Rotate a CSP certificate. |
| List users associated with a CSP. |
| List roles associated with a CSP. |
| List regions available for a CSP. |
| List key vaults available for a CSP. |
| List managed HSMs available for a CSP. |
| List keyrings for a CSP and optionally request synchronization. |
| List EKM connections at the specified location. |
| List key algorithms supported by a CSP. |
| Apply a KAJ policy to a CSP, optionally using a file. |
| Enable or disable a CSP's KAJ policy. |
| Apply EKM ACLs to a CSP, optionally using a file. |
| Configure certificate authentication for a CSP. |
| Display certificate details for a CSP. |
CSP parameters
Parameter | Description |
|---|---|
| Name to assign to a new CSP. |
| Group associated with the new CSP. |
| Select an existing CSP by name. |
| Select an existing CSP by GUID. |
| CSP provider type: AWS, AZURE, GCP, OCI, or SFDC. |
| Optional human-readable description. |
| AWS access key ID. |
| Secret access key corresponding to the AWS access key ID. |
| Default AWS region used for CSP operations. |
| Azure tenant ID. |
| Azure subscription ID. |
| Client ID of the Azure application used for authentication. |
| Object ID of the Azure application. |
| Client secret for the Azure application. |
| Enable or disable certificate-based Azure authentication. |
| Specify whether to generate a new certificate when updating the Azure CSP. |
| Specify whether the certificate should be self-signed. |
| Certificate validity period in days. |
| Common name to use for the certificate. |
| Path to the signed certificate file. |
| Path to the private key file. |
| Passphrase used to protect the private key. |
| Path to the GCP key file. |
| URI for the GCP EKM configuration. |
| Service account used for the GCP EKM configuration. |
| OCI user OCID. |
| Fingerprint associated with the OCI signing key. |
| OCI API signing key content. |
| Passphrase for the OCI API signing key. |
| OCI tenancy OCID. |
| OCI bucket used by the configuration. |
| OCI object storage namespace. |
| Salesforce client ID. |
| Salesforce client secret. |
| Salesforce domain. |
| Certificate used for Salesforce key wrapping. |
| Salesforce named credential. |
| Access-key rotation interval in days. |
| Specify whether to synchronize keyrings: yes or no. |
| Location used when listing EKM connections. |
| Input file containing KAJ policy or EKM ACL data. |
Examples
- List the existing CSP accounts:
:~# hicli csp list CSP Account Name | CSP type | CSP guid | group | KeySet ------------------------------------------------------------------------------------------------------------------------------------------------------ cloud_csp | AZURE | 67ebe878-79ea-43e0-9660-d255743ae86b | Cloud Admin Group | cloudkeyset - Get the details of a CSP:
~# hicli csp detail --guid=67ebe878-79ea-43e0-9660-d255743ae86bCSP Account Name : cloud_cspGroup Name : Cloud Admin GroupKeySet Name : cloudkeysetDescription :CSP type : AZURECSP guid : 67ebe878-79ea-43e0-9660-d255743ae86bAzure App Name : ank-testAzure Tenant ID : a885294f-8307-4043-b78b-4a0e4c7f0213Azure Subscription ID : e9f13067-10b4-4136-9fba-58950342182fAzure Application (Client) ID : a2da5dfa-78a4-44a9-91f1-bf6f3734ae77Azure Application Object ID :93872964-657b-46da-976b-7bc8d1e02185Use Certificate Auth : FalseAccess key rotation interval (in days):0Last key rotation (or set) date :09/28/202609:22:43AM GMT
Keyset Management
Commands
| Description |
|---|---|
| List keysets. |
| Create a keyset and optionally configure its CSP, HSM, caching, rekey, XKS, and TDE settings. |
| Display details for a keyset. |
| Select a keyset. |
| Remove a keyset. |
| List keyrings associated with a keyset. |
| Verify HSM configuration for a keyset. |
| Update keyset settings. |
| Add a TDE connector to a keyset. |
| List TDE connectors associated with a keyset. |
| Enable the named TDE connector. |
| Disable the named TDE connector. |
| Delete the named TDE connector. |
| Create a token for a TDE connector. |
| Verify a token for a TDE connector. |
| Set an automatic synchronization schedule for a resource. |
| Purge a container in a key vault or managed HSM. |
Keyset parameters
Parameter | Description |
|---|---|
| Name to assign to a new keyset. |
| Group associated with the new keyset. |
| Select an existing keyset by name. |
| Select an existing keyset by GUID. |
| GUID of the CSP to associate with the keyset. |
| Optional human-readable description. |
| Rekey interval. The |
| Enable or disable HSM use: yes or no. |
| Enable or disable key caching: yes or no. |
| Enable HSM key caching. |
| HSM partition label. |
| Password for the HSM partition. |
| Request that all keys be imported. |
| XKS access ID. |
| XKS secret access key. |
| Database type for the TDE configuration. |
| Controls whether MDB key creation is allowed. |
| Name of the TDE connector. |
| CVM ID associated with the TDE connector. |
| Expiration date for the TDE connector. |
| Token to verify for the TDE connector. |
| Automatic synchronization schedule to set. |
| Region whose synchronization schedule is being configured. |
| Key vault whose synchronization schedule is being configured or whose container is being purged. |
| Managed HSM whose synchronization schedule is being configured or whose container is being purged. |
| Keyring identifier used when setting a synchronization schedule. |
Example
List the existing keysets:
~# hicli keyset listKeySet Name | CSP type | KeySet guid | group | CSP Account name | Number of keys------------------------------------------------------------------------------------------------------------------------------------------------------cloudkeyset | AZURE | db61c7b0-543b-49dd-8983-6d8711b25c41 | Cloud Admin Group | cloud_csp | 0
Cloud Key Management
Commands
| Description |
|---|---|
| List keys in a region, key vault, managed HSM, or keyring. |
| Create a cloud key and configure its location, algorithm, protection, expiry, and provider-specific settings. |
| Update a cloud key's description, rekey, expiry, activation, or provider-specific settings. |
| Display details about a cloud key. |
| Disable a cloud key. |
| Enable a cloud key. |
| Delete a cloud key from the provider. |
| Upload a cloud key to the provider. |
| List versions of a cloud key. |
| Schedule removal of a cloud key or cancel scheduled removal. |
| Purge a cloud key. |
| Import a key into a region, key vault, managed HSM, or keyring. |
| Rotate a cloud key. |
| List tags on a cloud key. |
| Set a tag on a cloud key. |
| Clear a tag from a cloud key. |
| Provide user and administrator lists for a cloud key. |
| Get a cloud key policy and optionally write it to a file. |
| Set a cloud key policy, optionally reading it from a file. |
| Get roles for a keyring key and optionally write them to a file. |
| Set roles for a keyring key, optionally reading them from a file. |
| Set the operations allowed for a cloud key. |
| Get the public key for a cloud key. |
| Set a key version as primary. |
| Apply a KAJ policy to a keyring key. |
| Enable EKM ACLs for a keyring key. |
| Disable EKM ACLs for a keyring key. |
| Apply EKM ACLs to a keyring key. |
Cloud Key parameters
Parameter | Description |
|---|---|
| Name to assign to a new cloud key. |
| Select a cloud key by name. The command may also require the key's provider resource. |
| Region containing or used for the key. |
| Key vault containing or associated with the key. |
| Managed HSM containing or associated with the key. |
| Keyring containing or associated with the key. |
| Identify a key by its handle where supported. |
| Optional human-readable description of the key. |
| Cipher to use for the key. |
| GCP protection level or EKM connection type. |
| Intended purpose of the key. |
| Key algorithm. |
| Request hardware protection for the key. |
| Rekey interval for the key. |
| Specify that the key should not expire. |
| Expiration date in mm/dd/yyyy format or a number of days. |
| Specify whether the expiry value is relative: True or False. |
| Specify that the key should not use key-wide expiry. |
| Key-wide expiration date in mm/dd/yyyy format. |
| Expiration action: DISABLE, DELETE_FROM_CLOUD, or DELETE. |
| Operations to allow for the key. |
| Date when the key should become active. |
| EKM connection to associate with the key. |
| DKE permissions to configure for the key. |
| DKE cache setting. |
| OCI compartment ID for the key. |
| Salesforce data type associated with the key. |
| Salesforce key-derivation setting. |
| Salesforce cache-only-key setting. |
| Number of days before scheduled key removal. |
| Cancel a scheduled key removal. |
| Force-purge option for the purge operation. |
| Tag name to set or clear. |
| Value to assign to a tag. |
| User list supplied to the cloud key command. |
| Administrator list supplied to the cloud key command. |
| Input file containing policy, role, KAJ policy, or EKM ACL data. |
| Output file for policy or role data. |
| GUID of the key version to set as primary. |
Example
List the cloud keys:
hicli cloudkey listKeyRing | CloudKey Name | guid | Cloud Status | handle------------------------------------------------------------------------------------------------------------------------ext_ekm_ring(europe-west2) | testkey1 | fd2c4f21-d390-4b05-bdce-9bd15b5bef75 | AVAILABLE | 21730251-2d6c-45e8-9852-74adf0308dae.europe-west2~ext_ekm_ring.testkey1ext_ekm_ring(europe-west2) | hsmkey1 | 13eaa6be-3c25-42a5-8cc1-235880e4c114 | NOT AVAILABLE | 21730251-2d6c-45e8-9852-74adf0308dae.europe-west2~ext_ekm_ring.hsmkey1
BYOK Logs
Commands
| Description |
|---|---|
| Display BYOK logs for the specified group. |
BYOK parameter
Parameter | Description |
|---|---|
| Group whose BYOK logs should be displayed. |