QuantumAPI

Sincronizzazione Cloud KMS

2026-02-21 2026-02-21 v0.1.x-beta

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

TermDefinition
Auto-syncQuando attivato, QuantumVault riesporta automaticamente la nuova versione della chiave al provider cloud dopo ogni rotazione.
Esportazione cloudUn record che collega una chiave QuantumVault a uno specifico provider KMS e destinazione (es. nome Azure Key Vault, ARN AWS KMS).
Credenziali salvateCredenziali del provider (client secret, access key, ecc.) memorizzate crittografate nel Vault. Necessarie per l'auto-sync.
Sincronizzazione manualeUn invio singolo del materiale della chiave attuale al provider, attivato con il pulsante 'Sincronizza ora' o via API.
Errore di sincronizzazioneSe 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 providerDettagli 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

1

Esportare una chiave a un provider

Vai ai dettagli della chiave, clicca su Esporta → scegli Azure Key Vault, AWS KMS, GCP Cloud KMS o Scaleway KMS. Inserisci le credenziali e la destinazione.
2

Salvare le credenziali nel Vault

Seleziona 'Salva credenziali nel Vault' durante l'esportazione. Questo memorizza le credenziali crittografate in QuantumVault.
3

Attivare l'auto-sync alla rotazione

Seleziona 'Auto-sync alla rotazione' durante l'esportazione iniziale, o attivalo successivamente dalla scheda Esportazioni Cloud.
4

Ruotare normalmente

Quando la chiave viene ruotata (manualmente o automaticamente), QuantumVault riesporta automaticamente la nuova versione a tutti i provider collegati con auto-sync attivo.

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.

Supportati: RSA-2048, RSA-3072, RSA-4096, EC-P256, EC-P384, EC-P521

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.

Supportati: RSA-2048, RSA-3072, RSA-4096, EC-P256, EC-P384

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.

Supportati: RSA-2048, RSA-3072, RSA-4096

Scaleway KMS

Esporta chiavi RSA ed EC su Scaleway KMS. Richiede: Access Key, Secret Key, Project ID, Regione. Opzione di sovranità europea.

Supportati: RSA-2048, RSA-3072, RSA-4096, EC-P256, EC-P384

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 / PermessoAmbito / RisorsaNote
Key Vault Crypto OfficerRisorsa Key Vault di destinazioneGestione completa delle chiavi: importare, creare, ruotare, eliminare. Consigliato per l'auto-sync.
Key Vault Keys Reader + Key Vault Crypto UserRisorsa Key Vault di destinazioneSolo lettura + importazione. Non può eliminare o gestire le versioni.
Errore comune: ForbiddenByRbac — Action: 'Microsoft.KeyVault/vaults/keys/read', Assignment: (not found)

AWS KMS

Ruolo / PermessoAmbito / RisorsaNote
kms:CreateKey + kms:ImportKeyMaterial + kms:DescribeKey + kms:GetParametersForImportAccount AWS / ARN chiave KMSWorkflow di importazione completo. Aggiungere kms:CreateAlias se si usano alias.
kms:ImportKeyMaterial + kms:DescribeKey + kms:GetParametersForImportARN chiave KMS specificoLa chiave deve già esistere. Non può creare nuove chiavi.
Errore comune: AccessDeniedException — User: arn:aws:iam::... is not authorized to perform: kms:ImportKeyMaterial

GCP Cloud KMS

Ruolo / PermessoAmbito / RisorsaNote
roles/cloudkms.adminKey Ring o Progetto di destinazioneGestione completa KMS: creare chiavi, importare versioni, gestire IAM.
roles/cloudkms.importer + roles/cloudkms.viewerKey Ring di destinazioneSolo importazione versioni. Non può creare chiavi o gestire le policy.
Errore comune: PERMISSION_DENIED — The caller does not have permission 'cloudkms.importJobs.create'

Scaleway KMS

Ruolo / PermessoAmbito / RisorsaNote
KeyManager (accesso completo)Progetto Scaleway di destinazioneGestione completa delle chiavi nel progetto. Consigliato per l'auto-sync.
KeyManagerReadOnly + importazione manualeProgetto Scaleway di destinazioneAccesso in sola lettura. Importazione manuale via API necessaria.
Errore comune: 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.

Manual sync via API
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

Credenziali crittografate

Le credenziali del provider sono memorizzate crittografate in QuantumVault con la stessa crittografia envelope (AES-256-GCM + nonce QRNG) di tutti gli altri segreti.

Fallimenti non bloccanti

I fallimenti di sincronizzazione non bloccano mai la rotazione. La rotazione viene completata e l'errore viene registrato.

Tracciabilità completa

Ogni operazione di sincronizzazione viene registrata nel log di audit con timestamp, provider, risultato e operatore.

Accesso basato su scope

La gestione delle esportazioni richiede lo scope keys:write. La consultazione richiede keys:read.

6. Riferimento campi

FieldTypeDescription
iduuidIdentificatore univoco del record di esportazione.
cryptoKeyIduuidLa chiave QuantumVault collegata a questa esportazione.
providerstringProvider: AzureKeyVault, AwsKms, GcpKms o ScalewayKms.
autoSyncEnabledbooleanSe l'auto-sync alla rotazione è attivato.
vaultSecretIduuid?ID del segreto Vault con le credenziali. Necessario per attivare l'auto-sync.
lastSyncAtdatetime?Data dell'ultima sincronizzazione riuscita.
lastSyncErrorstring?Messaggio di errore dell'ultimo tentativo fallito, o null se riuscito.
exportedAtdatetimeData dell'esportazione iniziale.
exportedBystringUtente o chiave API che ha effettuato l'esportazione.

7. API / CLI

MethodEndpointDescription
GET/api/v1/keys/{keyId}/cloud-exportsElencare le esportazioni KMS di una chiave.
PATCH/api/v1/keys/{keyId}/cloud-exports/{exportId}/auto-syncAttivare o disattivare l'auto-sync. Body: { "enabled": true/false }.
POST/api/v1/keys/{keyId}/cloud-exports/{exportId}/syncSincronizzazione immediata del materiale della chiave al provider.
DELETE/api/v1/keys/{keyId}/cloud-exports/{exportId}Eliminare un record di esportazione e il segreto associato.
Toggle auto-sync via API
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.

QuantumAPI Documentation