copyright: years: 2026 lastupdated: "2026-08-21"

subcollection: cloud-databases-gen2

keywords: "Bring Your Own Key" (BYOK), cryptoshredding, rotazione delle chiavi, frequenza di rotazione delle chiavi, "Bring Your Own Key"


Integrazione di Key Protect

Gen 2

I dati che si salvano su Cloud Databases vengono crittografati per impostazione predefinita utilizzando chiavi generate in modo casuale. Per gestire le chiavi di crittografia, è possibile utilizzare la modalità "Bring Your Own Key" (BYOK) tramite IBM Key Protect e utilizzare una delle proprie chiavi per crittografare i database e i backup.

Per iniziare, configura Key Protect sul tuo account IBM Cloud.

Creazione o aggiunta di una chiave in Key Protect

Accedi alla tua istanza di Key Protect e genera o inserisci una chiave.

Concessione dell'autorizzazione al servizio nell'interfaccia utente

Autorizza Key Protect per l'utilizzo con le distribuzioni Cloud Databases:

  1. Apri il tuo dashboard IBM Cloud.
  2. Dalla barra dei menu, fare clic su Gestisci-> Accesso (IAM).
  3. Nella navigazione laterale, fai clic su Autorizzazioni.
  4. Fai clic su Crea.
  5. Nel menu “Servizio di origine ”, selezionare il servizio della distribuzione. Ad esempio, Databases for PostgreSQL oppure Databases for MongoDB.
  6. Nel menu delle risorse del servizio Source, selezionare " Tutte le risorse ".
  7. Nel menu Servizio di destinazione, seleziona Key Protect.
  8. Selezionare o mantenere il valore predefinito " Account " come gruppo di risorse per il servizio di destinazione
  9. Nel menu "ID istanza del servizio" di Target, selezionare le istanze del servizio da autorizzare.
  10. Abilita il ruolo Lettore.
  11. Per utilizzare la funzione "Bring your own key" (BYOK), selezionare la casella " Abilita la delega delle autorizzazioni " nella sezione " Autorizza servizi dipendenti ".
  12. Fai clic su Autorizza.

Se l'autorizzazione al servizio non è presente prima di configurare l'implementazione con una chiave, la configurazione non va a buon fine.

Se desideri impostare una politica di autorizzazione più restrittiva, configura la tua politica specificando un CRN della chiave radice o un'istanza specifica di Key Protect. Le restrizioni applicate ai portachiavi " Key Protect " non sono attualmente supportate.

Concessione dell'autorizzazione al servizio nella CLI

  1. Creare una politica di autorizzazione per consentire al servizio Cloud Databases di accedere all'istanza del servizio Key Protect sulla CLI. Per l'elenco completo degli argomenti, consultare la guida di riferimento della CLI di IAM.
ibmcloud iam authorization-policy-create <SERVICE-NAME> kms "Reader,AuthorizationDelegator"

Se l'autorizzazione al servizio non è presente prima di configurare l'implementazione con una chiave, la configurazione non va a buon fine.

Se desideri impostare una politica di autorizzazione più restrittiva, configura la tua politica specificando un CRN della chiave radice o un'istanza specifica di Key Protect. Le restrizioni applicate ai portachiavi " Key Protect " non sono attualmente supportate.

Concessione dell'autorizzazione al servizio tramite l'API REST

  1. Creare una politica di autorizzazione per consentire al servizio Cloud Databases di accedere all'istanza del servizio Key Protect tramite l'API REST di IAM.

Per una guida completa all'API, consultare l'API di gestione delle politiche IAM.

