View a markdown version of this page

Claves de acciones, recursos y condiciones del bus de eventos personalizado - Amazon EventBridge

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.

Claves de acciones, recursos y condiciones del bus de eventos personalizado

Utilice esta página cuando redacte una política de IAM. Enumera todas las events: acciones del bus de eventos personalizado, el ARN del recurso con el que se compara cada una de ellas, si se le puede conceder otra cuenta y las claves de condición que puede agregar. Por ejemplo, puedes limitar un rol a los suscriptores cuyo METADATA filtro coincida con el tenant de acme solo. Para ello, concede events:CreateSubscriber y sube events:UpdateSubscriber al autobús con Null las ForAllValues:StringEquals condiciones puestasevents:Metadata/tenant.

Claves de condición

EventBridge proporciona las siguientes claves condicionales de la solicitud, para que puedas limitar una concesión más allá de la acción y el recurso. Para ver las claves de condición globales, consulte las claves de contexto de condición AWS globales en la Guía del usuario de IAM.

Clave de condiciónValorSe suministra el
events:sourceLa fuente del evento o la fuente que se está reenviandoPutEvents, CreateEventSource, UpdateEventSource
events:detail-typeEl tipo de detalle del eventoPutEvents
events:eventBusInvocationtruepara un evento reenviado, false para una publicación directaPutEvents, PutRawEvents
events:SystemMetadata/ContentTypeEl tipo de contenido de los metadatos del sistema del eventoPutRawEvents, y PutEvents para un evento reenviado
events:SystemMetadata/AwsSourceEl origen de un evento reenviadoPutEvents,PutRawEvents, solo para un evento reenviado
events:SystemMetadata/AwsDetailTypeEl tipo de detalle de un evento reenviadoPutEvents,PutRawEvents, solo para un evento reenviado
events:Metadata/keySíPutRawEvents, el valor de esa clave de metadatos del evento. En cuanto a las acciones del suscriptor, los valores que coincide con un METADATA filtro en esa clavePutRawEvents, CreateSubscriber, UpdateSubscriber
events:Metadata/key/MatcherexactCreateSubscriber, UpdateSubscriber
events:ContentFilterPresenttruecuando la configuración del filtro declara un DATA filtro; de lo contrario falseCreateSubscriber, UpdateSubscriber
events:PolicyNameLa política de recursos sobre la que actúa la solicitud, default o AWS_RAMPutResourcePolicy, GetResourcePolicy, DeleteResourcePolicy
aws:ResourceTag/keyUna etiqueta en el autobús, el suscriptor o la fuente del evento que se está comprobandoCada acción se compara con un recurso
aws:RequestTag/keyEl valor de esa etiqueta en la solicitudLas operaciones de creación y TagResource
aws:TagKeysLas claves de etiqueta de la solicitudLas operaciones de creaciónTagResource, y UntagResource

Un evento reenviado es aquel que una regla o un suscriptor entrega al bus, en el marco de una función que usted haya asignado. EventBridge lo comprueba con el events:eventBusInvocation valor establecido entrue; consulteEventos que llegan sin una convocatoria de publicación. Un AWS servicio reenviado o un evento asociado se marca comoPutEvents, a menos que un suscriptor lo haya transformado. Un suscriptor transforma un evento cuando Transformer.Type es WITH_METADATA oJSONATA. Un evento reenviado se marca PutEvents como continuo events:source y events:detail-type con el origen y el tipo de detalle del evento. Cualquier otro evento reenviado se marca comoPutRawEvents. En cualquier caso, events:SystemMetadata/AwsSource events:SystemMetadata/AwsDetailType mantenga pulsada la fuente y el tipo de detalle del evento. Ambas claves están ausentes cuando el evento no tiene fuente ni tipo de detalle, o cuando un suscriptor lo ha transformado. Por lo tanto, una Deny afirmación que compruebe el valor de una de estas claves no se aplica a un evento que carezca de la clave.

events:Metadata/keyActivadoPutRawEvents, contiene un único valor: el valor del evento para esa clave de metadatos. Activado CreateSubscriber yUpdateSubscriber, contiene todos los valores con los que el METADATA filtro coincida en esa clave. Un filtro puede coincidir con varios valores, por lo que debe hacer coincidir la clave con un operador de conjunto. ForAllValues:StringEqualssolo coincide cuando todos los valores son uno de los que has enumerado. ForAnyValue:StringEqualscoincide cuando se incluye un valor en la lista, por lo que también permite un filtro que añada otros valores. ForAllValuestambién coincide cuando el filtro no asigna un nombre a la clave, así que añada una Null condición para requerir la clave. METADATAlos filtros solo coinciden exactamente, por lo que el valor del comparador es siempre. exact Un DATA filtro coincide con un JSON arbitrario, por lo que solo se expone su presencia, no su contenido. Un SYSTEM_METADATA filtro no proporciona ninguna clave de condición.

