Schritt 1. Löschen eines Schlüssels autorisieren

Nach der Aktivierung der doppelten Berechtigung für eine Instanz oder für einen Schlüssel können Sie die erste Berechtigung zum Löschen eines Schlüssels über die Benutzerschnittstelle bereitstellen.

1. Melden Sie sich bei der Benutzerschnittstelle an.
2. Rufen Sie Menü > Ressourcenliste auf, um eine Liste Ihrer Ressourcen anzuzeigen.
3. Wählen Sie in Ihrer IBM Cloud-Ressourcenliste die bereitgestellte Instanz von Hyper Protect Crypto Services aus.
4. Verwenden Sie auf der Seite KMS-Schlüssel die Tabelle Schlüssel, um die Schlüssel in Ihrem Service zu durchsuchen.
5. Klicken Sie auf das Symbol Aktionen , um eine Liste mit Optionen für den Schlüssel zu öffnen, den Sie löschen möchten.
6. Klicken Sie im Auswahlmenü auf Schlüssellöschung planen und prüfen Sie die zugeordneten Ressourcen des Schlüssels.
7. Geben Sie den Namen des zu löschenden Schlüssels ein und klicken Sie auf Schlüssellöschung planen.
8. Kontaktieren Sie den zweiten Prüfer, um die Löschung des Schlüssels abschließen zu lassen.

Schritt 2. Schlüssel löschen

Zum Löschen des Schlüssels muss der zweite Genehmiger über die Manager-Zugriffsrichtlinie für die Instanz oder den Schlüssel verfügen, um das Löschen des Schlüssels zu autorisieren.

1. In der Tabelle Schlüssel auf der Seite KMS-Schlüssel können Sie Schlüssel, für die eine Löschberechtigung besteht, anhand der folgenden Indikatoren suchen:

   • Die Spalte Set for deletion enthält den Wert True. Die Ablaufzeit für die Autorisierung wird in der Spalte Deletion expiration angezeigt.
   • In der Spalte State wird das Symbol Uhr angezeigt. Setzen Sie den Mauszeiger auf das Symbol, um das Ablaufdatum für die Löschung einzublenden.

2. Befolgen Sie zum Löschen des Schlüssels die Anweisungen unter Schlüssel über die Benutzerschnittstelle löschen.

Von Hyper Protect Crypto Services wird eine Wartezeit von sieben Tagen festgelegt, die beginnt, nachdem Sie die erste Autorisierung zum Löschen des Schlüssels ausgeführt haben. Während dieser 7-Tage-Zeitraum, bleibt der Schlüssel in der Der Status Aktiv und alle Schlüsseloperationen sind für den Schlüssel zulässig. Wenn von dem zweiten Benutzer keine Aktion ausgeführt wird und die Zeit von sieben Tagen abläuft, müssen Sie den Prozess zur doppelten Autorisierung erneut starten, um den Schlüssel zu löschen.

Schritt 1. Löschen eines Schlüssels autorisieren

Nachdem Sie die doppelte Autorisierung für eine Instanz oder für einen Schlüssel aktiviert haben, können Sie die erste Autorisierung zum Löschen eines Schlüssels durchführen, indem Sie einen POST-Aufruf an den folgenden Endpunkt absetzen.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/actions/setKeyForDeletion

1. Rufen Sie Ihre Authentifizierungsnachweise für die Arbeit mit Schlüsseln im Service ab.

   Zum Festlegen eines Schlüssels zum Löschen müssen Sie über eine Manager- oder Writer-Zugriffsrichtlinie für die Instanz oder den Schlüssel verfügen. Informationen zur Zuordnung von IAM-Rollen zu Hyper Protect Crypto Services-Aktionen finden Sie unter Servicezugriffsrollen.

2. Kopieren Sie die ID des Schlüssels, den Sie zum Löschen festlegen oder autorisieren wollen.

3. Führen Sie die erste Autorisierung zum Löschen des Schlüssels durch.

   curl -X POST \
     'https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/actions/setKeyForDeletion' \
     -H 'accept: application/vnd.ibm.kms.key_action+json' \
     -H 'authorization: Bearer <IAM_token>' \
     -H 'bluemix-instance: <instance_ID>' \
     -H 'content-type: application/vnd.ibm.kms.key_action+json'
   

   Ersetzen Sie die Variablen in der Beispielanforderung entsprechend der folgenden Tabelle.

   Tabelle 1. Beschreibt die Variablen, die zum Festlegen eines Schlüssels zum Löschen erforderlich sind.

   Variabel	Beschreibung
   region	Erforderlich. Die Abkürzung der Region, z. B. us-south oder eu-de, die den geografischen Bereich darstellt, in dem sich Ihre Hyper Protect Crypto Services-Instanz befindet. Weitere Informationen finden Sie unter Regionale Serviceendpunkte.
   key_ID	Erforderlich. Die eindeutige ID für den Rootschlüssel, den Sie löschen wollen.
   IAM_token	Erforderlich. Ihr IBM Cloud-Zugriffstoken. Nehmen Sie den vollständigen Inhalt des IAM-Tokens einschließlich des Werts für Bearer in die cURL-Anforderung auf. Weitere Informationen finden Sie unter Zugriffstoken abrufen.
   instance_ID	Erforderlich. Die eindeutige ID, die Ihrer Hyper Protect Crypto Services-Instanz zugewiesen ist. Weitere Informationen finden Sie unter Instanz-ID abrufen.

   Eine erfolgreiche Anforderung gibt eine HTTP-Antwort 204 No Content zurück, die angibt, dass Ihr Schlüssel für das Löschen autorisiert wurde. Ein anderer Benutzer mit einem Zugriffsrichtlinie Manager kann jetzt Löschen Sie den Schlüssel über die Benutzerschnittstelle oder die API des Schlüsselmanagementservice.

   Wenn Sie das Löschen eines Schlüssels verhindern müssen, der bereits zum Löschen berechtigt ist, können Sie die vorhandene Berechtigung entfernen, indem Sie POST /api/v2/keys/<key_ID>/actions/unsetKeyForDeletion.