curl -X POST 'https://iam.cloud.ibm.com/v1/policies' -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
  "type": "authorization",
  "subjects": [
      {
          "attributes": [
              {
                  "name": "accountId",
                  "value": "CUSTOMER_ACCOUNT_ID"
              },
              {
                  "name": "serviceName",
                  "value": "<SERVICE-NAME>"
              }
          ]
      }
  ],
  "roles": [
      {
        "role_id": "crn:v1:bluemix:public:iam::::serviceRole:Reader"
      },
      {
        "role_id": "crn:v1:bluemix:public:iam::::role:AuthorizationDelegator"
      }
    ],
    "resources": [
        {
            "attributes": [
                {
                    "name": "accountId",
                    "operator": "stringEquals",
                    "value": "CUSTOMER_ACCOUNT_ID"
                },
                {
                    "name": "serviceName",
                    "operator": "stringEquals",
                    "value": "kms"
                }
            ]
        }
    ]
}'

Se l'autorizzazione al servizio non è presente prima di configurare l'implementazione con una chiave, la configurazione non va a buon fine.

Se desideri impostare una politica di autorizzazione più restrittiva, configura la tua politica specificando un CRN della chiave radice o un'istanza specifica di Key Protect. Le restrizioni applicate ai portachiavi " Key Protect " non sono attualmente supportate.

Utilizzo del tasto " Key Protect "

Una volta concessa alle tue distribuzioni Cloud Databases l'autorizzazione per utilizzare le tue chiavi, fornisci il nome chiave o il CRN quando esegui il provisioning di una distribuzione. La distribuzione utilizza la tua chiave di crittografia per crittografare i tuoi dati.

Utilizzo del tasto " Key Protect " nell'interfaccia utente durante la configurazione

Se si esegue il provisioning dalla pagina del catalogo, selezionare l'istanza e la chiave " Key Protect " dal menu a tendina.

Utilizzo del parametro Key Protect nella CLI durante la configurazione

Nella CLI, utilizzare il parametro dataservices.encryption.disk nell'oggetto JSON dei parametri per assegnare un CRN della chiave radice all'istanza del servizio.

ibmcloud resource service-instance-create <INSTANCE-NAME> <SERVICE-NAME> <PLAN-NAME> REGION -p '{"dataservices":{"encryption":{"disk":"KMS_KEY_CRN"}}}'

La chiave " Key Protect " deve essere identificata tramite il suo CRN completo, non solo tramite il suo ID. Un CRN di Key Protect ha il formato crn:v1:<...>:key:<id>.

Utilizzo del parametro “ Key Protect ” nell’API durante la configurazione

Nell'API, utilizzare il parametro dataservices.encryption.disk nel corpo della richiesta.

  curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
    "name": "<INSTANCE-NAME>",
    "target": "ca-mon",
    "resource_group": "<A RESOURCE GROUP GUID>",
    "resource_plan_id": "<A PLAN ID>",
    "parameters": {
      "dataservices": {
          "encryption": {
            "disk": "KMS_KEY_CRN"
          }
      }
    }

La chiave " Key Protect " deve essere identificata tramite il suo CRN completo, non solo tramite il suo ID. Un CRN di Key Protect ha il formato crn:v1:<...>:key:<id>.

Rotazione delle chiavi

Key Protect offre la modalità manuale e automatica rotazione delle chiavi e la rotazione delle chiavi è supportata dalle implementazioni Cloud Databases. Quando si ruota una chiave, il processo avvia un’attività di sincronizzazione dello stato KMS e la distribuzione viene ricrittografata con la nuova chiave. L'attività viene visualizzata nella pagina "Attività " della panoramica della tua distribuzione e gli eventi associati " Key Protect " e " Cloud Databases " vengono inviati a Activity Tracker.

Per ulteriori informazioni, consultare la sezione " Rotazione manuale o automatica ".

Eliminazione di una distribuzione

Se si elimina una distribuzione protetta da una chiave " Key Protect ", la distribuzione rimane registrata in relazione alla chiave per tutta la durata del periodo di eliminazione provvisoria (fino a 9 giorni). Per eliminare la chiave durante il periodo di eliminazione provvisoria, è necessario eseguire l'eliminazione forzata della chiave. Dopo il periodo di eliminazione temporanea, la chiave può essere eliminata senza forzatura. Per stabilire quando è possibile eliminare la chiave, verificare l'associazione tra la chiave e la propria distribuzione.

