Geschützte Ressourcen in Ihrer Instanz anzeigen

1. Melden Sie sich bei der „ IBM Cloud “-Konsole an.

2. Rufen Sie Menü > Ressourcenliste auf, um eine Liste Ihrer Ressourcen anzuzeigen.

3. Wählen Sie in der IBM Cloud-Ressourcenliste die bereitgestellte Instanz von Key Protect aus.

4. Wählen Sie den Link Associated resources auf dem linken Menü aus.

5. Verwenden Sie auf der Seite mit den zugeordneten Ressourcen die Tabelle Zugeordnete Ressourcen, um die Registrierungen in Ihrem Service zu durchsuchen.

6. Klicken Sie auf das Symbol ^ unter der Spalte Details, um eine Liste mit den Details für eine bestimmte Registrierung anzuzeigen.

7. Klicken Sie auf die Schaltfläche Filter, um die Ressourcen nach Schlüssel-ID, Cloudressourcenname (CRN) und Aufbewahrungsrichtlinie zu filtern.

Geschützte Ressourcen anzeigen, die einem Schlüssel zugeordnet sind

1. Melden Sie sich bei der „ IBM Cloud “-Konsole an.

2. Rufen Sie Menü > Ressourcenliste auf, um eine Liste Ihrer Ressourcen anzuzeigen.

3. Wählen Sie in der IBM Cloud-Ressourcenliste die bereitgestellte Instanz von Key Protect aus.

4. Verwenden Sie auf der Seite mit den Anwendungsdetails die Tabelle Schlüssel, um die Schlüssel im Service zu durchsuchen.

5. Klicken Sie auf das Symbol ⋯, um eine Liste der Optionen für den Schlüssel zu öffnen.

6. Klicken Sie im Auswahlmenü auf Zugeordnete Ressourcen für Schlüssel, um die Registrierungen anzuzeigen, die dem Schlüssel zugeordnet sind.

Registrierungen für einen bestimmten Rootschlüssel 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://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations

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

2. Zeigen Sie die Registrierungen an, die einem Rootschlüssel zugeordnet sind, indem Sie den folgenden Befehl curl ausführen.

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>"
   

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

Eine erfolgreiche GET api/v2/keys/<keyID_or_alias>/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": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
                "creationDate": "2010-01-12T05:23:19+0000"
            }
        },
        {
            "keyId": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
                "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 zum Beispiel das Erstellungsdatum, werden auch 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.

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations?offset=<offset>&limit=<limit>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

Registrierungen für beliebigen Rootschlüssel 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://<region>.kms.cloud.ibm.com/api/v2/keys/registrations

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

2. Zeigen Sie die Registrierungen an, die mit einer CRN-Abfrage übereinstimmen, die Sie angeben, indem Sie den folgenden Befehl curl ausführen.

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>"
   

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

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations?offset=<offset>&limit=<limit>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

CRN-Abfragebeispiele

Verwenden Sie URL-codierte CRN-Abfragen, um Registrierungen nach Key Protect-Instanz, -Ressourcentyp oder -Ressourcenname zu filtern. Weitere Informationen zu CRN-Segmenten und -Formaten finden Sie unter „ Cloud Resource Names “.

Cloud-Services, die Key Protect verwenden, um Schlüsseln zu Ressourcen in Ihrem Namen zuordnen, können nur CRNs anzeigen oder abfragen, die mit den ersten 8 Segmenten ihres Service-CRN übereinstimmen.

• Verwenden Sie zum Suchen nach einer Registrierung, deren Name bis zu einem bestimmten Segment mit dem CRN übereinstimmt, einen Doppelpunkt gefolgt von einem Stern (*).

  crn:v1:bluemix:public:databases-for-redis:us-south:a/
  274074dce64e9c423ffc238516c755e1:29caf0e7-120f-4da8-9551-3abf57ebcfc7:*:*
  

  Diese Abfrage gibt Databases for Redis-Registrierungen zurück, die allen Ressourcentypen und Namen für die Implementierungs-ID 29caf0e7-120f-4da8-9551-3abf57ebcfc7 zugeordnet sind.

• Um nach einer Registrierung bis zu einem bestimmten CRN-Segment mit dem Präfix <string> zu suchen, verwenden Sie einen Doppelpunkt gefolgt von <string>* im letzten Segment der CRN-Abfrage.

  crn:v1:bluemix:public:cloud-object-storage:global:a/e1bb63d6a20dc57c87501ac4c4c99dcb:*:bucket:prod*
  

  Diese Abfrage gibt alle Cloud Object Storage-Bucketregistrierungen innerhalb des Kontos e1bb63d6a20dc57c87501ac4c4c99dcb mit Präfix prod zurück.

Wenn Sie Registrierungen auflisten, die einem beliebigen Root-Schlüssel zugeordnet sind, darf Ihre CRN-Abfrage in den ersten acht Segmenten kein Sternchen (*) enthalten.

Die folgende Tabelle enthält eine Liste mit Beispielen für CRN-Abfragen vor und nach der URL-Codierung. Klicken Sie zum Anzeigen der URL-codierten Werte auf die Registerkarte URL-codiert.