Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Crittografia a riposo per Amazon EventBridge Custom Event Bus
Opzioni per la crittografia a riposo
Amazon EventBridge Custom Event Bus crittografa tutti i dati inattivi per impostazione predefinita, lato server, prima che vengano scritti sullo storage: payload degli eventi, metadati degli eventi, modelli di filtro degli abbonati e configurazioni degli obiettivi degli abbonati. Non è necessario configurare nulla, creare chiavi o concedere autorizzazioni per eseguire la crittografia a riposo e non sono previsti costi aggiuntivi per questa crittografia predefinita.
Per impostazione predefinita, i tuoi dati vengono crittografati utilizzando Advanced Encryption Standard (AES-256) a 256 bit con una chiave AWS proprietaria, una chiave KMS che EventBridge possiede e gestisce per te. Non puoi visualizzare, gestire o utilizzare questa chiave e il suo utilizzo non compare nei tuoi registri. AWS CloudTrail AWS le chiavi di proprietà sono gratuite e non vengono conteggiate nelle AWS KMS quote del tuo account. AWS le chiavi possedute vengono ruotate automaticamente ogni mese.
Per ulteriori informazioni, consulta la pagina chiavi di proprietàAWS nella Guida per gli sviluppatori di AWS Key Management Service .
Facoltativamente, puoi scegliere di crittografare un bus di eventi con una chiave KMS simmetrica gestita dal cliente che puoi creare, possedere e gestire. Una chiave gestita dal cliente ti offre:
Controllo completo sul ciclo di vita delle chiavi: policy delle chiavi, rotazione, disabilitazione, cancellazione.
CloudTrail visibilità su come EventBridge utilizza la tua chiave.
La possibilità di definire l'accesso con le condizioni chiave della policy KMS, per bus di eventi.
Le chiavi gestite dal cliente comportano AWS KMS costi: una tariffa mensile per la chiave e addebiti per le richieste API KMS ad essa inviate. Queste richieste vengono conteggiate anche ai fini delle quote di AWS KMS richieste nel tuo account. Poiché EventBridge crittografa e decrittografa gli eventi localmente con una chiave branch memorizzata nella cache (vediIn che modo Custom Event Bus utilizza una chiave KMS gestita dal cliente per la crittografia a riposo), il volume di richieste KMS è di poche chiamate per bus di eventi per finestra della cache più la rotazione delle chiavi: non cresce con il volume degli eventi. Per informazioni dettagliate, consulta Prezzi di AWS Key Management Service
Crittografia dei dati inattivi utilizzando chiavi KMS gestite dal cliente per Custom Event Bus
In che modo Custom Event Bus utilizza una chiave KMS gestita dal cliente per la crittografia a riposo
Cosa viene crittografato con la tua chiave (per bus di eventi):
Payload e metadati degli eventi, archiviati per il periodo di conservazione del bus (1-365 giorni) nell'archivio eventi del bus e nell'archivio di consegna per abbonato.
Schemi di filtro degli abbonati e configurazioni di destinazione, archiviati con la configurazione del bus.
Cosa non è crittografato con la tua chiave:
Identificatori di risorse EventBridge necessari per il routing e la ricerca: nome del bus, ARN del bus, ID account.
L'ID del gruppo di messaggi, che ordina la consegna di FIFO. Evita di inserire dati sensibili in questo campo.
L'ID di deduplicazione del messaggio. EventBridge lo memorizza come hash unidirezionale.
Metadati interni del servizio: risultati delle corrispondenze degli abbonamenti, numeri di sequenza.
Questi elementi sono ancora crittografati quando sono inattivi dai servizi di storage sottostanti, non dalla chiave dell'utente.
Come funziona la crittografia. Quando configuri una chiave gestita dal cliente su un bus di eventi, EventBridge crea una chiave di filiale per quel bus. La chiave branch è una chiave intermedia. È memorizzata in una tabella gestita dal servizio, racchiusa nella chiave KMS, seguendo il portachiavi gerarchico. AWS Encryption SDK EventBridge utilizza la chiave branch per derivare chiavi di crittografia dei dati per evento. Quindi gli eventi vengono crittografati e decrittografati localmente, senza una chiamata KMS per evento:
Quando si pubblica un evento, lo EventBridge crittografa con la chiave di filiale del bus prima di qualsiasi scrittura sullo storage.
Quando EventBridge consegna un evento, lo decripta per la valutazione e la distribuzione del filtro.
EventBridge invia l'evento decrittografato alla destinazione. La crittografia a riposo nella destinazione è responsabilità del servizio di destinazione.
La chiave branch viene memorizzata nella memoria del servizio per un massimo di 15 minuti. Alla scadenza della cache, EventBridge richiama
kms:Decryptla chiave per estrarre nuovamente la chiave branch.EventBridge ruota la chiave di ramo creando una nuova versione ogni 30 giorni circa. Le versioni precedenti vengono mantenute in modo che gli eventi scritti in precedenza rimangano leggibili per il periodo di conservazione del bus.
Due percorsi di accesso. EventBridge accede alla chiave esattamente in due modi. Per le operazioni sincrone e i controlli di autorizzazione, utilizza le credenziali dell'utente, inoltrate dalla chiamata API. Per il lavoro asincrono (consegna degli eventi, ciclo di vita delle chiavi di filiale) funge da responsabile del events.amazonaws.comservizio, poiché la chiamata API è stata completata e le credenziali non sono più disponibili. La policy chiave regola entrambi i percorsi, come descritto di seguito.
Configurazione di una chiave KMS gestita dal cliente su un bus di eventi
Tipi di chiavi supportati:
Solo chiavi di crittografia simmetriche (
SYMMETRIC_DEFAULTutilizzoENCRYPT_DECRYPTdelle chiavi). Le chiavi asimmetriche e le chiavi HMAC vengono rifiutate.Multi-Region le chiavi sono supportate come chiavi ordinarie: utilizzate la replica nella regione del bus degli eventi. EventBridge non replica i dati o il materiale chiave in tutte le regioni.
Sono supportate le chiavi con materiale chiave importato e le chiavi in un archivio di chiavi esterno (XKS).
Identificatore chiave. Specificate la chiave tramite la relativa chiave ARN.
Configurazione delle autorizzazioni per l'utilizzo di una chiave KMS gestita dal cliente
La tua politica chiave richiede tre istruzioni per EventBridge Custom Event Bus. Sostituisci l'account, la regione, il ruolo e il nome del bus di esempio.
Un contesto di crittografia è un insieme di coppie chiave-valore non segrete che si associano AWS KMS crittograficamente a una richiesta e che è possibile utilizzare come condizione per l'autorizzazione nelle politiche chiave. Ogni richiesta KMS relativa EventBridge a un bus di eventi include un contesto di crittografia che associa la richiesta all'ARN di quel bus, quindi ogni istruzione riportata di seguito può essere estesa a un singolo bus. La chiave di contesto è aws:events:event-busv2:arn e il suo valore è l'ARN del bus, su ogni richiesta EventBridge effettuata, sia con le tue credenziali che come responsabile del servizio. Definizione dell'accesso alla chiave KMS gestita dal clientetratta l'ambito in modo più dettagliato. La parte finale dei valori del /* contesto di crittografia corrisponde al suffisso del bus ARN, che viene generato alla creazione (). EventBridge arn:aws:events:region:account:event-busv2/name/suffix
{ "Version": "2012-10-17", "Id": "eventbridge-eventbus-v2-cmk-policy", "Statement": [ { "Sid": "AllowKeyValidationThroughEventBridge", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/ExampleRole" }, "Action": "kms:DescribeKey", "Resource": "*", "Condition": { "StringEquals": { "kms:ViaService": "events.us-east-1.amazonaws.com" } } }, { "Sid": "AllowKeyUseThroughEventBridge", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/ExampleRole" }, "Action": [ "kms:Decrypt", "kms:Encrypt", "kms:GenerateDataKeyWithoutPlaintext", "kms:ReEncryptFrom", "kms:ReEncryptTo" ], "Resource": "*", "Condition": { "StringEquals": { "kms:ViaService": "events.us-east-1.amazonaws.com" }, "StringLike": { "kms:EncryptionContext:aws:events:event-busv2:arn": "arn:aws:events:us-east-1:111122223333:event-busv2/my-bus/*" } } }, { "Sid": "AllowEventBridgeServicePrincipal", "Effect": "Allow", "Principal": { "Service": "events.amazonaws.com" }, "Action": [ "kms:Decrypt", "kms:Encrypt", "kms:GenerateDataKeyWithoutPlaintext", "kms:ReEncryptFrom", "kms:ReEncryptTo" ], "Resource": "*", "Condition": { "StringLike": { "kms:EncryptionContext:aws:events:event-busv2:arn": "arn:aws:events:us-east-1:111122223333:event-busv2/my-bus/*" } } } ] }
Scopo di ogni dichiarazione:
-
AllowKeyValidationThroughEventBridgeconsente ai responsabili di convalidare la chiave durante la creazione o l'aggiornamento di un bus di eventi. EventBridgechiamakms:DescribeKeycon le tue credenziali per confermare che la chiave esiste, è simmetrica e è abilitata. L'DescribeKeyAPI non ha parametri di contesto di crittografia. Quindi questa dichiarazione non ha alcuna condizione relativa al contesto di crittografia. Lakms:ViaServicecondizione limita la concessione di questa dichiarazione alle richieste che arrivano. EventBridge -
AllowKeyUseThroughEventBridgeautorizza i controlli di accesso EventBridge eseguiti con le tue credenziali. EventBridge esegue questi controlli prima di accettare una configurazione chiave e prima di scrivere o leggere dati crittografati per conto dell'utente. Quindi non è possibile configurare una chiave successiva, non EventBridge utilizzabile dall'elaborazione asincrona. I controlli sono KMS dry run: autorizzano ma non crittografano o decrittografano nulla. Dry-run le richieste vengono fatturate come richieste API KMS standard e vengono conteggiate ai fini delle quote di richieste KMS; consulta Testing your permissions nella Developer Guide.AWS Key Management Service Per operazione:CreateEventBuscon controlli chiave gestiti dal clientekms:GenerateDataKeyWithoutPlaintext,kms:ReEncryptFrom/kms:ReEncryptTo, ekms:Decrypt. Queste sono le azioni eseguite dalla creazione delle chiavi di ramo e dalle letture successive.Ogni modifica di
UpdateEventBuschiave verificakms:Decryptla chiave corrente, pluskms:Encryptekms:Decryptla nuova chiave. Queste sono le azioni eseguite dalla transizione chiave.PutEvents/PutRawEventssu un autobus con controlli chiave gestiti dal clientekms:Decrypt. Anche un chiamante che non è in grado di leggere gli eventi del bus potrebbe non scriverli.CreateSubscriber/UpdateSubscriberverificakms:Decrypt, perché la configurazione dell'abbonato è crittografata con la chiave bus.
Scelta dei principi per questa dichiarazione. Puoi elencare gli ARN dei singoli ruoli o utenti in oppure utilizzare l'account root principal per delegare questo accesso alle policy IAM nel tuo account.
Principal -
AllowEventBridgeServicePrincipalautorizza il lavoro svolto EventBridge dal servizio dopo il completamento della chiamata API, quando le credenziali non sono più disponibili:kms:GenerateDataKeyWithoutPlaintextandkms:ReEncryptFrom/kms:ReEncryptTo: EventBridge crea la chiave di filiale del bus e crea nuove versioni della chiave di ramo a rotazione.kms:Decrypt: EventBridge decompone la chiave branch per fornire eventi, caricare la configurazione dell'abbonato e restituire una configurazione decrittografata durante le chiamate di descrizione.kms:Decryptekms:Encrypt: EventBridge riavvolge la chiave branch quando si modifica la chiave KMS del bus.
Questa istruzione utilizza la stessa condizione di contesto di crittografia di.
AllowKeyUseThroughEventBridgeOgni richiesta EventBridge fa sì che un bus, su entrambi i percorsi di accesso, portiaws:events:event-busv2:arncon sé l'ARN del bus, quindi entrambe le istruzioni associano l'uso della chiave allo specifico bus di eventi.
Cross-account chiavi: la chiave può trovarsi in un account diverso rispetto al bus degli eventi (ad esempio, un account di sicurezza centrale). In tal caso, inserisci tutte e tre le affermazioni nella politica di quella chiave. Le prime due Principal voci delle istruzioni indicano i ruoli dell'account bus. I valori del contesto di crittografia denominano l'ARN del bus dell'account bus. Cross-account L'accesso al KMS richiede l'autorizzazione da entrambe le parti: oltre alle dichiarazioni politiche chiave di cui sopra, i ruoli dell'account bus necessitano di policy di identità IAM che consentano le stesse azioni KMS sull'ARN della chiave. Accedi alla chiave tramite la sua chiave ARN completa.
Creazione di un nuovo bus di eventi con una chiave KMS gestita dal cliente
Specificare la chiave ARN nel EncryptionConfiguration parametro di: CreateEventBus
{ "Name": "my-bus", "EncryptionConfiguration": { "KmsKeyIdentifier": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" } }
Al momento della creazione, EventBridge convalida la chiave e il tuo accesso con le tue credenziali (i DescribeKey controlli precedenti sono stati eseguiti a secco). EventBridge quindi fornisce la chiave della filiale del bus in modo asincrono, come principale del servizio. Se la dichiarazione principale del servizio non è inclusa nella politica chiave, il bus passa a e DescribeEventBus restituisce un StateReason nome all'CREATE_FAILEDerrore di accesso KMS.
DescribeEventBussu un bus con una chiave gestita dal cliente restituisce la sua. EncryptionConfiguration Un bus che utilizza la chiave AWS di proprietà predefinita restituisce noEncryptionConfiguration: EventBridge non restituisce mai la chiave AWS di proprietà.
Modifica della configurazione di crittografia su un bus di eventi esistente
Tutte le transizioni sono supportate tramite UpdateEventBus:
AWS chiave proprietaria → chiave gestita dal cliente
chiave gestita dal cliente → diversa chiave gestita dal cliente
Chiave gestita dal cliente → chiave AWS proprietaria: send
EncryptionConfigurationpresent and empty ("EncryptionConfiguration": {}). Omettere completamente il membro significa «lasciare invariata la configurazione di crittografia».
Quando si cambia la chiave, l'autobus entra. UPDATING EventBridge riavvolge la chiave branch sotto la nuova chiave. L'autobus torna quindi a. ACTIVE La chiave di filiale in sé non cambia, quindi il materiale che protegge i dati non cambia. Cambia solo la chiave di avvolgimento. Conseguenze:
Gli eventi scritti in precedenza rimangono leggibili dopo la transizione, indipendentemente dallo stato della vecchia chiave. Una volta completata la transizione, puoi disabilitare immediatamente la vecchia chiave senza perdere l'accesso agli eventi esistenti.
I nuovi eventi continuano con la stessa chiave branch, ora protetta dalla nuova chiave KMS.
Non viene eseguita alcuna nuova crittografia degli eventi memorizzati, quindi le transizioni vengono completate rapidamente e non dipendono dalla quantità di dati contenuta nel bus.
Rotazione automatica dei tasti KMS: se abiliti la rotazione automatica dei tasti sulla chiave, KMS ruota il materiale di supporto dietro la stessa chiave ARN. La rotazione non influisce immediatamente sulla chiave branch. La chiave di diramazione rimane avvolta dal materiale che l'ha avvolta l'ultima volta. La prossima versione branch-key, creata all'incirca ogni 30 giorni, è protetta dall'attuale materiale di supporto. Quindi KMS-side la rotazione avrà effetto sul tuo autobus entro circa un mese.
Se la chiave non è più disponibile (disabilitata, eliminata o accesso rimosso):
La pubblicazione sul bus fallisce con un errore di accesso KMS alla scadenza della chiave di filiale memorizzata nella cache, entro 15 minuti.
La consegna dell'evento si interrompe nello stesso punto, per lo stesso motivo.
Gli eventi EventBridge già accettati non vengono eliminati e gli errori di decrittografia non vengono indirizzati alle code di lettere morte. EventBridge li riprova. Un errore di accesso tramite chiave è una condizione che può essere risolta, quindi EventBridge blocca e riprova gli eventi interessati anziché deviarli. Nessun evento viene perso a meno che l'interruzione non superi il periodo di conservazione del bus.
Dopo aver ripristinato l'accesso, l'elaborazione riprende automaticamente, per tutto il tempo in cui gli eventi rimangono entro il periodo di conservazione del bus.
L'eliminazione della chiave è permanente. La disabilitazione di una chiave o la rimozione EventBridge dell'accesso sono reversibili: ripristina l'accesso e l'elaborazione riprende. L'eliminazione della chiave non lo è. Dopo aver AWS KMS eliminato la chiave attualmente configurata su un bus, non è più EventBridge possibile scartare la chiave della filiale del bus e ogni evento ancora memorizzato sul bus diventa permanentemente illeggibile per il resto del periodo di conservazione. Come best practice, disattivate prima la chiave e confermate l'impatto prima di programmarne l'eliminazione. Vedi Eliminazione delle AWS KMS chiavi nella Guida per gli AWS Key Management Service sviluppatori.
L'eliminazione di un bus non richiede la chiave. DeleteEventBusriesce anche se la chiave è disabilitata o eliminata.
Definizione dell'accesso alla chiave KMS gestita dal cliente
Contesto di crittografia. Ogni richiesta KMS relativa EventBridge a un bus di eventi include un contesto di crittografia che lega la richiesta all'ARN di quel bus. Quindi puoi estendere ogni istruzione a un singolo bus, come nella politica di esempio. La chiave di contesto si trova
aws:events:event-busv2:arnsu ogni richiesta, sia essa effettuata con le tue credenziali o come responsabile del servizio. Da utilizzareStringLikecon un trailing/*, poiché l'ARN del bus termina con un suffisso generato al momento della creazione. Su un bus esistente puoi abbinare l'ARN esatto di aDescribeEventBus.StringEqualskm:. ViaService Tutte le richieste effettuate con le tue credenziali compilano la chiave di
kms:ViaServicecondizione con.events.Quindi puoi limitare l'accesso dei tuoi responsabili all'uso delle chiavi solo tramite. EventBridgeregion.amazonaws.comPropagazione delle modifiche alle politiche chiave. Le operazioni relative ai singoli eventi utilizzano la chiave di filiale memorizzata nella cache e non vengono riconvalidate in base alla policy chiave per evento. Una modifica della policy chiave, inclusa la rimozione EventBridge dell'accesso, ha effetto per la gestione dei dati di un bus alla scadenza della chiave branch memorizzata nella cache, entro 15 minuti.
Vice protezione confusa. Le EventBridge richieste effettuate come principale del servizio includono il
aws:SourceArncontesto (l'ARN del bus) e ilaws:SourceAccountcontesto. Quindi puoi aggiungere queste condizioni allaAllowEventBridgeServicePrincipaldichiarazione. Garantiscono l' EventBridge utilizzo della chiave solo per conto delle proprie risorse:"Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:events:us-east-1:111122223333:event-busv2/my-bus/*" } }
Monitoraggio dell'interazione di EventBridge Custom Event Bus con AWS KMS
EventBridgel'uso della chiave gestita dai clienti appare in AWS CloudTrail. Vedi Registrazione delle chiamate AWS KMS API con AWS CloudTrail. Eventi da aspettarsi:
CloudTrail eventName |
Quando | Identità di chiamata |
|---|---|---|
DescribeKey |
Convalida create/update delle chiavi del bus | Il tuo preside, tramite EventBridge |
Decrypt,Encrypt,GenerateDataKeyWithoutPlaintext, ReEncrypt (funzionamento a secco) |
Controlli di autorizzazione su bus create/update, publish, subscriber create/update | Il tuo preside (via EventBridge) |
GenerateDataKeyWithoutPlaintext, ReEncrypt |
Branch-key creazione (creazione tramite bus) e rotazione delle chiavi di filiale (~30 giorni) | Principale del servizio events.amazonaws.com |
Decrypt |
Branch-key unwrap alla scadenza della cache: consegna degli eventi, caricamento della configurazione dell'abbonato, decrittografia Describetime | Principale del servizio events.amazonaws.com |
Decrypt + Encrypt |
Branch-key UpdateEventBusriepiloga in caso di cambio di chiave |
Principale del servizio events.amazonaws.com |
CloudTrail registra la chiamata ReEncrypt API come un unico evento. Le autorizzazioni kms:ReEncryptFrom e kms:ReEncryptTo le autorizzazioni contenute nella politica chiave autorizzano entrambe la chiamata.
I controlli di autorizzazione sono richieste KMS dry-run. In base alla progettazione, viene restituita una richiesta di esecuzione a secco DryRunOperationException anziché eseguire l'operazione: quella risposta è la traccia di un controllo superato, non un errore nella configurazione. La visualizzazione di una voce dry-run indica AccessDeniedException invece che al chiamante manca l'autorizzazione da verificare. Per i dettagli, consulta Verifica delle autorizzazioni nella Guida per gli sviluppatori.AWS Key Management Service
Una requestParameters.encryptionContext di queste voci include aws:events:event-busv2:arn l'ARN del bus. Le voci relative alle operazioni con chiave di filiale includono anche i metadati delle chiavi di filiale aggiunti dal portachiavi gerarchico: (l'ARN branch-key-id del bus),,,, e. type create-time tablename hierarchy-version kms-arn
La crittografia e la decrittografia dei singoli eventi utilizzano chiavi di dati derivate localmente dalla chiave branch memorizzata nella cache. Quindi le operazioni per evento non vengono visualizzate in. CloudTrail Vengono visualizzate solo le operazioni con le chiavi di filiale.