Viewing managed key versions

Viewing manage key versions with the UI

If you prefer to view your managed key versions by using a graphical interface, you can use the UI.

Complete the following steps to view the key versions:

1. Log in to the Hyper Protect Crypto Services instance.
2. Go to Menu > Resource list to view a list of your resources.
3. From your IBM Cloud resource list, select your provisioned instance of Hyper Protect Crypto Services with Unified Key Orchestrator.
4. Click Managed keys from the navigation to view all the available keys.
5. Select the key that you want to view and click the Actions icon to open a list of options for the key.
6. Click Show details from the options menu to open the key details page.
7. Click the version number next to the key name to open a list of all the previous key versions. The latest version is always displayed at the top. Click the corresponding key version to view its details. You can also search for a specific key version by entering the version number or the rotation date in the search bar. For example, you can enter 11 to search for version 11, or enter 2014 to search for versions that were rotated in year 2014.

You can no longer edit pervious key versions.

Viewing managed key versions with the API

To view managed key versions through the API, follow these steps:

1. Retrieve your service and authentication credentials to work with keys in the service.

2. View managed key versions by making a GET call based on the following example:

   curl --location --request GET 'https://<instance_ID>.uko.<region>.hs-crypto.appdomain.cloud/api/v4/managed_keys/<id>/versions'
    
   --header 'Authorization: Bearer <IAM_token>' \
   --header 'Accept: application/json'
   

   Replace the variables in the example request according to the following table.

   Table 1. Variables needed to view managed key versions

   Variable	Description
   region	Required. The prefix that represents the geographic area where your service instance resides. For more information, see Regions and locations.
   port	Required. The port number of the API endpoint.
   id	Required. The unique identifier for the managed key that you want to rotate.
   IAM_token	Required. Your IBM Cloud IAM access token that you retrieve in step 1. Include the full contents of the IAM token, including the Bearer value.

For detailed instructions and code examples about using the API method, check out the Hyper Protect Crypto Services Unified Key Orchestrator API reference doc.