Geschützte Ressourcen anzeigen, die dem Rootschlüssel zugeordnet sind

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. Um die geschützten Ressourcen eines bestimmten Rootschlüssels anzuzeigen, klicken Sie auf das Symbol Aktionen , um eine Liste mit Optionen für den Schlüssel zu öffnen, und wählen Sie Zugeordnete Ressourcen anzeigen aus, um alle durch den Schlüssel geschützten Ressourcen zu durchsuchen.

   Tabelle 2. Beschreibt die Tabelle zum Anzeigen zugeordneter Ressourcen

   Spalte	Beschreibung
   Resource name	Der Name der Cloudressource, wie zum Beispiel ein Cloud Object Storage-Bucket, die dem Schlüssel zugeordnet ist.
   Service name	Der Name der IBM Cloud-Serviceinstanz, in der sich die Ressource befindet.
   Retention policy	Gibt an, ob die Cloudressource eine Aufbewahrungsrichtlinie hat. Wenn der Wert True ist, ist eine Aufbewahrungsrichtlinie für die Cloudressource aktiviert und der Schlüssel, der der Cloudressource zugeordnet ist, kann nicht gelöscht werden. Ist der Wert False, ist die Aufbewahrungsrichtlinie nicht aktiviert.

6. Zum Anzeigen der Details zu jeder Ressource blenden Sie die Ressourcendetails ein, indem Sie auf das Winkelsymbol (^) unter der Spalte Resource name klicken.

   In der folgenden Tabelle werden die Registrierungsdetails beschrieben.

   Tabelle 3. Beschreibt die Eigenschaften, die einer Ressource zugeordnet sind.

   Feld	Beschreibung
   Created	Das Datum und die Uhrzeit des Zeitpunkts, zu dem die Ressource dem Schlüssel zuerst zugeordnet wurde.
   Last updated	Das Datum und die Uhrzeit des Zeitpunkts, zu dem die Registrierung zuletzt aktualisiert wurde.
   Description	Die Beschreibung der Registrierung.
   Key version ID	Die Version des Rootschlüssels, durch den die Cloudressource geschützt wird.
   Key version date	Das Datum und die Uhrzeit des Zeitpunkts, zu dem die Rootschlüsselversion aktualisiert wurde.
   Cloud resource name	Stellt die Cloudressource dar, die dem Schlüssel zugeordnet ist, einschließlich des Cloudressourcennamens (CRN), version, cname, ctype usw.

Sie können das Suchfeld verwenden, um nach Ressourcen zu suchen, die dem Rootschlüssel zugeordnet sind, entweder mit dem Ressourcennamen oder der Schlüsselversions-ID.

Ressourcen in der Instanz anzeigen

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 Zugeordnete KMS-Ressourcen die Tabelle Dem Schlüsselmanagementservice zugeordnete Ressourcen, um die Registrierungen in Ihrem Service zu durchsuchen.

   Tabelle 4. Beschreibt die Tabelle der zugeordneten Ressourcen

   Spalte	Beschreibung
   Resource name	Der Name der Cloudressource, wie zum Beispiel ein Cloud Object Storage-Bucket, die dem Schlüssel zugeordnet ist.
   Key name	Der lesbare Name, der den Rootschlüssel angibt, der der angegebenen Cloudressource zugeordnet ist.
   Key ID	Die ID, die den Rootschlüssel identifiziert, der der angegebenen Cloudressource zugeordnet ist.
   Service name	Der Name der IBM Cloud-Serviceinstanz, in der sich die Ressource befindet.
   Retention policy	Gibt an, ob die Cloudressource gelöscht werden kann. Wenn der Wert Enabled ist, kann die Cloudressource nicht gelöscht werden, und der Schlüssel, der der Cloudressource zugeordnet ist, kann nicht gelöscht werden. Wenn der Wert Disabled ist, kann die Cloudressource gelöscht werden. Sie können den Schlüssel löschen, der der Cloudressource zugeordnet ist, falls dies erforderlich ist.