UpdateSubscriberproporciona las tres claves de filtro solo cuando la solicitud incluye unaFilterConfiguration, incluso una que deja el filtro sin cambios. Esa solicitud también se events:UpdateSubscriber compara con el autobús. Una condición de una declaración que diga que solo events:CreateSubscriber se concede no se aplica a ese cheque. Por lo tanto, ponga las mismas condicionesevents:UpdateSubscriber. A FilterConfiguration de {} elimina todos los filtros. Proporciona events:ContentFilterPresent claves de metadatos false iguales y ninguna, por lo que una Null condición en una clave de metadatos la deniega.

Cuando una UpdateEventSource solicitud incluye unaConfiguration, EventBridge también se events:UpdateEventSource compara con el bus. Se establece events:source a partir de esa configuración. Así que pon también las condiciones que events:UpdateEventSource establezcas. events:CreateEventSource Una condición activada events:source entonces rige tanto una fuente de eventos redireccionada como una nueva.

Se utiliza events:PolicyName para limitar un director a una de las dos políticas de recursos del autobús; consulte. Redacte una política de recursos personalizada La clave contiene el nombre de la política sobre la que actúa la solicitud. Si omites PolicyName en tu propia solicitud, la solicitud actúa en default consecuencia y la clave está default ahí. AWS Resource Access Manager (AWS RAM) escribe la AWS_RAM política con las credenciales del director que cambia un recurso compartido. EventBridge comprueba que escriben comoevents:PutResourcePolicy, con la clave puesta enAWS_RAM. Por lo tanto, un director al que limites default no puede compartir el autobús AWS RAM. ListResourcePoliciesinforma sobre ambas políticas, por lo que no proporciona esta clave. Por lo tanto, una StringEquals condición de esta clave nunca coincideListResourcePolicies. Permita esa acción en una declaración sin esa condición.

La siguiente política de recursos permite a las cuentas 444455556666 crear suscriptores en el orders autobús y cambiar sus filtros. Solo permite ambas opciones cuando el METADATA filtro del suscriptor coincide tenant exactamente conacme. Se deniega a un suscriptor sin METADATA filtro o con un filtro en el que se nombra a cualquier inquilino que no acme sea él. EventBridge proporciona una clave de condición de metadatos solo para los campos declarados por un filtro. Por lo tanto, la Null condición es la que deniega un filtro que omitetenant. Las condiciones restringen únicamente la concesión de esta declaración. Si otro estado de cuenta, o una AWS RAM acción, también permite events:CreateSubscriber la apertura de esa cuenta, las condiciones no restringen esa subvención.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "SubscribeToAcmeEventsOnly", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::444455556666:root" }, "Action": [ "events:CreateSubscriber", "events:UpdateSubscriber" ], "Resource": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef", "Condition": { "Null": { "events:Metadata/tenant": "false" }, "ForAllValues:StringEquals": { "events:Metadata/tenant": "acme" }, "StringEquals": { "events:Metadata/tenant/Matcher": "exact" } } } ] }

Las acciones y los recursos con los que se comparan

En la siguiente tabla se enumeran todas las acciones, el ARN del recurso que se debe incluir en el Resource elemento de la política y si el propietario de un autobús puede conceder la acción a otra cuenta mediante una política de recursos o un AWS RAM recurso compartido. Las tres List acciones no se comparan con ningún recurso, así que concédelas"Resource": "*".

Acción de IAMComprobadas conSe puede conceder a otra cuenta
events:CreateEventBusEl autobús que se está creando¡No!. Creado en la propia cuenta de la persona que llama
events:DescribeEventBus¿El autobúsSí
events:UpdateEventBus¿El autobús¡No!. Solo propietario del autobús
events:DeleteEventBus¿El autobús¡No!. Solo propietario del autobús
events:ListEventBusesNada. Account-wideNo. Muestra los autobuses propios y compartidos de la persona que llama
events:PutEventsEl autobús, una vez por entrada en la solicitudSí
events:PutRawEventsEl autobús, una vez por entrada en la solicitudSí
events:CreateSubscriberEl autobús y el suscriptor que se están creandoSí
events:DescribeSubscriberEl suscriptorEl propietario del suscriptor lo autoriza
events:UpdateSubscriberEl suscriptor y el autobús cuando la solicitud incluye un FilterConfigurationSí, para el control del autobús
events:DeleteSubscriber¿El suscriptorEl propietario del suscriptor lo autoriza
events:ListSubscribersNada. Account-wideNo. Enumera los suscriptores de la persona que llama
events:RevokeResource¿El autobús¡No!. Solo propietario del autobús
events:CreateEventSourceEl autobús y la fuente de eventos que se están creandoSí
events:DescribeEventSourceEl origen del eventoEl propietario de la fuente del evento lo autoriza
events:UpdateEventSourceLa fuente del evento y el autobús cuando la solicitud incluye un ConfigurationSí, para el control del autobús
events:DeleteEventSourceLa fuente del eventoEl propietario de la fuente del evento lo autoriza
events:ListEventSourcesNada. Account-wideNo. Muestra las fuentes de eventos propias de la persona que llama
events:PutResourcePolicy¿El autobús¡No!. Solo propietario del autobús
events:GetResourcePolicy¿El autobús¡No!. Solo propietario del autobús
events:DeleteResourcePolicy¿El autobús¡No!. Solo propietario del autobús
events:ListResourcePolicies¿El autobús¡No!. Solo propietario del autobús
events:TagResourceEl autobús, el suscriptor o la fuente del evento mencionada en la solicitudNo. Solo el propietario del recurso
events:UntagResourceEl bus, el suscriptor o la fuente del evento nombrada en la solicitudNo. Solo el propietario del recurso
events:ListTagsForResourceEl bus, el suscriptor o la fuente del evento nombrada en la solicitudNo. Solo el propietario del recurso

