Visualizzazione delle risorse protette nella tua istanza

1. Accedi alla console IBM Cloud.

2. Vai su Menu > Elenco risorse per visualizzare l'elenco delle tue risorse.

3. Dal tuo elenco risorse IBM Cloud, seleziona la tua istanza di cui è stato eseguito il provisioning di Key Protect.

4. Selezionare il collegamento Associated resources sul menu a sinistra.

5. Nella pagina Risorse associate, utilizzare la tabella Risorse associate per sfogliare le registrazioni nel servizio.

6. Fare clic sull'icona ^ nella colonna Details per visualizzare un elenco di dettagli per una registrazione specifica.

7. Fare clic su Filter per filtrare le risorse in base all'ID chiave, al CRN (Cloud Resource Name) e alla politica di conservazione.

Visualizzazione delle risorse protette associate alla tua chiave

1. Accedi alla console IBM Cloud.

2. Vai su Menu > Elenco risorse per visualizzare l'elenco delle tue risorse.

3. Dal tuo elenco risorse IBM Cloud, seleziona la tua istanza di cui è stato eseguito il provisioning di Key Protect.

4. Nella pagina dei dettagli dell'applicazione, utilizza la tabella Keys per sfogliare le chiavi nel tuo servizio.

5. Fai clic sull'icona ⋯ per aprire l'elenco delle opzioni relative al tasto.

6. Dal menu delle opzioni, fare clic su Risorse chiave associate per visualizzare le registrazioni associate della chiave.

Elencazione delle registrazioni per una specifica chiave root

Puoi richiamare i dettagli di registrazione associati a una specifica chiave root effettuando una chiamata GET al seguente endpoint.

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

1. Richiama le tue credenziali di autenticazione per lavorare con l'API.

2. Per visualizzare le registrazioni associate a una chiave radice, eseguire il seguente comando curl.

   $ 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>"
   

   Sostituisci le variabili nella richiesta di esempio in base alla seguente tabella.

Una richiesta GET api/v2/keys/<keyID_or_alias>/registrations andata a buon fine restituisce una raccolta di registrazioni associate all'ID chiave specificato.

{
    "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"
            }
        }
    ]
}

Il valore resourceCrn rappresenta l'identificativo univoco della risorsa cloud crittografata da keyId. Nel corpo della risposta, vengono restituiti anche i metadati associati alla registrazione, come la sua data di creazione.

Per impostazione predefinita, GET api/v2/keys/registrations restituisce le prime 200 registrazioni ma puoi regolare questo limite utilizzando il parametro limit al momento della query.

$ 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>"

Elencazione delle registrazione per le eventuali chiavi root

Puoi anche richiamare un elenco delle registrazioni associate a qualsiasi risorsa cloud effettuando una chiamata GET al seguente endpoint.

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

1. Richiama le tue credenziali di autenticazione per lavorare con l'API.

2. Per visualizzare le registrazioni corrispondenti a una query CRN specificata dall'utente, eseguire il seguente comando curl.

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

   Sostituisci le variabili nella richiesta di esempio in base alla seguente tabella.

$ 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>"

Esempi di query CRN

Utilizzare le query CRN codificate da URL per filtrare le registrazioni in base a Key Protect istanza, tipo di risorsa o nome della risorsa. Per ulteriori informazioni sui segmenti e sul formato CRN, consultare Nomi delle risorse cloud.

Servizi cloud che utilizzano Key Protect Le chiavi associate alle risorse per conto dell'utente possono solo visualizzare o effettuare ricerche sui CRN che corrispondono ai primi 8 segmenti del proprio CRN di servizio.

• Per verificare se esiste una registrazione fino a un determinato segmento del CRN, utilizzare i due punti seguiti da un asterisco (*).

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

  Questa query restituisce le registrazioni " Databases for Redis " associate a tutti i tipi e nomi di risorse per l'ID di distribuzione 29caf0e7-120f-4da8-9551-3abf57ebcfc7.

• Per verificare l'esistenza di una registrazione fino a un determinato segmento CRN preceduto dal prefisso <string>, utilizzare i due punti seguiti da <string>* nell'ultimo segmento della query CRN.

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

  Questa query restituisce tutte le registrazioni dei bucket Cloud Object Storage all'interno dell'account e1bb63d6a20dc57c87501ac4c4c99dcb che hanno come prefisso prod.

Quando elencando le registrazioni associate a qualsiasi chiave root, la tua query CRN non deve contenere un asterisco (*) nei primi otto segmenti.

Le seguenti tabelle forniscono un elenco di esempi di query CRN prima e dopo la codifica URL. Per visualizzare i valori con codifica URL, fai clic sulla scheda URL encoded.