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 condizione | Valore | Fornito su |
|---|---|---|
events:source | L'origine dell'evento o la fonte che viene inoltrata | PutEvents, CreateEventSource, UpdateEventSource |
events:detail-type | Il tipo di dettaglio dell'evento | PutEvents |
events:eventBusInvocation | trueper un evento inoltrato, false per una pubblicazione diretta | PutEvents, PutRawEvents |
events:SystemMetadata/ContentType | Il tipo di contenuto nei metadati di sistema dell'evento | PutRawEventse PutEvents per un evento inoltrato |
events:SystemMetadata/AwsSource | L'origine di un evento inoltrato | PutEvents,PutRawEvents, solo per un evento inoltrato |
events:SystemMetadata/AwsDetailType | Il tipo di dettaglio di un evento inoltrato | PutEvents,PutRawEvents, solo per un evento inoltrato |
events:Metadata/ | SìPutRawEvents, il valore di quella chiave di metadati sull'evento. Sulle azioni dell'abbonato, i valori che un METADATA filtro corrisponde su quella chiave | PutRawEvents, CreateSubscriber, UpdateSubscriber |
events:Metadata/ | exact | CreateSubscriber, UpdateSubscriber |
events:ContentFilterPresent | truequando la configurazione del filtro dichiara un DATA filtro, altrimenti false | CreateSubscriber, UpdateSubscriber |
events:PolicyName | La politica delle risorse su cui agisce la richiesta, oppure default AWS_RAM | PutResourcePolicy, GetResourcePolicy, DeleteResourcePolicy |
aws:ResourceTag/ | Un tag sul bus, sull'abbonato o sulla fonte dell'evento da controllare | Ogni azione è stata verificata rispetto a una risorsa |
aws:RequestTag/ | Il valore di quel tag nella richiesta | Le operazioni di creazione e TagResource |
aws:TagKeys | Le chiavi del tag nella richiesta | Le 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/ contiene un solo valore: il valore dell'evento per quella chiave di metadati. On keyCreateSubscriber 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 IAM | Controllato rispetto a | Concedibile a un altro account |
|---|---|---|
events:CreateEventBus | Il bus in fase di creazione | No Creato nell'account personale del chiamante |
events:DescribeEventBus | L'autobus | Sì |
events:UpdateEventBus | L'autobus | No Solo il proprietario dell'autobus |
events:DeleteEventBus | L'autobus | No Solo il proprietario dell'autobus |
events:ListEventBuses | Niente Account-wide | No. Elenca i bus propri e condivisi del chiamante |
events:PutEvents | L'autobus, una volta per ingresso nella richiesta | Sì |
events:PutRawEvents | L'autobus, una volta per ingresso nella richiesta | Sì |
events:CreateSubscriber | Il bus e l'abbonato in fase di creazione | Sì |
events:DescribeSubscriber | L'abbonato | Il proprietario dell'abbonato lo autorizza |
events:UpdateSubscriber | L'abbonato e il bus quando la richiesta include un FilterConfiguration | Sì, per il controllo dell'autobus |
events:DeleteSubscriber | L'abbonato | Il proprietario dell'abbonato lo autorizza |
events:ListSubscribers | Nulla. Account-wide | No. Elenca gli abbonati del chiamante |
events:RevokeResource | L'autobus | No Solo il proprietario dell'autobus |
events:CreateEventSource | Il bus e la fonte dell'evento in fase di creazione | Sì |
events:DescribeEventSource | La fonte dell'evento | Il proprietario della fonte dell'evento lo autorizza |
events:UpdateEventSource | L'origine dell'evento e il bus quando la richiesta include un Configuration | Sì, per il controllo dell'autobus |
events:DeleteEventSource | La fonte dell'evento | Il proprietario della fonte dell'evento lo autorizza |
events:ListEventSources | Niente. Account-wide | No. Elenca le fonti di eventi proprie del chiamante |
events:PutResourcePolicy | L'autobus | No Solo il proprietario dell'autobus |
events:GetResourcePolicy | L'autobus | No Solo il proprietario dell'autobus |
events:DeleteResourcePolicy | L'autobus | No Solo il proprietario dell'autobus |
events:ListResourcePolicies | L'autobus | No Solo il proprietario dell'autobus |
events:TagResource | Il bus, l'abbonato o la fonte dell'evento indicata nella richiesta | No. Solo il proprietario della risorsa |
events:UntagResource | Il bus, il sottoscrittore o l'origine dell'evento indicata nella richiesta | No. Solo il proprietario della risorsa |
events:ListTagsForResource | Il bus, il sottoscrittore o l'origine dell'evento indicata nella richiesta | No. 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.
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/ Una policy limitata a un sottoscrittore corrisponde quindi in base al nome e al prefisso, non esattamente. Una creazione senza tag fornisce un no name/*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.