GitHubContribute in GitHub: Edit online

Viewing a list of keys

You can view a list of your managed keys in UKO with the UKO web interface, or programmatically with the UKO API.

Viewing a list of keys with the UKO web interface

To view a list of your keys by using the web interface, complete the following steps:

  1. Log in to UKO.

  2. Click Managed keys from the navigation to view all the available keys.

  3. Browse the general characteristics of your keys in the table.

    To customize how the table is to be presented, click the Settings icon Settings icon and check the columns to be displayed.

    Table 1. Managed keys table
    Property Description
    Name The unique, human-readable name that is assigned to your key.
    Version The version of the managed key. It is in the format of V plus the version number. For example, V2 means that the key was rotated once and this is the second version of the key material.
    ID A string that uniquely identifies the key.
    Vault The vault that controls access to the managed key.
    State Key states include Pre-active, Active, Deactivated, and Destroyed. For more information, see Monitoring the lifecycle of encryption keys in UKO.

    If your key state is different from the key state in its keystores, an Out of sync flag is displayed beside the state. There can be multiple reasons why the key state is out of sync. For example, you have deactivated the key in this keystore before, or you activate the key through the CLI and the web interface doesn't reflect the state timely. When you hover over this flag, you can see the specific reason. You can sync keys by selecting Show details on the Actions Actions icon menu and clicking Sync keys.

    Key template The key template that the key is created with. For more information, see Creating key templates.
    Activation date The date when the key got activated, or the date on which you plan to activate the key.
    Expiration date The date when the key got deactivated, or the date on which you plan to deactivate the key.
    Last updated The date and time when the key was last updated. This field gets updated when the key is created, edited, or any part of the key metadata is modified.
    Last rotated The date and time when the key was last rotated. If the key was not rotated before, it shows Never.
    Creation date Set a date range of when the key was created.
    Keystores The keystores where the key is activated.
    Algorithm The encryption algorithm to encrypt data for the key.
    Length The number of bits that represents the encryption strength of the key.
    Keystore type The type of keystore where the key is stored.

    You can search for a specific key by using the search bar, or filter keys based on your needs by clicking the Filter icon Filter icon in the Managed keys table. For more information, see Filtering and searching keys.

Viewing a list of keys with the API

To view a list of managed keys through the API, follow these steps:

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

  2. View a list of managed keys by making a GET call to the following endpoint.


    For detailed instructions and code examples about using the API method, check out the Cloud API reference doc.

What's next