Para crear un suscriptor o una fuente de eventos en un autobús, la persona que llama necesita la acción tanto en el autobús como en el nuevo recurso. Esto es lo que permite al propietario de un autobús decidir, según la propia política del autobús, qué cuentas pueden estar vinculadas a él. CreateSubscriberrealiza cuatro comprobaciones de autorización distintas, y las cuatro deben permitir: events:CreateSubscriber en el autobús, events:CreateSubscriber en el suscriptorInvokeConfiguration.RoleArn, iam:PassRole en el puesto y events:TagResource en el suscriptor cuando la solicitud lleva etiquetas. CreateEventSourceejecuta las mismas comprobaciones sin ellasiam:PassRole, ya que la fuente de eventos no tiene ninguna función. UpdateSubscribertambién comprueba events:UpdateSubscriber el bus cuando la solicitud incluye unFilterConfiguration. También comprueba la iam:PassRole función InvokeConfiguration.RoleArn cuando la solicitud incluye una. Por lo tanto, otra cuenta necesita events:CreateSubscriber estar events:UpdateSubscriber en tu autobús para conectar suscriptores y actualizar sus filtros. Los permisos AWS RAM gestionados para adjuntar suscriptores incluyen ambos.

nota

Un recurso que aún no existe no tiene un ARN completo, por lo que una comprobación de creación utiliza un ARN que termina en un comodín, como. arn:aws:events:us-east-1:111122223333:subscriber/name/* Por lo tanto, una política dirigida a un suscriptor coincide con el prefijo del nombre, no exactamente. Una creación sin etiquetar proporciona un no aws:ResourceTag para el nuevo recurso, por lo que una StringEquals condición en esa clave lo niega.

Ejemplo de políticas basadas en identidad de

Un productor necesita events:PutEventsevents:PutRawEvents, o ambas cosas, en el autobús ARN. Otorgue la acción que coincida con la API a la que llama. El productor de un autobús cifrado con una clave gestionada por el cliente también necesita acceder a esa clave; consulteCifrado inactivo para Amazon EventBridge Custom Event Bus. El propietario de un suscriptor necesita events:CreateSubscriber en el autobús y en el suscriptor, iam:PassRole en el rol de repartidor, y las acciones de descripción, actualización y eliminación de suscriptores en los suscriptores que administra. Para una UpdateSubscriber solicitud que incluya unFilterConfiguration, también necesitará viajar events:UpdateSubscriber en el autobús. Un administrador de autobuses necesita crear, actualizar y eliminar las acciones del autobús, las cuatro acciones de política de recursos yevents:RevokeResource.

La siguiente política permite a un productor publicar en un bus con cualquiera de las API de publicación y leer el bus para confirmar que es el ACTIVE primero. La publicación se autoriza una vez por cada entrada de la solicitud y no hay autorización parcial: si una entrada no pasa una comprobación de estado, se EventBridge deniega toda la solicitud, incluidas las entradas que hubieran sido aprobadas.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "PublishToOrdersBus", "Effect": "Allow", "Action": [ "events:PutEvents", "events:PutRawEvents", "events:DescribeEventBus" ], "Resource": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef" } ] }

Etiquetado

Puede etiquetar un autobús, un suscriptor o una fuente de eventos. TagsActiva la opción de crear llamada, o usar TagResourceUntagResource, y ListTagsForResource después. Cada recurso tiene su propio conjunto de etiquetas, por lo que etiquetar un autobús no etiqueta a los suscriptores ni a las fuentes de eventos asociadas a él.

aws eventsv2 tag-resource \ --resource-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --tags team=payments,environment=production

Una respuesta de creación no refleja las etiquetas que has proporcionado, así que vuelve a leerlas list-tags-for-resource cuando necesites confirmarlas. Las claves que comienzan por aws: están reservadas AWS y se rechazan cada vez que se escribe, inclusoUntagResource. Para controlar quién puede etiquetar y escribir políticas que dependan de las etiquetas, utilice las tres acciones de etiquetado de la tabla anterior y las claves de aws:TagKeys condición aws:RequestTagaws:ResourceTag, y.