Sincronizzazione Cloud KMS
1. Cos'è?
Cloud KMS Auto-Sync riesporta automaticamente il materiale delle chiavi ai provider KMS cloud collegati ogni volta che una chiave QuantumVault viene ruotata. Invece di esportare manualmente la nuova versione su Azure Key Vault, AWS KMS, GCP Cloud KMS o Scaleway KMS dopo ogni rotazione, la piattaforma lo gestisce automaticamente in background.
2. A cosa serve?
Distribuzione multi-cloud
Mantieni le chiavi di crittografia sincronizzate tra Azure, AWS, GCP e Scaleway con un'unica fonte di verità in QuantumVault.
Conformità alla rotazione
Soddisfa i requisiti di rotazione regolare senza passaggi manuali — le copie cloud sono sempre aggiornate.
Disaster recovery
Assicura che i provider KMS cloud abbiano sempre l'ultima versione della chiave, riducendo i tempi di ripristino.
Migrazione cloud graduale
Mantieni le copie KMS cloud sincronizzate durante la migrazione dei carichi di lavoro. Disattiva le chiavi QuantumVault solo a transizione completata.
3. Concetti chiave
| Term | Definition |
|---|---|
| Auto-sync | Quando attivato, QuantumVault riesporta automaticamente la nuova versione della chiave al provider cloud dopo ogni rotazione. |
| Esportazione cloud | Un record che collega una chiave QuantumVault a uno specifico provider KMS e destinazione (es. nome Azure Key Vault, ARN AWS KMS). |
| Credenziali salvate | Credenziali del provider (client secret, access key, ecc.) memorizzate crittografate nel Vault. Necessarie per l'auto-sync. |
| Sincronizzazione manuale | Un invio singolo del materiale della chiave attuale al provider, attivato con il pulsante 'Sincronizza ora' o via API. |
| Errore di sincronizzazione | Se l'auto-sync fallisce (es. credenziali scadute), l'errore viene registrato in LastSyncError. I fallimenti non sono fatali — la rotazione viene completata comunque. |
| Metadati del provider | Dettagli specifici del provider memorizzati con l'esportazione: nome del vault, key ring, regione, alias, ecc. |
4. Come configurarlo
Attivare l'auto-sync su un'esportazione
Esportare una chiave a un provider
Salvare le credenziali nel Vault
Attivare l'auto-sync alla rotazione
Ruotare normalmente
Provider cloud supportati
Azure Key Vault
Esporta chiavi RSA ed EC su Azure Key Vault. Richiede: Tenant ID, Client ID, Client Secret, nome Key Vault. Il ruolo 'Key Vault Crypto Officer' è necessario.
AWS KMS
Esporta chiavi RSA ed EC su AWS KMS. Richiede: Access Key ID, Secret Access Key, Regione. Permessi IAM kms:ImportKeyMaterial e kms:CreateKey necessari.
GCP Cloud KMS
Esporta chiavi RSA su GCP Cloud KMS. Richiede: JSON account di servizio, Project ID, Location, Key Ring. Ruolo roles/cloudkms.admin o roles/cloudkms.importer necessario.
Scaleway KMS
Esporta chiavi RSA ed EC su Scaleway KMS. Richiede: Access Key, Secret Key, Project ID, Regione. Opzione di sovranità europea.
Prerequisiti e permessi
Ogni provider KMS cloud richiede ruoli IAM o permessi specifici sulla risorsa di destinazione. Senza i permessi corretti, l'esportazione fallirà con un errore di autorizzazione. La propagazione RBAC può richiedere 2-5 minuti dopo l'assegnazione.
Azure Key Vault
| Ruolo / Permesso | Ambito / Risorsa | Note |
|---|---|---|
| Key Vault Crypto Officer | Risorsa Key Vault di destinazione | Gestione completa delle chiavi: importare, creare, ruotare, eliminare. Consigliato per l'auto-sync. |
| Key Vault Keys Reader + Key Vault Crypto User | Risorsa Key Vault di destinazione | Solo lettura + importazione. Non può eliminare o gestire le versioni. |
ForbiddenByRbac — Action: 'Microsoft.KeyVault/vaults/keys/read', Assignment: (not found)AWS KMS
| Ruolo / Permesso | Ambito / Risorsa | Note |
|---|---|---|
| kms:CreateKey + kms:ImportKeyMaterial + kms:DescribeKey + kms:GetParametersForImport | Account AWS / ARN chiave KMS | Workflow di importazione completo. Aggiungere kms:CreateAlias se si usano alias. |
| kms:ImportKeyMaterial + kms:DescribeKey + kms:GetParametersForImport | ARN chiave KMS specifico | La chiave deve già esistere. Non può creare nuove chiavi. |
AccessDeniedException — User: arn:aws:iam::... is not authorized to perform: kms:ImportKeyMaterialGCP Cloud KMS
| Ruolo / Permesso | Ambito / Risorsa | Note |
|---|---|---|
| roles/cloudkms.admin | Key Ring o Progetto di destinazione | Gestione completa KMS: creare chiavi, importare versioni, gestire IAM. |
| roles/cloudkms.importer + roles/cloudkms.viewer | Key Ring di destinazione | Solo importazione versioni. Non può creare chiavi o gestire le policy. |
PERMISSION_DENIED — The caller does not have permission 'cloudkms.importJobs.create'Scaleway KMS
| Ruolo / Permesso | Ambito / Risorsa | Note |
|---|---|---|
| KeyManager (accesso completo) | Progetto Scaleway di destinazione | Gestione completa delle chiavi nel progetto. Consigliato per l'auto-sync. |
| KeyManagerReadOnly + importazione manuale | Progetto Scaleway di destinazione | Accesso in sola lettura. Importazione manuale via API necessaria. |
PermissionsDenied — insufficient permissions on resource 'kms'Sincronizzazione manuale
Puoi attivare una sincronizzazione singola in qualsiasi momento con il pulsante 'Sincronizza ora' o via API. Questo invia la versione attuale senza necessità di rotazione.
POST /api/v1/keys/{keyId}/cloud-exports/{exportId}/sync
Authorization: Bearer <token>Gestione degli errori
I fallimenti di sincronizzazione non sono fatali: se l'auto-sync fallisce durante una rotazione, la rotazione viene completata. L'errore viene registrato in LastSyncError. Cause comuni: credenziali scadute, problemi di rete, permessi insufficienti. Risolvi il problema e usa 'Sincronizza ora' per riprovare.
5. Considerazioni di sicurezza
Le credenziali del provider sono memorizzate crittografate in QuantumVault con la stessa crittografia envelope (AES-256-GCM + nonce QRNG) di tutti gli altri segreti.
I fallimenti di sincronizzazione non bloccano mai la rotazione. La rotazione viene completata e l'errore viene registrato.
Ogni operazione di sincronizzazione viene registrata nel log di audit con timestamp, provider, risultato e operatore.
La gestione delle esportazioni richiede lo scope keys:write. La consultazione richiede keys:read.
6. Riferimento campi
| Field | Type | Description |
|---|---|---|
| id | uuid | Identificatore univoco del record di esportazione. |
| cryptoKeyId | uuid | La chiave QuantumVault collegata a questa esportazione. |
| provider | string | Provider: AzureKeyVault, AwsKms, GcpKms o ScalewayKms. |
| autoSyncEnabled | boolean | Se l'auto-sync alla rotazione è attivato. |
| vaultSecretId | uuid? | ID del segreto Vault con le credenziali. Necessario per attivare l'auto-sync. |
| lastSyncAt | datetime? | Data dell'ultima sincronizzazione riuscita. |
| lastSyncError | string? | Messaggio di errore dell'ultimo tentativo fallito, o null se riuscito. |
| exportedAt | datetime | Data dell'esportazione iniziale. |
| exportedBy | string | Utente o chiave API che ha effettuato l'esportazione. |
7. API / CLI
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/keys/{keyId}/cloud-exports | Elencare le esportazioni KMS di una chiave. |
| PATCH | /api/v1/keys/{keyId}/cloud-exports/{exportId}/auto-sync | Attivare o disattivare l'auto-sync. Body: { "enabled": true/false }. |
| POST | /api/v1/keys/{keyId}/cloud-exports/{exportId}/sync | Sincronizzazione immediata del materiale della chiave al provider. |
| DELETE | /api/v1/keys/{keyId}/cloud-exports/{exportId} | Eliminare un record di esportazione e il segreto associato. |
PATCH /api/v1/keys/{keyId}/cloud-exports/{exportId}/auto-sync
Authorization: Bearer <token>
Content-Type: application/json
{ "enabled": true }8. FAQ
Cosa succede se l'auto-sync fallisce?
La rotazione viene completata comunque. L'errore viene registrato in LastSyncError. Risolvi il problema e clicca 'Sincronizza ora' per riprovare.
Quali algoritmi possono essere esportati?
Solo algoritmi classici (RSA, ECDSA). I post-quantistici (ML-KEM, ML-DSA) non possono essere esportati perché i provider KMS non li supportano ancora.
Come vengono memorizzate le credenziali?
Crittografate con la crittografia envelope standard (AES-256-GCM + nonce QRNG), memorizzate come segreti del Vault. Decrittografate solo al momento della sincronizzazione.
Posso disattivare l'auto-sync senza eliminare l'esportazione?
Sì. Disattiva dalla scheda Esportazioni Cloud o tramite PATCH con { "enabled": false }.
Differenza tra sync manuale e auto-sync?
La sync manuale è un invio singolo. L'auto-sync avviene automaticamente dopo ogni rotazione. Entrambi inviano lo stesso materiale alla stessa destinazione.