View a markdown version of this page

Azioni, risorse e chiavi di condizione per il Custom Event Bus - Amazon EventBridge

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à.

Azioni, risorse e chiavi di condizione per il Custom Event Bus

Usa questa pagina quando scrivi una policy IAM. Elenca tutte le events: azioni per il Custom Event Bus, l'ARN della risorsa rispetto a cui ciascuna viene confrontata, se può essere concessa a un altro account e le chiavi di condizione che è possibile aggiungere. Ad esempio, puoi limitare un ruolo agli abbonati il cui METADATA filtro corrisponde tenant a acme alone. Per farlo, concedi events:CreateSubscriber e sali events:UpdateSubscriber sul bus con Null e a ForAllValues:StringEquals determinate condizioni. events:Metadata/tenant

Chiavi di condizione

EventBridge fornisce le seguenti chiavi di condizione contenute nella richiesta, in modo da poter restringere la concessione oltre l'azione e la risorsa. Per le chiavi di condizione globali, consulta le chiavi di contesto delle condizioni AWS globali nella Guida per l'utente IAM.

Chiave di condizioneValoreFornito su
events:sourceL'origine dell'evento o la fonte che viene inoltrataPutEvents, CreateEventSource, UpdateEventSource
events:detail-typeIl tipo di dettaglio dell'eventoPutEvents
events:eventBusInvocationtrueper un evento inoltrato, false per una pubblicazione direttaPutEvents, PutRawEvents
events:SystemMetadata/ContentTypeIl tipo di contenuto nei metadati di sistema dell'eventoPutRawEventse PutEvents per un evento inoltrato
events:SystemMetadata/AwsSourceL'origine di un evento inoltratoPutEvents,PutRawEvents, solo per un evento inoltrato
events:SystemMetadata/AwsDetailTypeIl tipo di dettaglio di un evento inoltratoPutEvents,PutRawEvents, solo per un evento inoltrato
events:Metadata/keySìPutRawEvents, il valore di quella chiave di metadati sull'evento. Sulle azioni dell'abbonato, i valori che un METADATA filtro corrisponde su quella chiavePutRawEvents, CreateSubscriber, UpdateSubscriber
events:Metadata/key/MatcherexactCreateSubscriber, UpdateSubscriber
events:ContentFilterPresenttruequando la configurazione del filtro dichiara un DATA filtro, altrimenti falseCreateSubscriber, UpdateSubscriber
events:PolicyNameLa politica delle risorse su cui agisce la richiesta, oppure default AWS_RAMPutResourcePolicy, GetResourcePolicy, DeleteResourcePolicy
aws:ResourceTag/keyUn tag sul bus, sull'abbonato o sulla fonte dell'evento da controllareOgni azione è stata verificata rispetto a una risorsa
aws:RequestTag/keyIl valore di quel tag nella richiestaLe operazioni di creazione e TagResource
aws:TagKeysLe chiavi del tag nella richiestaLe operazioni di TagResource creazione e UntagResource

Un evento inoltrato è un evento che una regola o un abbonato invia al bus, nell'ambito di un ruolo specificato dall'utente. EventBridge lo controlla con events:eventBusInvocation set totrue; vedi. Eventi che arrivano senza una chiamata di pubblicazione Un AWS servizio inoltrato o un evento partner viene contrassegnato comePutEvents, a meno che non sia stato trasformato da un abbonato. Un abbonato trasforma un evento quando è o. Transformer.Type WITH_METADATA JSONATA Un evento inoltrato controllato come PutEvents carry events:source e events:detail-type con l'origine e il tipo di dettaglio dell'evento. Qualsiasi altro evento inoltrato viene controllato come. PutRawEvents In ogni caso, events:SystemMetadata/AwsDetailType mantieni la fonte events:SystemMetadata/AwsSource e il tipo di dettaglio dell'evento. Entrambe le chiavi sono assenti quando l'evento non ha una fonte o un tipo di dettaglio o quando un abbonato lo ha trasformato. Quindi un'Denyistruzione che verifica il valore di una di queste chiavi non si applica a un evento a cui manca la chiave.

OnPutRawEvents, events:Metadata/key contiene un solo valore: il valore dell'evento per quella chiave di metadati. On CreateSubscriber andUpdateSubscriber, contiene tutti i valori a cui il METADATA filtro corrisponde su quella chiave. Un filtro può corrispondere a diversi valori, quindi abbina la chiave a un operatore impostato. ForAllValues:StringEqualscorrisponde solo quando ogni valore è uno dei valori elencati. ForAnyValue:StringEqualscorrisponde quando uno qualsiasi dei valori è quello che elenchi, quindi consente anche un filtro che aggiunge altri valori. ForAllValuescorrisponde anche quando il filtro non nomina la chiave, quindi aggiungi una Null condizione per richiedere la chiave. METADATAi filtri corrispondono solo alla corrispondenza esatta, motivo per cui il valore matcher è sempre. exact Un DATA filtro corrisponde a un codice JSON arbitrario, quindi viene esposta solo la sua presenza, non il suo contenuto. Un SYSTEM_METADATA filtro non fornisce alcuna chiave di condizione.

