Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cifrado inactivo para Amazon EventBridge Custom Event Bus
Opciones de cifrado en reposo
Amazon EventBridge Custom Event Bus cifra todos los datos en reposo de forma predeterminada, del lado del servidor, antes de guardarlos en el almacenamiento: cargas útiles de eventos, metadatos de eventos, patrones de filtrado de suscriptores y configuraciones de objetivos de suscriptores. No necesita configurar nada, crear ninguna clave ni conceder ningún permiso para obtener el cifrado en reposo, y este cifrado predeterminado no conlleva ningún coste adicional.
De forma predeterminada, los datos se cifran mediante el estándar de cifrado avanzado (AES-256) de 256 bits y se utiliza una clave AWS propia, una clave de KMS que le EventBridge pertenece y administra por usted. No puede ver, administrar ni usar esta clave, y su uso no aparece en sus AWS CloudTrail registros. AWS las claves propias son gratuitas y no se descontarán de las AWS KMS cuotas de tu cuenta. AWS las claves propias se rotan automáticamente una vez al mes.
Para obtener más información, consulte AWS owned keys en la AWS Key Management Service Guía para desarrolladores de .
Si lo desea, puede optar por cifrar un bus de eventos con una clave KMS simétrica administrada por el cliente que usted cree, posea y administre. Una clave gestionada por el cliente le proporciona:
Control total sobre el ciclo de vida de las claves: política de claves, rotación, desactivación y eliminación.
CloudTrail visibilidad de cómo se EventBridge usa la clave.
La capacidad de limitar el acceso con las condiciones clave de la política de KMS, por bus de eventos.
Las claves administradas por el cliente están sujetas a AWS KMS cargos: una cuota mensual por la clave y cargos por las solicitudes a la API de KMS que se realicen a la misma. Estas solicitudes también se descontarán de las cuotas de AWS KMS solicitudes de su cuenta. Debido a que EventBridge cifra y descifra los eventos de forma local con una clave de rama almacenada en caché (consulteCómo utiliza Custom Event Bus una clave KMS gestionada por el cliente para el cifrado en reposo), su volumen de solicitudes de KMS es de unas cuantas llamadas por bus de eventos por ventana de caché más la rotación de claves; no crece con el volumen de eventos. Consulte los Precios de AWS Key Management Service
Cifrado de datos en reposo mediante claves KMS administradas por el cliente para un bus de eventos personalizado
Cómo utiliza Custom Event Bus una clave KMS gestionada por el cliente para el cifrado en reposo
Qué se cifra con su clave (por bus de eventos):
Cargas útiles y metadatos de eventos, almacenados durante el período de retención del autobús (de 1 a 365 días) en el almacenamiento de eventos del autobús y en el almacenamiento de entregas por suscriptor.
Los patrones de filtrado de los suscriptores y las configuraciones de destino se almacenan junto con la configuración del autobús.
Lo que no está cifrado con tu clave:
Identificadores de recursos EventBridge necesarios para el enrutamiento y la búsqueda: nombre del bus, ARN del bus, ID de cuenta.
El ID del grupo de mensajes, que solicita la entrega mediante FIFO. Evite colocar datos confidenciales en este campo.
El ID de deduplicación de mensajes. EventBridge lo almacena como un hash unidireccional.
Metadatos del servicio interno: resultados de las coincidencias de suscripciones, números de secuencia.
Estos elementos siguen cifrados en reposo mediante los servicios de almacenamiento subyacentes, no mediante su clave.
Cómo funciona el cifrado. Al configurar una clave gestionada por el cliente en un bus de eventos, EventBridge crea una clave de sucursal para ese bus. La clave de bifurcación es una clave intermedia. Se almacena en una tabla gestionada por el servicio, envuelta en la clave de KMS, siguiendo el conjunto de claves AWS Encryption SDK jerárquico. EventBridge utiliza la clave de sucursal para obtener las claves de cifrado de datos por evento. Por lo tanto, los eventos se cifran y descifran localmente, sin una llamada de KMS por evento:
Al publicar un evento, lo EventBridge cifra con la clave de rama del bus antes de grabarlo en el almacenamiento.
Cuando EventBridge entrega un evento, lo descifra para filtrarlo, evaluarlo y entregarlo.
EventBridge envía el evento descifrado a su objetivo. El cifrado en reposo en el destino es responsabilidad del servicio de destino.
La clave de sucursal se guarda en caché en la memoria de servicio durante un máximo de 15 minutos. Al caducar la caché, utiliza EventBridge tu
kms:Decryptclave para volver a empaquetar la clave de rama.EventBridge rota la clave de rama creando una nueva versión aproximadamente cada 30 días. Las versiones anteriores se conservan para que los eventos escritos anteriormente permanezcan legibles durante el período de retención del autobús.
Dos vías de acceso. EventBridge accede a su clave exactamente de dos maneras. Para las operaciones sincrónicas y las comprobaciones de autorización, utiliza tus credenciales, reenviadas desde tu llamada a la API. En el caso del trabajo asincrónico (entrega de eventos, ciclo de vida de la clave de sucursal), actúa como principal del events.amazonaws.com servicio, ya que la llamada a la API se ha completado y tus credenciales ya no están disponibles. Tu política clave rige ambas rutas, tal y como se describe a continuación.
Configuración de una clave KMS administrada por el cliente en un bus de eventos
Tipos de claves compatibles:
Solo claves de cifrado simétricas (
SYMMETRIC_DEFAULTuso de clavesENCRYPT_DECRYPT). Se rechazan las claves asimétricas y las claves HMAC.Multi-Region las claves se admiten como claves normales: utilice la réplica en la región del bus de eventos. EventBridge no replica sus datos ni su material clave en todas las regiones.
Se admiten claves con material clave importado y claves en un almacén de claves externo (XKS).
Identificador de clave. Especifique la clave por su clave ARN.
Configuración de permisos para usar una clave KMS administrada por el cliente
Su política clave necesita tres declaraciones para EventBridge Custom Event Bus. Sustituya los ejemplos de cuenta, región, función y nombre de autobús.
Un contexto de cifrado es un conjunto de pares clave-valor no secretos que se enlazan AWS KMS criptográficamente a una solicitud y que se pueden utilizar como condición para la autorización en las políticas de claves. Cada solicitud de EventBridge KMS para un bus de eventos incluye un contexto de cifrado que vincula la solicitud al ARN de ese bus, por lo que cada declaración siguiente puede tener el alcance de un solo bus. La clave de contexto es aws:events:event-busv2:arn y su valor es el ARN del bus, en cada solicitud EventBridge que realice, ya sea con sus credenciales o como principal del servicio. Limitar el acceso a la clave KMS administrada por el clientecubre el alcance con más detalle. Los valores finales del contexto de /* cifrado coinciden con el sufijo del ARN del bus, que EventBridge se genera en el momento de la creación (). 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/*" } } } ] }
Propósito de cada afirmación:
-
AllowKeyValidationThroughEventBridgepermite a los directores validar la clave al crear o actualizar un bus de eventos. EventBridgellamakms:DescribeKeycon sus credenciales para confirmar que la clave existe, es simétrica y está habilitada. LaDescribeKeyAPI no tiene ningún parámetro de contexto de cifrado. Por lo tanto, esta declaración no tiene ninguna condición de contexto de cifrado. Lakms:ViaServicecondición limita la concesión de esta declaración a las solicitudes que se reciban. EventBridge -
AllowKeyUseThroughEventBridgeautoriza las comprobaciones de acceso EventBridge realizadas con sus credenciales. EventBridge ejecuta estas comprobaciones antes de aceptar una configuración clave y antes de escribir o leer datos cifrados en su nombre. Por lo tanto, no puede configurar una clave posterior que EventBridge el procesamiento asíncrono no pueda utilizar. Las comprobaciones son simulaciones de KMS: autorizan pero no cifran ni descifran nada. Dry-run las solicitudes se facturan como solicitudes de la API de KMS estándar y se tienen en cuenta para las cuotas de solicitudes de KMS; consulte Probar los permisos en la AWS Key Management Service Guía para desarrolladores. Por operación:CreateEventBuscon cheques clave gestionados por el clientekms:GenerateDataKeyWithoutPlaintext,kms:ReEncryptFrom/kms:ReEncryptTo, ykms:Decrypt. Estas son las acciones que realizan la creación de claves ramificadas y las lecturas posteriores.Al cambiar una
UpdateEventBusclave,kms:Decryptse comprueban la clave actualkms:Encryptykms:Decryptla clave nueva. Estas son las acciones que realiza la transición clave.PutEvents/PutRawEventsen un autobús con llaves gestionadas por un clientekms:Decrypt. Una persona que llame y no pueda leer los eventos del autobús tampoco podrá escribirlos.CreateSubscriber/UpdateSubscribercompruebakms:Decrypt, porque la configuración del suscriptor está cifrada con la clave del bus.
Elegir los principios de esta declaración. Puede incluir los ARN de los roles o usuarios individuales en la cuenta
Principal, o utilizar el principal raíz de la cuenta para delegar este acceso a las políticas de IAM en su cuenta. -
AllowEventBridgeServicePrincipalautoriza la ejecución del trabajo como EventBridge servicio una vez finalizada la llamada a la API, cuando las credenciales ya no estén disponibles:kms:GenerateDataKeyWithoutPlaintextykms:ReEncryptFrom/kms:ReEncryptTo: EventBridge crea la clave de bifurcación del bus y crea nuevas versiones de la clave de bifurcación al rotar.kms:Decrypt: extrae EventBridge la clave de ramificación para enviar eventos, cargar la configuración del suscriptor y devolver la configuración descifrada al describir las llamadas.kms:Decryptykms:Encrypt: EventBridge vuelve a empaquetar la clave de bifurcación al cambiar la clave KMS del bus.
Esta sentencia utiliza la misma condición de contexto de cifrado que.
AllowKeyUseThroughEventBridgeCada solicitud EventBridge de un bus, en cualquiera de las rutas de acceso, se incluyeaws:events:event-busv2:arncon el ARN del bus, por lo que ambas sentencias vinculan el uso de la clave al bus de eventos específico.
Cross-account claves: la clave puede estar en una cuenta diferente a la del bus de eventos (por ejemplo, una cuenta de seguridad central). En ese caso, incluye las tres afirmaciones en la política de esa clave. Las Principal entradas de las dos primeras declaraciones indican las funciones de la cuenta de autobús. Los valores del contexto de cifrado nombran el ARN de bus de la cuenta de bus. Cross-account El acceso a KMS requiere permiso de ambas partes: además de las declaraciones de política clave anteriores, las funciones de la cuenta de bus necesitan políticas de identidad de IAM que permitan las mismas acciones de KMS en el ARN de la clave. Acceda a la clave mediante su ARN de clave completa.
Creación de un nuevo bus de eventos con una clave KMS gestionada por el cliente
Especifique la clave ARN en el EncryptionConfiguration parámetro de: CreateEventBus
{ "Name": "my-bus", "EncryptionConfiguration": { "KmsKeyIdentifier": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" } }
En el momento de la creación, EventBridge valida la clave y su acceso con sus credenciales (las DescribeKey comprobaciones preliminares anteriores). EventBridge a continuación, proporciona la clave de la sucursal del autobús de forma asíncrona, como principal de servicio. Si la declaración principal del servicio no figura en su política clave, el bus pasa a indicar el error de acceso al CREATE_FAILED KMS y DescribeEventBus devuelve un StateReason nombre con el nombre correspondiente.
DescribeEventBusen un autobús con una clave gestionada por el cliente, devuelve suEncryptionConfiguration. Un autobús que utiliza la clave AWS propia por defecto devuelve noEncryptionConfiguration: EventBridge nunca devuelve la AWS clave propia.
Cambiar la configuración de cifrado en un bus de eventos existente
Se admiten todas las transiciones mediante UpdateEventBus:
AWS clave propia → clave gestionada por el cliente
Clave gestionada por el cliente → clave gestionada por el cliente diferente
Clave gestionada por el cliente → AWS clave propia: send
EncryptionConfigurationpresent and empty ("EncryptionConfiguration": {}). Omitir el miembro por completo significa «dejar la configuración de cifrado sin cambios».
Cuando cambias la clave, entra UPDATING el autobús. EventBridge vuelve a colocar la clave de ramificación debajo de la nueva clave. Luego, el autobús regresa a. ACTIVE La clave de sucursal en sí misma no cambia, por lo que el material que protege sus datos no cambia. Solo cambia la clave de empaquetado. Consecuencias:
Los eventos escritos anteriormente permanecen legibles después de la transición, independientemente del estado de la clave anterior. Una vez que se complete la transición, puede deshabilitar la clave anterior inmediatamente sin perder el acceso a los eventos existentes.
Los nuevos eventos continúan con la misma clave de rama, ahora protegidos por la nueva clave KMS.
No se vuelven a cifrar los eventos almacenados, por lo que las transiciones se completan rápidamente y no dependen de la cantidad de datos que contenga el bus.
Rotación automática de clave KMS: si habilita la rotación automática de clave en su llave, KMS gira el material de soporte detrás del mismo ARN de clave. La rotación no afecta inmediatamente a la clave de bifurcación. La llave de rama permanece envuelta por el material que la envolvió en último lugar. La siguiente versión con llave de sucursal, que se crea aproximadamente cada 30 días, está protegida por el material de soporte actual. Por lo tanto, la KMS-side rotación tendrá efecto en su autobús en aproximadamente un mes.
Si tu clave deja de estar disponible (se deshabilita, se elimina o se elimina el acceso):
Se produce un error al publicar en el bus y se produce un error de acceso al KMS una vez que caduca la clave de rama almacenada en caché, en un plazo de 15 minutos.
La entrega del evento se detiene en el mismo punto y por el mismo motivo.
Los eventos EventBridge ya aceptados no se descartan y los errores de descifrado no se envían a colas de letra muerta. EventBridge Los vuelve a intentar. Un error en el acceso a la clave es una condición que se puede corregir, por lo que EventBridge retiene y vuelve a intentar los eventos afectados en lugar de desviarlos. No se pierde ningún evento a menos que la interrupción dure más que el período de retención del autobús.
Una vez restablecido el acceso, el procesamiento se reanudará automáticamente mientras los eventos permanezcan dentro del período de retención del autobús.
La eliminación de la clave es permanente. La desactivación de una clave o EventBridge la eliminación del acceso son reversibles: restaura el acceso y se reanuda el procesamiento. Eliminar la clave no lo es. Una vez AWS KMS eliminada la clave actualmente configurada en un bus, ya no EventBridge se puede desempaquetar la clave de bifurcación del autobús y todos los eventos que aún estén almacenados en el autobús pasan a ser ilegibles permanentemente durante el resto del período de retención. Como práctica recomendada, desactive primero la clave y confirme el impacto antes de programar su eliminación. Consulte Eliminar AWS KMS claves en la Guía para AWS Key Management Service desarrolladores.
Para eliminar un bus no es necesaria la clave. DeleteEventBustiene éxito incluso si la clave está desactivada o eliminada.
Limitar el acceso a la clave KMS administrada por el cliente
Contexto de cifrado. Cada solicitud de EventBridge KMS para un bus de eventos incluye un contexto de cifrado que vincula la solicitud al ARN de ese bus. De este modo, puede limitar cada declaración a un único bus, como en la política de ejemplo. La clave de contexto se encuentra
aws:events:event-busv2:arnen cada solicitud, ya sea que se haga con tus credenciales o como entidad principal del servicio.StringLikeUtilícelo con un final/*, ya que el ARN del bus termina en un sufijo generado en el momento de la creación. En un autobús existente, puede hacer coincidir el ARN exacto deDescribeEventBuscon.StringEqualskm:ViaService. Todas las solicitudes realizadas con sus credenciales rellenan la clave de
kms:ViaServicecondición conevents.. Por lo tanto, puede restringir el acceso de sus directores únicamente al uso de la clave. EventBridgeregion.amazonaws.comPropagación de cambios clave en las políticas. Las operaciones de eventos individuales utilizan la clave de rama almacenada en caché y no se vuelven a validar según tu política de claves por evento. Un cambio en la política de claves, incluida EventBridge la eliminación del acceso, se aplica a la gestión de datos de un autobús cuando la clave de rama almacenada en caché caduca, en un plazo de 15 minutos.
Protección policial confusa. Las EventBridge solicitudes realizadas como principal de servicio incluyen el
aws:SourceArncontexto (el ARN del bus) y elaws:SourceAccountcontexto. Por lo tanto, puede agregar estas condiciones a laAllowEventBridgeServicePrincipaldeclaración. Garantizan que EventBridge utilice su clave solo en nombre de sus propios recursos:"Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:events:us-east-1:111122223333:event-busv2/my-bus/*" } }
Supervisión de la interacción de EventBridge Custom Event Bus con AWS KMS
EventBridgeel uso que haga de la clave gestionada por el cliente aparece en AWS CloudTrail. Consulte Registrar llamadas a la AWS KMS API con AWS CloudTrail. Eventos esperables:
CloudTrail eventName |
Cuando | Identidad de llamada |
|---|---|---|
DescribeKey |
Validación de create/update la clave del autobús | Su director, a través de EventBridge |
Decrypt, EncryptGenerateDataKeyWithoutPlaintext, ReEncrypt (simulacro) |
Verificaciones de autorización en el autobús create/update, la publicación o el suscriptor create/update | Su director (vía EventBridge) |
GenerateDataKeyWithoutPlaintext, ReEncrypt |
Branch-key creación (creación de bus) y rotación de claves de sucursal (~30 días) | Entidad principal de servicio de events.amazonaws.com |
Decrypt |
Branch-key desempaquetar al caducar la caché: entrega del evento, carga de la configuración del suscriptor, descripción del tiempo de descifrado | Entidad principal de servicio de events.amazonaws.com |
Decrypt + Encrypt |
Branch-key volver UpdateEventBus a empaquetar al cambiar la clave |
Entidad principal de servicio de events.amazonaws.com |
CloudTrail registra la llamada a la ReEncrypt API como un evento. kms:ReEncryptFromTanto kms:ReEncryptTo los permisos como los de tu política de claves autorizan esa llamada.
Las comprobaciones de autorización son solicitudes de ejecución en seco de KMS. Por diseño, se devuelve una solicitud de ejecución en seco DryRunOperationException en lugar de realizar la operación: esa respuesta es el rastro de una comprobación aprobada, no un error en la configuración. AccessDeniedExceptionEn cambio, si se muestra una entrada en seco, significa que la persona que llama carece del permiso que se está comprobando. Para obtener más información, consulta Cómo probar tus permisos en la AWS Key Management Service Guía para desarrolladores.
Una requestParameters.encryptionContext de estas entradas se incluye aws:events:event-busv2:arn con el ARN de su autobús. Las entradas para las operaciones de clave de rama también incluyen los metadatos de clave de rama agregados por el anillo de claves jerárquico: (branch-key-idel ARN del bus),,, y. type create-time tablename hierarchy-version kms-arn
El cifrado y el descifrado de eventos individuales utilizan claves de datos derivadas localmente de la clave de rama almacenada en caché. Por lo tanto, las operaciones por evento no aparecen en. CloudTrail Solo se ven las operaciones clave de rama.