Schritt 2. Schlüssel löschen

Nachdem Sie einen Schlüssel zum Löschen festgelegt haben, kann ein zweiter Benutzer mit einer Manager-Zugriffsrichtlinie den Schlüssel sicher löschen.

Von Hyper Protect Crypto Services wird eine Wartezeit von sieben Tagen festgelegt, die beginnt, nachdem Sie die erste Autorisierung zum Löschen des Schlüssels ausgeführt haben. Während dieser 7-Tage-Zeitraum, bleibt der Schlüssel in der Der Status Aktiv und alle Schlüsseloperationen sind für den Schlüssel zulässig. Wenn von dem zweiten Benutzer keine Aktion ausgeführt wird und die Zeit von sieben Tagen abläuft, müssen Sie den Prozess zur doppelten Autorisierung erneut starten, um den Schlüssel zu löschen.

Um einen Schlüssel und den Inhalt zu löschen, führen Sie einen DELETE-Aufruf an den Serviceendpunkt aus, indem Sie die Anweisungen im Abschnitt zum Löschen von Schlüsseln mit der API befolgen.

Vorhandene Autorisierung entfernen

Wenn Sie eine Autorisierung für einen Schlüssel vor Ablauf der Wartezeit von sieben Tagen abbrechen müssen, können Sie die vorhandene Autorisierung entfernen, indem Sie einen POST-Aufruf an den folgenden Endpunkt absetzen.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/actions/unsetKeyForDeletion

1. Rufen Sie Ihre Authentifizierungsnachweise für die Arbeit mit Schlüsseln im Service ab.

   Um eine Berechtigung zum Löschen eines Schlüssels zu entfernen, muss Ihnen eine Manager- oder Writer-Zugriffsrichtlinie für die Instanz oder den Schlüssel zugeordnet sein. Informationen dazu, wie IAM-Rollen Hyper Protect Crypto Services-Aktionen zugeordnet werden, finden Sie unter Servicezugriffsrollen.

2. Kopieren Sie die ID des Schlüssels, dessen Löschautorisierung Sie aufheben wollen.

3. Entfernen Sie eine vorhandene Autorisierung zum Löschen des Schlüssels.

   curl -X POST \
     'https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/actions/setKeyForDeletion' \
     -H 'accept: application/vnd.ibm.kms.key_action+json' \
     -H 'authorization: Bearer <IAM_token>' \
     -H 'bluemix-instance: <instance_ID>' \
     -H 'content-type: application/vnd.ibm.kms.key_action+json'
   

   Ersetzen Sie die Variablen in der Beispielanforderung entsprechend der folgenden Tabelle.

   Tabelle 2. Beschreibt die Variablen, die zum Aufheben der Festlegung eines Schlüssels zum Löschen erforderlich sind

   Variabel	Beschreibung
   region	Erforderlich. Die Abkürzung der Region, z. B. us-south oder eu-de, die den geografischen Bereich darstellt, in dem sich Ihre Hyper Protect Crypto Services-Instanz befindet. Weitere Informationen finden Sie unter Regionale Serviceendpunkte.
   key_ID	Erforderlich. Die eindeutige ID für den Rootschlüssel, den Sie löschen wollen.
   IAM_token	Erforderlich. Ihr IBM Cloud-Zugriffstoken. Nehmen Sie den vollständigen Inhalt des IAM-Tokens einschließlich des Werts für Bearer in die cURL-Anforderung auf. Weitere Informationen finden Sie unter Zugriffstoken abrufen.
   instance_ID	Erforderlich. Die eindeutige ID, die Ihrer Hyper Protect Crypto Services-Instanz zugewiesen ist. Weitere Informationen finden Sie unter Instanz-ID abrufen.

   Eine erfolgreiche Anforderung gibt eine HTTP-Antwort 204 No Content zurück, die angibt, dass Ihr Schlüssel nicht mehr zum Löschen autorisiert ist. Falls Sie den Prozess zur doppelten Autorisierung erneut starten müssen, können Sie eine weitere Autorisierung ausgeben, um den Schlüssel zum Löschen festzulegen.