UpdateSubscriberfornisce le tre chiavi di filtro solo quando la richiesta ne include unaFilterConfiguration, anche una che lascia il filtro invariato. Tale richiesta viene inoltre verificata events:UpdateSubscriber rispetto al bus. Una condizione contenuta in una dichiarazione che events:CreateSubscriber prevede solo la concessione non si applica a tale controllo. Quindi applica le stesse condizioni. events:UpdateSubscriber A FilterConfiguration of {} rimuove ogni filtro. Fornisce events:ContentFilterPresent come false e senza chiavi di metadati, quindi una Null condizione su una chiave di metadati lo nega.

Quando una UpdateEventSource richiesta include unConfiguration, verifica EventBridge anche la compatibilità con il busevents:UpdateEventSource. Viene impostato events:source da quella configurazione. Quindi imposta anche le condizioni che hai impostato. events:CreateEventSource events:UpdateEventSource Una condizione attiva regola events:source quindi una fonte di evento reindirizzata così come una nuova.

Si usa events:PolicyName per limitare un principale a una delle due politiche di gestione delle risorse del bus; vedere. Scrivi una politica personalizzata in materia di risorse La chiave contiene il nome della politica su cui agisce la richiesta. Quando ometti PolicyName nella tua richiesta, la richiesta agisce e la chiave èdefault. default AWS Resource Access Manager (AWS RAM) scrive la AWS_RAM politica con le credenziali del principale che modifica una condivisione di risorse. EventBridge controlla che scrivano comeevents:PutResourcePolicy, con la chiave impostata su. AWS_RAM Quindi un preside a cui ti limiti default non può condividere l'autobus AWS RAM. ListResourcePoliciesriporta su entrambe le politiche, quindi non fornisce questa chiave. Quindi una StringEquals condizione su questa chiave non corrisponde maiListResourcePolicies. Consenti quell'azione in una dichiarazione senza quella condizione.

La seguente politica in materia di risorse consente all'account di 444455556666 creare abbonati sul orders bus e modificarne i filtri. Consente entrambi solo quando il METADATA filtro dell'abbonato corrisponde tenant esattamente a. acme Un abbonato senza METADATA filtro o con un filtro che nomina qualsiasi tenant diverso daacme, viene negato. EventBridge fornisce una chiave di condizione dei metadati solo per i campi dichiarati da un filtro. Quindi la Null condizione è ciò che nega un filtro che omette. tenant Le condizioni limitano solo la concessione di questa dichiarazione. Se anche un'altra dichiarazione, o un' AWS RAM azione, consente events:CreateSubscriber l'utilizzo di quell'account, le condizioni non limitano tale concessione.

{ "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" } } } ] }

Le azioni e le risorse in base alle quali vengono confrontate

La tabella seguente elenca ogni azione, l'ARN della risorsa da inserire nell'Resourceelemento della policy e se il proprietario del bus può concedere l'azione a un altro account tramite una policy di risorse o una AWS RAM condivisione. Le tre List azioni non vengono confrontate con "Resource": "*" alcuna risorsa, quindi concedile.

Azione IAMControllato rispetto aConcedibile a un altro account
events:CreateEventBusIl bus in fase di creazioneNo Creato nell'account personale del chiamante
events:DescribeEventBusL'autobusSì
events:UpdateEventBusL'autobusNo Solo il proprietario dell'autobus
events:DeleteEventBusL'autobusNo Solo il proprietario dell'autobus
events:ListEventBusesNiente Account-wideNo. Elenca i bus propri e condivisi del chiamante
events:PutEventsL'autobus, una volta per ingresso nella richiestaSì
events:PutRawEventsL'autobus, una volta per ingresso nella richiestaSì
events:CreateSubscriberIl bus e l'abbonato in fase di creazioneSì
events:DescribeSubscriberL'abbonatoIl proprietario dell'abbonato lo autorizza
events:UpdateSubscriberL'abbonato e il bus quando la richiesta include un FilterConfigurationSì, per il controllo dell'autobus
events:DeleteSubscriberL'abbonatoIl proprietario dell'abbonato lo autorizza
events:ListSubscribersNulla. Account-wideNo. Elenca gli abbonati del chiamante
events:RevokeResourceL'autobusNo Solo il proprietario dell'autobus
events:CreateEventSourceIl bus e la fonte dell'evento in fase di creazioneSì
events:DescribeEventSourceLa fonte dell'eventoIl proprietario della fonte dell'evento lo autorizza
events:UpdateEventSourceL'origine dell'evento e il bus quando la richiesta include un ConfigurationSì, per il controllo dell'autobus
events:DeleteEventSourceLa fonte dell'eventoIl proprietario della fonte dell'evento lo autorizza
events:ListEventSourcesNiente. Account-wideNo. Elenca le fonti di eventi proprie del chiamante
events:PutResourcePolicyL'autobusNo Solo il proprietario dell'autobus
events:GetResourcePolicyL'autobusNo Solo il proprietario dell'autobus
events:DeleteResourcePolicyL'autobusNo Solo il proprietario dell'autobus
events:ListResourcePoliciesL'autobusNo Solo il proprietario dell'autobus
events:TagResourceIl bus, l'abbonato o la fonte dell'evento indicata nella richiestaNo. Solo il proprietario della risorsa
events:UntagResourceIl bus, il sottoscrittore o l'origine dell'evento indicata nella richiestaNo. Solo il proprietario della risorsa
events:ListTagsForResourceIl bus, il sottoscrittore o l'origine dell'evento indicata nella richiestaNo. Solo il proprietario della risorsa

