Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Chiffrement au repos pour Amazon EventBridge Custom Event Bus
Options de chiffrement au repos
Amazon EventBridge Custom Event Bus chiffre toutes vos données au repos par défaut, côté serveur, avant qu'elles ne soient enregistrées dans le stockage : charges utiles des événements, métadonnées des événements, modèles de filtrage des abonnés et configurations cibles des abonnés. Vous n'avez pas besoin de configurer quoi que ce soit, de créer de clés ou d'accorder des autorisations pour obtenir le chiffrement au repos, et ce chiffrement par défaut n'entraîne aucun coût supplémentaire.
Par défaut, vos données sont chiffrées à l'aide de la norme Advanced Encryption Standard (AES-256) 256 bits sous une cléAWS propriétaire, une clé KMS qui EventBridge possède et gère pour vous. Vous ne pouvez pas consulter, gérer ou utiliser cette clé, et son utilisation n'apparaît pas dans vos AWS CloudTrail journaux. AWS les clés que vous possédez sont gratuites et ne sont pas prises en compte dans les AWS KMS quotas de votre compte. AWS les clés détenues font automatiquement l'objet d'une rotation mensuelle.
Pour plus d’informations, consultez Clés détenues par AWS dans le Guide du développeur AWS Key Management Service .
Vous pouvez éventuellement choisir de chiffrer un bus d'événements avec une clé KMS symétrique gérée par le client que vous créez, détenez et gérez. Une clé gérée par le client vous permet de :
Contrôle total du cycle de vie des clés : politique des clés, rotation, désactivation, suppression.
CloudTrail visibilité sur l' EventBridge utilisation de votre clé.
Possibilité de définir l'accès selon les principales conditions de politique du KMS, par bus d'événements.
Les clés gérées par le client entraînent AWS KMS des frais : des frais mensuels pour la clé et des frais pour les demandes d'API KMS qui lui sont adressées. Ces demandes sont également prises en compte dans les quotas de AWS KMS demandes de votre compte. Comme il EventBridge chiffre et déchiffre les événements localement sous une clé de branche mise en cache (voirComment Custom Event Bus utilise une clé KMS gérée par le client pour le chiffrement au repos), son volume de demandes KMS est de quelques appels par bus d'événements par fenêtre de cache, plus la rotation des clés. Il n'augmente pas avec le volume d'événements. Pour plus d’informations, consultez Tarification AWS Key Management Service
Chiffrement des données au repos à l'aide de clés KMS gérées par le client pour un bus d'événements personnalisé
Comment Custom Event Bus utilise une clé KMS gérée par le client pour le chiffrement au repos
Qu'est-ce qui est chiffré avec votre clé (par bus d'événement) :
Charges utiles et métadonnées des événements, stockées pendant la période de conservation du bus (1 à 365 jours) dans le stockage des événements du bus et dans le stockage des livraisons par abonné.
Modèles de filtrage des abonnés et configurations cibles, enregistrés avec la configuration du bus.
Ce qui n'est pas chiffré avec votre clé :
Identifiants de ressources nécessaires au routage et à la recherche : nom du bus, ARN du bus, ID de compte. EventBridge
L'ID du groupe de messages, qui commande la livraison du FIFO. Évitez de placer des données sensibles dans ce champ.
ID de déduplication du message. EventBridge le stocke sous forme de hachage unidirectionnel.
Métadonnées du service interne : résultats de correspondance des abonnements, numéros de séquence.
Ces éléments sont toujours chiffrés au repos par les services de stockage sous-jacents, et non par votre clé.
Comment fonctionne le chiffrement Lorsque vous configurez une clé gérée par le client sur un bus d'événements, vous EventBridge créez une clé de branche pour ce bus. La clé de branche est une clé intermédiaire. Il est stocké dans une table gérée par les services, enveloppée par votre clé KMS, conformément au trousseau de clés AWS Encryption SDK hiérarchique. EventBridge utilise la clé de branche pour dériver les clés de chiffrement des données par événement. Les événements sont donc chiffrés et déchiffrés localement, sans appel KMS par événement :
Lorsque vous publiez un événement, EventBridge cryptez-le sous la clé de branche du bus avant toute écriture dans le stockage.
Lorsqu'il EventBridge diffuse un événement, il déchiffre l'événement pour l'évaluation et la diffusion du filtre.
EventBridge envoie l'événement déchiffré à votre cible. Le chiffrement au repos à destination relève de la responsabilité du service de destination.
La clé de branche est mise en cache dans la mémoire de service pendant 15 minutes maximum. À l'expiration du cache, EventBridge
kms:Decryptappelez votre clé pour déballer à nouveau la clé de branche.EventBridge fait pivoter la clé de branche en créant une nouvelle version environ tous les 30 jours. Les anciennes versions sont conservées afin que les événements précédemment écrits restent lisibles pendant la période de conservation du bus.
Deux voies d'accès. EventBridge accède à votre clé exactement de deux manières. Pour les opérations synchrones et les contrôles d'autorisation, il utilise vos informations d'identification, transmises depuis votre appel d'API. Pour le travail asynchrone (diffusion d'événements, cycle de vie des clés de branche), il agit en tant que principal de events.amazonaws.com service, car votre appel d'API est terminé et vos informations d'identification ne sont plus disponibles. Votre politique clé régit les deux voies, comme décrit ci-dessous.
Configuration d'une clé KMS gérée par le client sur un bus d'événements
Types de clés pris en charge :
Clés de chiffrement symétriques uniquement (utilisation
SYMMETRIC_DEFAULTdes clésENCRYPT_DECRYPT). Les clés asymétriques et les clés HMAC sont rejetées.Multi-Region les clés sont prises en charge comme des clés ordinaires : utilisez la réplique dans la région du bus d'événements. EventBridge ne reproduit pas vos données ou vos informations clés d'une région à l'autre.
Les clés dont le matériel clé est importé et les clés stockées dans un magasin de clés externe (XKS) sont prises en charge.
Identifiant clé. Spécifiez la clé à l'aide de son ARN de clé.
Configuration des autorisations pour utiliser une clé KMS gérée par le client
Votre politique clé nécessite trois déclarations pour EventBridge Custom Event Bus. Remplacez les exemples de compte, de région, de rôle et de nom de bus.
Un contexte de chiffrement est un ensemble de paires clé-valeur non secrètes qui se lient AWS KMS cryptographiquement à une demande et que vous pouvez utiliser comme condition d'autorisation dans les politiques clés. Chaque demande KMS EventBridge génère un bus d'événements et inclut un contexte de chiffrement qui lie la demande à l'ARN de ce bus, de sorte que chaque instruction ci-dessous peut être étendue à un seul bus. La clé de contexte est aws:events:event-busv2:arn et sa valeur est l'ARN du bus, à chaque demande, que EventBridge ce soit avec vos informations d'identification ou en tant que principal de service. Délimitation de l'accès à la clé KMS gérée par le clientcouvre le cadrage plus en détail. La fin des valeurs du contexte de chiffrement correspond /* au suffixe de l'ARN du bus, qui est EventBridge généré lors de la création (). 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/*" } } } ] }
Objectif de chaque déclaration :
-
AllowKeyValidationThroughEventBridgepermet à vos principaux collaborateurs de valider la clé lors de la création ou de la mise à jour d'un bus d'événements. EventBridgeappellekms:DescribeKeyavec vos informations d'identification pour confirmer que la clé existe, qu'elle est symétrique et qu'elle est activée. L'DescribeKeyAPI ne possède aucun paramètre de contexte de chiffrement. Cette instruction ne comporte donc aucune condition de contexte de chiffrement. Lakms:ViaServicecondition limite l'octroi de cette déclaration aux demandes reçues EventBridge. -
AllowKeyUseThroughEventBridgeautorise les contrôles d'accès exécutés avec EventBridge vos informations d'identification. EventBridge exécute ces vérifications avant d'accepter une configuration de clé et avant d'écrire ou de lire des données chiffrées en votre nom. Vous ne pouvez donc pas configurer une clé qui EventBridge sera utilisée ultérieurement par le traitement asynchrone. Les contrôles sont des tests KMS : ils autorisent mais ne chiffrent ni ne déchiffrent quoi que ce soit. Dry-run les demandes sont facturées comme des demandes d'API KMS standard et sont prises en compte dans le cadre de vos quotas de demandes KMS ; voir Tester vos autorisations dans le guide du AWS Key Management Service développeur. Par opération :CreateEventBusavec une vérification des clés gérée par le clientkms:GenerateDataKeyWithoutPlaintext,kms:ReEncryptFrom/kms:ReEncryptTo, etkms:Decrypt. Il s'agit des actions que la création de touches de branche et les lectures ultérieures exécutent.Tout changement de
UpdateEventBusclé vérifiekms:Decryptla clé actuelle,kms:Encryptainsi quekms:Decryptla nouvelle clé. Ce sont les actions effectuées par la transition clé.PutEvents/PutRawEventsdans un bus avec vérification des clés gérée par le clientkms:Decrypt. Un appelant qui ne peut pas relire les événements du bus ne peut pas non plus les écrire.CreateSubscriber/UpdateSubscribervérifiekms:Decrypt, car la configuration des abonnés est cryptée sous la clé de bus.
Choix des principes pour cette déclaration. Vous pouvez répertorier les ARN des rôles ou des utilisateurs individuels dans le
Principalcompte ou utiliser le principal racine du compte pour déléguer cet accès aux politiques IAM de votre compte. -
AllowEventBridgeServicePrincipalautorise le travail effectué en EventBridge tant que service une fois votre appel d'API terminé, lorsque vos informations d'identification ne sont plus disponibles :kms:GenerateDataKeyWithoutPlaintextetkms:ReEncryptFrom/kms:ReEncryptTo: EventBridge crée la clé de branche du bus et crée de nouvelles versions de clé de branche lors de la rotation.kms:Decrypt: EventBridge déballe la clé de branche pour transmettre les événements, charger la configuration des abonnés et renvoyer la configuration déchiffrée lors des appels de description.kms:Decryptetkms:Encrypt: EventBridge réenroule la clé de branche lorsque vous modifiez la clé KMS du bus.
Cette instruction utilise la même condition de contexte de chiffrement que.
AllowKeyUseThroughEventBridgeChaque demande EventBridge implique qu'un bus, sur l'un ou l'autre chemin d'accès, soit transportéaws:events:event-busv2:arnpar l'ARN du bus, de sorte que les deux instructions lient l'utilisation de la clé au bus d'événements spécifique.
Cross-account clés : la clé peut se trouver dans un compte différent de celui du bus d'événements (par exemple, un compte de sécurité central). Dans ce cas, insérez les trois déclarations dans la politique de cette clé. Les Principal entrées des deux premières déclarations nomment les rôles du compte de bus. Les valeurs du contexte de chiffrement nomment l'ARN du bus du compte de bus. Cross-account L'accès au KMS nécessite une autorisation des deux côtés : outre les principales déclarations de politique ci-dessus, les rôles du compte de bus nécessitent des politiques d'identité IAM qui autorisent les mêmes actions KMS sur l'ARN de la clé. Accédez à la clé par son ARN complet.
Création d'un nouveau bus d'événements avec une clé KMS gérée par le client
Spécifiez l'ARN de la clé dans le EncryptionConfiguration paramètre de CreateEventBus:
{ "Name": "my-bus", "EncryptionConfiguration": { "KmsKeyIdentifier": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" } }
Au moment de la création, EventBridge valide la clé et votre accès à l'aide de vos informations d'identification (les vérifications à sec DescribeKey et à sec ci-dessus). EventBridge provisionne ensuite la clé de branche du bus de manière asynchrone, en tant que principal de service. Si la déclaration principale du service est absente de votre politique clé, le bus passe à CREATE_FAILED l'erreur d'accès KMS et DescribeEventBus renvoie un StateReason nom.
DescribeEventBusdans un bus avec une clé gérée par le client, renvoie la sienneEncryptionConfiguration. Un bus utilisant la clé AWS détenue par défaut renvoie non EncryptionConfiguration : EventBridge ne renvoie jamais la clé AWS détenue.
Modification de la configuration de chiffrement sur un bus d'événements existant
Toutes les transitions sont prises en charge, via UpdateEventBus:
AWS clé détenue → clé gérée par le client
Clé gérée par le client → clé gérée par le client différente
Clé gérée par le client → clé AWS détenue : envoyer le
EncryptionConfigurationprésent et le vide ("EncryptionConfiguration": {}). L'omission complète du membre signifie « laisser la configuration de chiffrement inchangée ».
Lorsque vous changez de clé, le bus entreUPDATING. EventBridge réenroule la clé de branche sous la nouvelle clé. Le bus revient ensuite àACTIVE. La clé de branche elle-même ne change pas, de sorte que le matériel protégeant vos données ne change pas. Seule la clé d'emballage change. Conséquences :
Les événements précédemment écrits restent lisibles après la transition, quel que soit l'état de l'ancienne clé. Une fois la transition terminée, vous pouvez désactiver immédiatement l'ancienne clé sans perdre l'accès aux événements existants.
Les nouveaux événements se poursuivent sous la même clé de branche, désormais protégée par la nouvelle clé KMS.
Aucun rechiffrement des événements enregistrés n'a lieu. Les transitions s'effectuent donc rapidement et ne dépendent pas de la quantité de données que le bus contient.
Rotation automatique des clés KMS : si vous activez la rotation automatique des clés sur votre clé, KMS fait pivoter le support situé derrière le même ARN de clé. La rotation n'affecte pas immédiatement la clé de branche. La clé de branche reste enveloppée dans le matériau qui l'a enveloppée en dernier. La version clé de branche suivante, créée environ tous les 30 jours, est protégée par le matériel de support actuel. KMS-side La rotation prend donc effet dans votre bus dans un délai d'un mois environ.
Si votre clé n'est plus disponible (désactivée, supprimée ou accès supprimé) :
La publication sur le bus échoue avec une erreur d'accès KMS une fois que la clé de branche mise en cache expire, dans les 15 minutes.
La livraison de l'événement s'arrête au même moment, pour la même raison.
Les événements EventBridge déjà acceptés ne sont pas supprimés et les échecs de déchiffrement ne sont pas redirigés vers des files d'attente en lettres mortes. EventBridge réessaie de les essayer. Un échec d'accès par clé est une condition que vous pouvez corriger. Il faut donc mettre en EventBridge attente et réessayer les événements concernés plutôt que de les détourner. Aucun événement n'est perdu à moins que la panne ne dure plus longtemps que la période de rétention du bus.
Une fois l'accès rétabli, le traitement reprend automatiquement, tant que les événements restent dans les limites de la période de conservation du bus.
La suppression de votre clé est définitive. La désactivation d'une clé ou EventBridge la suppression de l'accès est réversible : restauration de l'accès et reprise du traitement. Supprimer la clé ne l'est pas. Après avoir AWS KMS supprimé la clé actuellement configurée sur un bus, EventBridge vous ne pouvez plus déballer la clé de branche du bus, et chaque événement encore stocké sur le bus devient définitivement illisible pendant le reste de sa période de conservation. Il est recommandé de désactiver d'abord la clé et de confirmer l'impact avant de planifier sa suppression. Consultez la section Suppression de AWS KMS clés dans le guide du AWS Key Management Service développeur.
La suppression d'un bus ne nécessite pas la clé. DeleteEventBusréussit même si la clé est désactivée ou supprimée.
Délimitation de l'accès à la clé KMS gérée par le client
Contexte de chiffrement. Chaque demande KMS EventBridge crée un bus d'événements inclut un contexte de chiffrement liant la demande à l'ARN de ce bus. Vous pouvez donc étendre chaque instruction à un seul bus, comme dans l'exemple de politique. La clé de contexte se trouve
aws:events:event-busv2:arnsur chaque demande, qu'elle soit faite avec vos informations d'identification ou en tant que principal du service.StringLikeÀ utiliser avec une queue/*, car l'ARN du bus se termine par un suffixe généré lors de sa création. Sur un bus existant, vous pouvez faire correspondre l'ARN exact à partirDescribeEventBusdeStringEquals.km :ViaService. Toutes les demandes effectuées avec vos informations d'identification renseignent la clé de
kms:ViaServicecondition avecevents.. Vous pouvez donc restreindre l'accès de vos principaux à l'utilisation des clés uniquement. EventBridgeregion.amazonaws.comPropagation des principaux changements de politique. Les opérations relatives à des événements individuels utilisent la clé de branche mise en cache et ne sont pas revalidées par rapport à votre politique clé par événement. Un changement de politique clé, y compris EventBridge la suppression de l'accès, prend effet pour le traitement des données d'un bus lorsque la clé de branche mise en cache expire, dans les 15 minutes.
Protection adjointe confuse. Les EventBridge demandes effectuées en tant que principal de service incluent le
aws:SourceArncontexte (l'ARN du bus) et leaws:SourceAccountcontexte. Vous pouvez donc ajouter ces conditions à laAllowEventBridgeServicePrincipaldéclaration. Ils garantissent que votre clé n'est EventBridge utilisée qu'au nom de vos propres ressources :"Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:events:us-east-1:111122223333:event-busv2/my-bus/*" } }
Surveillance de l'interaction du bus d'événements EventBridge personnalisé avec AWS KMS
EventBridgel'utilisation de votre clé gérée par le client apparaît dans AWS CloudTrail. Consultez la section Journalisation des appels d' AWS KMS API avec AWS CloudTrail. Événements à prévoir :
CloudTrail eventName |
Lorsque | Identité d'appel |
|---|---|---|
DescribeKey |
Validation create/update des clés de bus | Votre principal, via EventBridge |
Decrypt,Encrypt,GenerateDataKeyWithoutPlaintext, ReEncrypt (essai à sec) |
Contrôles d'autorisation sur le bus create/update, la publication, les abonnés create/update | Votre principal (via EventBridge) |
GenerateDataKeyWithoutPlaintext, ReEncrypt |
Branch-key création (création en bus) et rotation des clés de branche (~30 jours) | Principal de service events.amazonaws.com |
Decrypt |
Branch-key déballage à l'expiration du cache : envoi d'événements, chargement de la configuration de l'abonné, déchiffrement au moment de la description | Principal de service events.amazonaws.com |
Decrypt + Encrypt |
Branch-key remballage en cas de changement de UpdateEventBus clé |
Principal de service events.amazonaws.com |
CloudTrail enregistre l'appel ReEncrypt d'API comme un seul événement. Les kms:ReEncryptTo autorisations kms:ReEncryptFrom et de votre politique clé autorisent toutes deux cet appel.
Les contrôles d'autorisation sont des demandes d'exécution à sec de KMS. De par sa conception, une demande d'exécution à sec est renvoyée DryRunOperationException au lieu d'exécuter l'opération : cette réponse est la trace d'une vérification réussie, et non d'une erreur dans votre configuration. Une entrée enregistrée à sec indique AccessDeniedException plutôt que l'appelant n'a pas l'autorisation d'être vérifiée. Pour plus de détails, consultez la section Tester vos autorisations dans le guide du AWS Key Management Service développeur.
L'requestParameters.encryptionContextune de ces entrées est incluse dans aws:events:event-busv2:arn l'ARN de votre bus. Les entrées pour les opérations de clé de branche incluent également les métadonnées de clé de branche ajoutées par le keyring hiérarchique : (branch-key-idl'ARN du bus),,,type, create-time et. tablename hierarchy-version kms-arn
Le chiffrement et le déchiffrement des événements individuels utilisent des clés de données dérivées localement de la clé de branche mise en cache. Les opérations par événement n'apparaissent donc pas dans. CloudTrail Vous ne voyez que les opérations sur les touches de branche.