Eliminazione in modo crittografico

L'eliminazione in modo crittografico è un'azione distruttiva. Quando la chiave viene eliminata, i tuoi dati diventano irrecuperabili.

Key Protect consente di avviare l'eliminazione forzata di una chiave attualmente in uso dai servizi di IBM Cloud®, comprese le distribuzioni di Gen 2 Cloud Databases. Questa azione viene chiamata eliminazione in modo crittografico. L'eliminazione di una chiave attualmente in uso nella tua distribuzione blocca i dischi che contengono i tuoi dati e disattiva la distribuzione. È ancora possibile accedere all'interfaccia utente e ad alcuni metadati, come le impostazioni di sicurezza, tramite l'interfaccia utente, la CLI e l'API, ma non è possibile accedere a nessuno dei database né ai dati in essi contenuti. La richiesta di cancellazione della chiave viene inviata all' Activity Tracker Event Routing, all'indirizzo kms.secrets.delete.

Porta con te la tua chiave per i backup

Se utilizzi Key Protect, quando configuri un database puoi anche specificare una chiave per crittografare il disco IBM® Cloud Block Storage for Virtual Private Cloud che contiene i backup della tua distribuzione.

Il backup eredita la stessa chiave di crittografia del database. Non è possibile specificare una chiave di crittografia diversa durante la creazione del backup dal database.

Concessione dell'autorizzazione alla delega

Per consentire alla tua distribuzione di utilizzare la chiave Key Protect, devi abilitare la delega dell'autorizzazione al momento della concessione delle autorizzazioni al servizio. Se l'autorizzazione alla delega non è presente prima di configurare l'implementazione con una chiave, la configurazione non va a buon fine.

Dopo aver abilitato la delega e aver configurato la distribuzione, nelle autorizzazioni di IAM compaiono due voci. Uno è il record relativo alla distribuzione che ne indica lo stato come “delegatore”. È "creato dall'utente".

Esempio di autorizzazione tramite delegatore Key Protect
Ruolo Source Destinazione Immettere
AuthorizationDelegator, Lettore <cloud-databases> servizio Key Protect Servizio Definito dall'utente

E uno per il volume “ Block Storage for VPC ” relativo all’istanza di servizio e ai relativi backup (se presenti), in cui il deployment funge da iniziatore.

Esempio di autorizzazione
Ruolo Source Destinazione Immettere
Lettore Block Storage for VPC servizio Key Protect Servizio Creato da <cloud-databases-crn>

Rimozione delle chiavi

IAM/ Key Protect non impedisce di rimuovere la policy tra la chiave e Block Storage for VPC (il secondo esempio), ma farlo potrebbe rendere i tuoi topic/partizioni non ripristinabili.

Errori comuni

Prestare attenzione quando si rimuovono chiavi e autorizzazioni. Se si dispone di più distribuzioni che utilizzano le stesse chiavi, revocando l'autorizzazione alla delega si rischia di distruggere inavvertitamente i dati di tutte quelle distribuzioni. Se possibile, non utilizzare la stessa chiave per più distribuzioni.

Se desideri distruggere i dati associati alla tua istanza, puoi eliminare la chiave. L'operazione " Block Storage for VPC " garantisce che l'area di archiviazione risulti illeggibile e non scrivibile. Tuttavia, qualsiasi altra installazione (o i relativi backup) che utilizzi quella stessa chiave andrà incontro a errori successivi.

Se è necessario utilizzare la stessa chiave per più distribuzioni e/o backup, la rimozione delle chiavi e delle autorizzazioni può comportare i seguenti effetti collaterali. Se si elimina l'autorizzazione del volume " Block Storage for VPC " (come illustrato nella Tabella 2), non solo ne risentirà la distribuzione indicata come creatrice, ma anche tutte le distribuzioni che utilizzano la stessa chiave. Tali distribuzioni presenteranno errori finché non aprirai un ticket di assistenza e non richiederai la ricreazione della policy.

Prestare attenzione se si riutilizzano le chiavi.