Per creare un abbonato o una fonte di eventi su un bus, il chiamante ha bisogno dell'azione sul bus e sulla nuova risorsa. Questo è ciò che consente al proprietario di un autobus di decidere, nella politica dell'autobus stesso, quali account possono allegare qualcosa all'autobus. CreateSubscribereffettua quattro controlli di autorizzazione distinti e tutti e quattro devono consentire: events:CreateSubscriber events:CreateSubscriber sul bus, sull'abbonato, iam:PassRole sul ruolo svolto e events:TagResource sull'abbonato quando la richiesta contiene tag. InvokeConfiguration.RoleArn CreateEventSourceesegue gli stessi controlli senzaiam:PassRole, perché una fonte di eventi non ha alcun ruolo. UpdateSubscribercontrolla anche events:UpdateSubscriber sul bus quando la richiesta include unFilterConfiguration. Verifica anche iam:PassRole il ruolo in InvokeConfiguration.RoleArn cui la richiesta ne include uno. Quindi un altro account deve essere events:CreateSubscriber pronto per collegare gli abbonati e aggiornare i loro filtri. events:UpdateSubscriber Le autorizzazioni AWS RAM gestite per allegare gli abbonati includono entrambe.

Nota

Una risorsa che non esiste ancora non ha un ARN completo, quindi un controllo di creazione utilizza un ARN che termina con un carattere jolly, ad esempio. arn:aws:events:us-east-1:111122223333:subscriber/name/* Una policy limitata a un sottoscrittore corrisponde quindi in base al nome e al prefisso, non esattamente. Una creazione senza tag fornisce un no aws:ResourceTag per la nuova risorsa, quindi una StringEquals condizione su quella chiave lo nega.

Esempi di policy basate su identità

Un produttore deve events:PutEvents utilizzare events:PutRawEvents l'ARN sul bus, o entrambi. Concedi l'azione che corrisponde all'API che chiama. Anche un produttore di un bus crittografato con una chiave gestita dal cliente deve accedere a quella chiave; vediCrittografia a riposo per Amazon EventBridge Custom Event Bus. Il proprietario di un abbonato ha bisogno events:CreateSubscriber di informazioni sul bus e sull'abbonato, iam:PassRole del ruolo di consegna e delle azioni di descrizione, aggiornamento ed eliminazione dell'abbonato sugli abbonati che gestisce. Per una UpdateSubscriber richiesta che include unFilterConfiguration, deve events:UpdateSubscriber essere effettuata anche sul bus. Un amministratore del bus necessita delle azioni di creazione, aggiornamento ed eliminazione del bus, delle quattro azioni relative alla politica delle risorse eevents:RevokeResource.

La seguente politica consente a un produttore di pubblicare su un bus con entrambe le API di pubblicazione e di leggere il bus in modo da confermare che il bus è il ACTIVE primo. La pubblicazione è autorizzata una volta per ogni immissione nella richiesta e non esiste un'autorizzazione parziale: se una voce non supera il controllo delle condizioni, EventBridge nega l'intera richiesta, comprese le voci che sarebbero state superate.

{ "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" } ] }

Assegnazione di tag

Puoi taggare un bus, un abbonato o una fonte di eventi. Imposta Tags sulla chiamata di creazione, o usa TagResourceUntagResource, e ListTagsForResource dopo. Ogni risorsa ha il proprio set di tag, quindi etichettare un bus non significa etichettare gli abbonati o le fonti di eventi ad esso collegate.

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

Una risposta di creazione non fa eco ai tag che hai fornito, quindi rileggili list-tags-for-resource quando devi confermarli. Le chiavi che iniziano con aws: sono riservate AWS e vengono rifiutate ad ogni scrittura, inclusaUntagResource. Per controllare chi può applicare i tag e per scrivere politiche che dipendono dai tag, utilizzate le tre azioni relative ai tag nella tabella precedente e i tasti aws:RequestTagaws:ResourceTag, e aws:TagKeys condition.