5. Klicken Sie auf das Winkelsymbol (^) unter der Spalte Resource name, um eine Liste der Details für eine bestimmte Registrierung anzuzeigen.

   In der folgenden Tabelle werden die Registrierungsdetails beschrieben.

   Tabelle 5. Beschreibt die Eigenschaften, die einer Ressource zugeordnet sind.

   Feld	Beschreibung
   Created	Das Datum und die Uhrzeit des Zeitpunkts, zu dem die Ressource dem Schlüssel zuerst zugeordnet wurde.
   Last updated	Das Datum und die Uhrzeit des Zeitpunkts, zu dem die Registrierung zuletzt aktualisiert wurde.
   Description	Die Beschreibung der Registrierung.
   Key version ID	Die Version des Rootschlüssels, durch den die Cloudressource geschützt wird.
   Key version date	Das Datum und die Uhrzeit des Zeitpunkts, zu dem die Rootschlüsselversion aktualisiert wurde.
   Cloud resource name	Stellt die Cloudressource dar, die dem Schlüssel zugeordnet ist, einschließlich des Cloudressourcennamens (CRN), version, cname, ctype usw.

Neben der Suche nach einer Ressource können Sie Ressourcen auch nach Ressourcennamen, Schlüssel-ID und Aufbewahrungsrichtlinie filtern. Klicken Sie dazu auf die Schaltfläche Filter, wählen sie die Filteroptionen in der Liste aus und klicken Sie auf Anwenden.

Registrierungen für einen bestimmten Rootschlüssel mit der API auflisten

Sie können die Registrierungsdetails, die einem bestimmten Rootschlüssel zugeordnet sind, abrufen, indem Sie einen GET-Aufruf an den folgenden Endpunkt absetzen.

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

1. Rufen Sie Ihre Authentifizierungsnachweise für die Arbeit mit der API ab.

2. Führen Sie den folgenden cURL-Befehl aus, um die Registrierungen anzuzeigen, die einem Rootschlüssel zugeordnet sind.

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/registrations \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

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

   Tabelle 7. Beschreibt die Variablen, die zum Auflisten aller Registrierungen erforderlich sind, die einem Rootschlüssel zugeordnet 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.
   port	Erforderlich. Die Portnummer des API-Endpunkts.
   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-Serviceinstanz zugewiesen ist. Weitere Informationen finden Sie unter Instanz-ID abrufen.

   Eine erfolgreiche GET api/v2/keys/<key_ID>/registrations-Anforderung gibt eine Sammlung von Registrierungen zurück, die der angegebenen Schlüssel-ID zugeordnet sind.

   {
     "metadata": {
         "collectionType": "application/vnd.ibm.kms.registration+json",
         "collectionTotal": 2
     },
     "resources": [
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       },
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       }
     ]
   }
   

   Der Wert für resourceCrn stellt die eindeutige ID der Cloudressource dar, die durch keyId verschlüsselt wird. Die Metadaten, die der Registrierung zugeordnet sind, wie z. B. das Erstellungsdatum, werden ebenfalls im Antworthauptteil zurückgegeben.

   Standardmäßig gibt die Anforderung GET api/v2/keys/registrations die ersten 200 Registrierungen zurück. Sie können diese Begrenzung jedoch mit dem Parameter limit bei der Abfrage anpassen.

Registrierungen für beliebige Rootschlüssel mit der API auflisten

Sie können auch eine Liste von Registrierungen abrufen, die einer beliebigen Cloudressource zugeordnet sind, indem Sie einen GET-Aufruf an den folgenden Endpunkt absetzen.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query>

1. Rufen Sie Ihre Authentifizierungsnachweise für die Arbeit mit der API ab.

2. Zeigen Sie die Registrierungen an, die einer angegebenen CRN-Abfrage entsprechen, indem Sie den folgenden cURL-Befehl ausführen.

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query> \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

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

   Tabelle 8. Beschreibt die Variablen, die zum Auflisten von Registrierungen nach CRN-Abfrage 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.
   port	Erforderlich. Die Portnummer des API-Endpunkts.
   url_encoded_CRN_query	Filtert mithilfe von URL-codierten Platzhalterzeichen (*) nach Ressourcen, die einem angegebenen Cloudressourcennamen zugeordnet sind. Der Parameter muss alle CRN-Segmente enthalten und URL-codiert sein. Entsprechende Beispiele finden Sie unter Beispiele für CRN-Abfragen.
   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-Serviceinstanz zugewiesen ist. Weitere Informationen finden Sie unter Instanz-ID abrufen.