Skip to main content

Key Inventory

Key Inventory consists of all available Keys that can be managed by the platform. It provides the functionality further described below.

Inventory operations​

The platform offers the following list of operations from the Key Inventory:

OperationDescription
Create new KeyCreate new Key from selected Token Profile
Import KeyImport a Key from a file
Export KeyExport a private or secret key item
Change status of KeyEnable / disable Key
Update Key usageUpdate key usage of the Key
Rename Key itemChange the name of an individual key item
Compromise KeyMark Key as compromised
Destroy KeyDestroy the Key
Delete KeyRemoves the Key from inventory
Sign with KeySign data with the Key
Verify with KeyVerify data with the Key

Importing and exporting keys is described in Import and Export Keys.

Key details​

See Key for more information.

Discovered keys​

A Key usually comes from a Token Profile, where it is created or imported. A discovery that targets keys adds a second source: it brings into the inventory the keys a Discovery Provider finds.

  • No token, public part only. A discovered key belongs to no token and no Token Profile, and the platform holds only its public part. Only a key whose public part is in SubjectPublicKeyInfo form is added to the inventory. A private, secret or split key, or a public part in another form, is listed in the discovery's results as not imported, with the reason.
  • One record per key. A key is identified by the fingerprint of its public key, computed the same way as for the public key of a certificate. A key discovered directly and the same key inside a certificate are one record, whichever arrives first, and a key the inventory already holds is not duplicated.
  • Naming. A key that a discovery adds is named discovered_<reference>_<fingerprint>, where <reference> is the provider's reference for the key and <fingerprint> is the first 8 characters of the key's fingerprint. When a certificate the discovery imports brings the key in first, the key is named after the certificate instead, such as certKey_www.example.com. A key found again later, or one the inventory already held, keeps its name.
  • Where it was found. Where the provider found the key is kept on it as metadata, with the discovery as its source, from every discovery that finds it.

A discovered key starts Active and enabled, with no key usages. Without a token, only the platform's record of the key can change: you can edit it, enable or disable it, update its key usages, mark it compromised and then destroy it, or delete it. Signing, verification, encryption, decryption and export are not available, because no token holds the key.

Columns and views​

The columns, sorting and saved views of the list are described in Columns and Views.