Schlüsselversionen anzeigen

Zeigen Sie die zugeordneten Versionen für einen Rootschlüssel in IBM® Key Protect for IBM Cloud® an.

Wenn Sie eine Schlüsselrotation für einen Rootschlüssel ausführen, wird von Key Protect eine neue Version des Schlüssel erstellt. Als Sicherheitsadministrator können Sie das Rotationsprotokoll für einen Rootschlüssel überprüfen, indem Sie das zugehörige Protokoll der Schlüsselversionen anzeigen.

Schlüsselversionen sind nur für Rootschlüssel verfügbar. Weitere Informationen zur Funktionsweise der Schlüsselrotation in Key Protect finden Sie unter Vergleich Ihrer Optionen für die Schlüsselrotation.

Wie viele Schlüsselversionen haben Sie?

So zeigen Sie an, wie viele Versionen Sie von jedem bereitgestellten Schlüssel haben:

Melden Sie sich bei der „ IBM Cloud “-Konsole an.
Rufen Sie Menü > Ressourcenliste auf, um eine Liste Ihrer Ressourcen anzuzeigen.
Wählen Sie in der IBM Cloud-Ressourcenliste die bereitgestellte Instanz von Key Protect aus.
Klicken Sie im Bereich „Tasten“ auf das Symbol ⋯ und wählen Sie „Details“ aus. Dadurch wird eine Seitenanzeige geöffnet, in der unter anderem die Anzahl der Versionen dieses Schlüssels angezeigt wird.
Wenn Sie wissen möchten, wie viele Schlüsselversionen Sie in Ihrer Instanz haben, müssen Sie diesen Prozess für jeden Schlüssel in Ihrer Instanz wiederholen. Da nur Rootschlüssel rotiert werden können, haben alle Standardschlüssel nur eine Version.

Schlüsselversionen mit der API anzeigen

Für eine allgemeine Ansicht können Sie die Versionen, die einem Rootschlüssel zugeordnet sind, anzeigen, indem Sie einen GET-Aufruf an den folgenden Endpunkt ausführen.

https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/versions

Rufen Sie Ihre Authentifizierungsnachweise ab, um mit den Schlüsseln im Service zu arbeiten.
Rufen Sie die ID des Rootschlüssels ab, den Sie untersuchen wollen.

Der ID-Wert wird für den Zugriff auf detaillierte Informationen zu dem Schlüssel verwendet. Sie können die ID für einen Schlüssel in Ihrer Key Protect-Instanz finden, indem Sie eine Liste Ihrer Schlüssel abrufen oder auf das Key Protect- armaturenbrett.
Sie können eine Liste der Versionen abrufen, die dem Stammschlüssel zugeordnet sind, indem Sie den folgenden Befehl curl ausführen.

Sie können einen Abfrageparameter hinzufügen, ?totalCount=true, wie gezeigt. Dieser Parameter gibt totalCount in den Metadaten der Antwort zur Verwendung mit der Paginierung zurück.
```
$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/versions?totalCount=<show_total>&allKeyStates=<work_for_keys_in_any_state>" \
    -H "accept: application/vnd.ibm.kms.key.version+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "x-kms-key-ring: <key_ring_ID>" \
    -H "bluemix-instance: <instance_ID>"
```
Ersetzen Sie die Variablen in der Beispielanforderung entsprechend der folgenden Tabelle.

Tabelle 1. Variablen, die für die Auflistung von Schlüsselversionen mit der Key Protect API benötigt werden
Variable	Beschreibung
Bereich	Erforderlich. Die Regionsabkürzung (z. B. `us-south` oder `eu-gb`) für den geografischen Bereich, in dem sich Ihre Key Protect-Instanz befindet. Weitere Informationen finden Sie unter Regionale Serviceendpunkte.
key_ID_or_alias	Erforderlich. Die eindeutige ID oder der Aliasname für den Schlüssel, den Sie untersuchen möchten.
IAM_token	Erforderlich. Ihr IBM Cloud-Zugriffstoken. Fügen Sie den vollständigen Inhalt des IAM-Tokens, einschließlich des Träger-Wertes, in die Curl-Anforderung ein. Weitere Informationen finden Sie unter Zugriffstoken abrufen.
instance_id	Erforderlich. Die eindeutige ID, die Ihrer Key Protect-Serviceinstanz zugewiesen ist. Weitere Informationen finden Sie unter Instanz-ID abrufen.
key_ring_ID	Optional. Die eindeutige Kennung des Schlüsselrings, zu dem der Schlüssel gehört. Wenn diese Option nicht angegeben wird, sucht Key Protect den Schlüssel in jedem Schlüsselring, der der angegebenen Instanz zugeordnet ist. Die Angabe der Schlüsselring-ID wird für eine optimierte Anfrage empfohlen. Hinweis: Die Schlüsselring-ID der Schlüssel, die ohne den Header `x-kms-key-ring` erstellt werden, ist `default`. Weitere Informationen finden Sie unter Gruppierungsschlüssel.
show_total	Optional. Bei der Einstellung `true` wird `totalCount` in den Antwortmetadaten zur Verwendung mit der Paginierung für alle Schlüssel im aktiven Zustand zurückgegeben, sofern `allKeyStates` nicht auch auf `true` eingestellt ist. Der zurückgegebene Wert „ `totalCount` “ gibt die Gesamtzahl der Schlüsselversionen an, die der Anfrage entsprechen, wobei Limit und Offset unberücksichtigt bleiben. Die Standardeinstellung lautet „ `false` “.
allKeyStates	Optional. Ist der Wert nicht auf `true` gesetzt, wird für alle nicht aktiven Schlüssel ein HTTP 409 zurückgegeben.

Eine erfolgreiche GET api/v2/keys/<keyID_or_alias>/versions-Antwort gibt die Liste der Versionen zurück, die dem Rootschlüssel zugeordnet sind. Das folgende JSON-Objekt zeigt ein Beispiel für einen zurückgegebenen Wert.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key.version+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "02fd6835-6001-4482-a892-13bd2085f75d",
            "creationDate": "2020-03-05T16:39:25Z"
        },
        {
            "id": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
            "creationDate": "2020-03-02T16:28:38Z"
        }
    ]
}

Das Objekt resources listet die einzelnen Schlüsselversionen mit zugehöriger ID und Erstellungsdatum in umgekehrter chronologischer Reihenfolge auf.