Visualizzazione delle risorse protette associate alla tua chiave root

1. Accedi all'IU.

2. Vai a Menù >Elenco delle risorse per visualizzare un elenco delle tue risorse.

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

4. Sul Chiavi KMS pagina, utilizzare il file Chiavi tabella per sfogliare le chiavi del tuo servizio.

5. Per visualizzare le risorse protette di una chiave root specifica, fai clic su Azioni per aprire un elenco di opzioni per la chiave e seleziona Visualizza risorse associate per sfogliare tutte le risorse protette dalla chiave.

   Tabella 2. Descrive la tabella di visualizzazione delle risorse associate

   Colonna	Descrizione
   Resource name	Il nome della risorsa cloud, ad esempio aCloud Object Storage bucket, a cui è associata la chiave.
   Service name	Il nome del servizio IBM Cloud in cui risiede la risorsa.
   Retention policy	Se la risorsa cloud ha una politica di conservazione. Se il valore è True, viene abilitata una politica di conservazione per la risorsa cloud e la chiave associata alla risorsa cloud non può essere eliminata. Se il valore è False, la politica di conservazione non è abilitata.

6. Per visualizzare i dettagli di ogni risorsa, espandere i dettagli della risorsa facendo clic sull'icona accento circonflesso (^) nella colonna Resource name.

   La tabella seguente descrive i dettagli della registrazione.

   Tabella 3. Descrive le proprietà associate a una risorsa

   Campo	Descrizione
   Created	La data e l'ora in cui la risorsa è stata prima associata alla chiave.
   Last updated	La data e l'ora in cui la registrazione è stata aggiornata.
   Description	La descrizione della registrazione.
   Key version ID	La versione della chiave root che sta proteggendo la risorsa cloud.
   Key version date	La data e l'ora in cui è stata aggiornata la versione della chiave root.
   Cloud resource name	Rappresenta la risorsa cloud associata alla chiave, incluso il nome risorsa cloud (CRN), version, cname, ctype e così via.

È possibile utilizzare il campo di ricerca per ricercare le risorse associate alla chiave root con il nome risorsa o l'ID versione chiave.

Visualizzazione delle risorse nell'istanza

1. Accedi all'IU.

2. Vai a Menù >Elenco delle risorse per visualizzare un elenco delle tue risorse.

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

4. Nella pagina Risorse associate KMS, utilizzare la tabella Risorse associate al servizio di gestione chiavi per sfogliare le registrazioni nel servizio.

   Tabella 4. Descrive la tabella delle risorse associate

   Colonna	Descrizione
   Resource name	Il nome della risorsa cloud, ad esempio aCloud Object Storage bucket, a cui è associata la chiave.
   Key name	Il nome leggibile che identifica la chiave root associata alla risorsa cloud specificata.
   Key ID	L'ID che identifica la chiave root associata alla risorsa cloud specificata.
   Service name	Il nome del servizio IBM Cloud in cui risiede la risorsa.
   Retention policy	Indica se la risorsa cloud può essere cancellata. Se il valore è Enabled, la risorsa cloud non può essere cancellata e la chiave associata alla risorsa cloud non può essere eliminata. Se il valore è Disabled, la risorsa cloud può essere cancellata. È possibile eliminare la chiave associata alla risorsa cloud, se necessario.

5. Fare clic sull'icona accento circonflesso (^) nella colonna Resource name per visualizzare un elenco di dettagli per una registrazione specifica.

   La tabella seguente descrive i dettagli della registrazione.

   Tabella 5. Descrive le proprietà associate a una risorsa

   Campo	Descrizione
   Created	La data e l'ora in cui la risorsa è stata prima associata alla chiave.
   Last updated	La data e l'ora in cui la registrazione è stata aggiornata.
   Description	La descrizione della registrazione.
   Key version ID	La versione della chiave root che sta proteggendo la risorsa cloud.
   Key version date	La data e l'ora in cui è stata aggiornata la versione della chiave root.
   Cloud resource name	Rappresenta la risorsa cloud associata alla chiave, incluso il nome risorsa cloud (CRN), version, cname, ctype e così via.

Oltre alla ricerca di una risorsa, puoi anche ricercare le risorse per nome risorsa, ID chiave e politica di conservazione. Per fare ciò, fare clic su Filter, selezionare le opzioni di filtro dall'elenco e fare clic su Applica.

Elenco delle registrazioni per una specifica chiave root con l'API

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

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

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

2. Visualizza le registrazioni associate a una chiave root eseguendo questo comando cURL.

   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>'
   

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

   Tabella 7. Descrive le variabili necessarie per elencare tutte le registrazioni associate a una chiave root

   Variabile	Descrizione
   region	Obbligatorio. L'abbreviazione della regione, come ad esempio us-south O eu-de, che rappresenta l'area geografica in cui si trova il tuoHyper Protect Crypto Services risiede l'istanza. Per ulteriori informazioni, vedere Endpoint del servizio regionale.
   port	Obbligatorio. Il numero di porta dell'endpoint API.
   IAM_token	Obbligatorio. Il tuo token di accesso IBM Cloud. Includere l'intero contenuto del file IAM token, compreso il valore al portatore, nel filecURL richiesta. Per ulteriori informazioni, vedere Recupero di un token di accesso.
   instance_ID	Obbligatorio. L'identificativo univoco che viene assegnato alla tua istanza del servizio Hyper Protect Crypto Services. Per ulteriori informazioni, vedere Recupero di un ID istanza.

   Un successo GET api/v2/keys/<key_ID>/registrations la richiesta restituisce una raccolta di registrazioni mappate all'ID chiave specificato.

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

   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, ad esempio la 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.

Elenco delle registrazioni per tutte le chiavi root con l'API

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

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

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

2. Visualizza le registrazioni che corrispondono a una query CRN che specifichi eseguendo questo comando cURL.

   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>'
   

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

   Tabella 8. Descrive le variabili necessarie per elencare le registrazioni per query CRN.

   Variabile	Descrizione
   region	Obbligatorio. L'abbreviazione della regione, come ad esempio us-south O eu-de, che rappresenta l'area geografica in cui si trova il tuoHyper Protect Crypto Services risiede l'istanza. Per ulteriori informazioni, vedere Endpoint del servizio regionale.
   port	Obbligatorio. Il numero di porta dell'endpoint API.
   url_encoded_CRN_query	Filtri per risorse associate a un CRN(Cloud Resource Name) specificato utilizzando i caratteri jolly codificati URL (*). Il parametro deve contenere tutti i segmenti CRN e deve essere codificato URL. Per visualizzare gli esempi, vedi Esempi di query CRN.
   IAM_token	Obbligatorio. Il tuo token di accesso IBM Cloud. Includere l'intero contenuto del file IAM token, compreso il valore al portatore, nel filecURL richiesta. Per ulteriori informazioni, vedere Recupero di un token di accesso.
   instance_ID	Obbligatorio. L'identificativo univoco che viene assegnato alla tua istanza del servizio Hyper Protect Crypto Services. Per ulteriori informazioni, vedere Recupero di un ID istanza.