View a markdown version of this page

Aktionen, Ressourcen und Bedingungstasten für den Custom Event Bus - Amazon EventBridge

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktionen, Ressourcen und Bedingungstasten für den Custom Event Bus

Verwenden Sie diese Seite, wenn Sie eine IAM-Richtlinie schreiben. Es listet alle events: Aktionen für den Custom Event Bus auf, den Ressourcen-ARN, gegen den jede Aktion geprüft wird, ob ein anderes Konto gewährt werden kann und die Bedingungsschlüssel, die Sie hinzufügen können. Sie können eine Rolle beispielsweise auf Abonnenten beschränken, deren METADATA Filter auf „Nur“ tenant acme zutrifft. Um das zu tun, gewähren Sie events:CreateSubscriber und events:UpdateSubscriber im Bus mit Null und ForAllValues:StringEquals Bedingungen aufevents:Metadata/tenant.

Bedingungsschlüssel

EventBridge liefert die folgenden Bedingungsschlüssel aus der Anfrage, sodass Sie einen Grant über die Aktion und die Ressource hinaus eingrenzen können. Informationen zu den globalen Bedingungsschlüsseln finden Sie unter Kontextschlüssel für AWS globale Bedingungen im IAM-Benutzerhandbuch.

BedingungsschlüsselWertGeliefert am
events:sourceDie Quelle des Ereignisses oder die Quelle, die weitergeleitet wirdPutEvents, CreateEventSource, UpdateEventSource
events:detail-typeDer Detailtyp des EreignissesPutEvents
events:eventBusInvocationtruefür ein weitergeleitetes Ereignis, false für eine direkte VeröffentlichungPutEvents, PutRawEvents
events:SystemMetadata/ContentTypeDer Inhaltstyp in den Systemmetadaten des EreignissesPutRawEventsund PutEvents für ein weitergeleitetes Ereignis
events:SystemMetadata/AwsSourceDie Quelle eines weitergeleiteten EreignissesPutEvents,PutRawEvents, nur für ein weitergeleitetes Ereignis
events:SystemMetadata/AwsDetailTypeDer Detailtyp eines weitergeleiteten EreignissesPutEvents,PutRawEvents, nur für ein weitergeleitetes Ereignis
events:Metadata/keyOnPutRawEvents, der Wert des Metadatenschlüssels für das Ereignis. Bei den Abonnentenaktionen die Werte, denen ein METADATA Filter für diesen Schlüssel entsprichtPutRawEvents, CreateSubscriber, UpdateSubscriber
events:Metadata/key/MatcherexactCreateSubscriber, UpdateSubscriber
events:ContentFilterPresenttruewenn die Filterkonfiguration einen DATA Filter deklariert, andernfalls falseCreateSubscriber, UpdateSubscriber
events:PolicyNameDie Ressourcenrichtlinie, auf die die Anfrage angewendet wird, oder default AWS_RAMPutResourcePolicy, GetResourcePolicy, DeleteResourcePolicy
aws:ResourceTag/keyEin Tag auf dem Bus, Teilnehmer oder der Ereignisquelle, der überprüft wirdJede Aktion, die anhand einer Ressource geprüft wurde
aws:RequestTag/keyDer Wert dieses Tags in der AnfrageDie Erstellungsoperationen und TagResource
aws:TagKeysDie Tag-Schlüssel in der AnfrageDie ErstellungsoperationenTagResource, und UntagResource

Ein weitergeleitetes Ereignis ist ein Ereignis, das eine Regel oder ein Abonnent unter einer von Ihnen angegebenen Rolle an den Bus übermittelt. EventBridge überprüft es mit der events:eventBusInvocation Einstellung auftrue; sieheEreignisse, die ohne Aufforderung zur Veröffentlichung eintreffen. Ein AWS weitergeleiteter Service oder ein Partnerereignis wird als markiertPutEvents, sofern es nicht von einem Abonnenten transformiert wurde. Ein Abonnent transformiert ein Ereignis, wenn Transformer.Type es WITH_METADATA oder JSONATA ist. Ein weitergeleitetes Ereignis, PutEvents das als Übertragung markiert wurde events:source und events:detail-type die Quelle und den Detailtyp des Ereignisses enthält. Jedes andere weitergeleitete Ereignis wird als markiertPutRawEvents. So oder so, events:SystemMetadata/AwsSource und events:SystemMetadata/AwsDetailType behalten Sie die Quelle und den Detailtyp des Ereignisses bei. Beide Schlüssel fehlen, wenn das Ereignis keinen Quell- oder Detailtyp hat oder wenn ein Abonnent es transformiert hat. Eine Deny Aussage, die den Wert eines dieser Schlüssel testet, gilt also nicht für ein Ereignis, dem der Schlüssel fehlt.

On PutRawEvents events:Metadata/key enthält einen einzigen Wert: den Wert des Ereignisses für diesen Metadatenschlüssel. Bei CreateSubscriber und enthält jeden WertUpdateSubscriber, dem der METADATA Filter für diesen Schlüssel entspricht. Ein Filter kann mehreren Werten entsprechen, also ordnen Sie dem Schlüssel einen Mengenoperator zu. ForAllValues:StringEqualsentspricht nur, wenn es sich bei jedem Wert um einen Wert handelt, den Sie auflisten. ForAnyValue:StringEqualsentspricht, wenn es sich bei einem beliebigen Wert um einen von Ihnen aufgelisteten Wert handelt. Daher ist auch ein Filter möglich, der andere Werte hinzufügt. ForAllValuesentspricht auch dann, wenn der Filter den Schlüssel nicht benennt. Fügen Sie daher eine Null Bedingung hinzu, die den Schlüssel erfordert. METADATAFilter können nur exakt übereinstimmen, weshalb der Matcher-Wert immer gleich ist. exact Ein DATA Filter entspricht beliebigem JSON, sodass nur sein Vorhandensein offengelegt wird, nicht sein Inhalt. Ein SYSTEM_METADATA Filter liefert keinen Bedingungsschlüssel.

UpdateSubscriberliefert die drei Filterschlüssel nur, wenn die Anfrage einen enthältFilterConfiguration, und zwar auch dann, wenn der Filter unverändert bleibt. Diese Anfrage wird auch mit dem Bus verglichen. events:UpdateSubscriber Eine in einer Erklärung enthaltene Bedingung, dass nur Zuschüsse gewährt werden, gilt events:CreateSubscriber nicht für diesen Scheck. Stellen Sie also dieselben Bedingungen aufevents:UpdateSubscriber. A FilterConfiguration of {} entfernt jeden Filter. Es liefert events:ContentFilterPresent als false und keine Metadatenschlüssel, sodass eine Null Bedingung für einen Metadatenschlüssel dies verweigert.

Wenn eine UpdateEventSource Anfrage ein enthältConfiguration, wird EventBridge auch mit dem Bus events:UpdateEventSource abgeglichen. Es wird events:source von dieser Konfiguration aus festgelegt. Setzen Sie also auch die Bedingungen, die Sie festgelegt habenevents:UpdateEventSource, ein. events:CreateEventSource Eine Bedingung aktiviert gilt events:source dann sowohl für eine neu zugewiesene als auch für eine neue Ereignisquelle.

Wird verwendetevents:PolicyName, um einen Principal auf eine der beiden Ressourcenrichtlinien des Busses zu beschränken; siehe. Schreiben Sie eine benutzerdefinierte Ressourcenrichtlinie Der Schlüssel enthält den Namen der Richtlinie, auf die sich die Anforderung bezieht. Wenn Sie es PolicyName in Ihrer eigenen Anfrage weglassen, wird die Anfrage ausgeführtdefault, und der Schlüssel istdefault. AWS Resource Access Manager (AWS RAM) schreibt die AWS_RAM Richtlinie mit den Anmeldeinformationen des Prinzipals, der eine Ressourcenfreigabe ändert. EventBridge überprüft das Schreiben alsevents:PutResourcePolicy, wobei der Schlüssel auf gesetzt istAWS_RAM. Ein Principal, auf den Sie sich beschränken, default kann den Bus also nicht gemeinsam nutzen AWS RAM. ListResourcePoliciesberichtet über beide Richtlinien und liefert daher diesen Schlüssel nicht. Eine StringEquals Bedingung für diesen Schlüssel ist also nie erfülltListResourcePolicies. Erlaube diese Aktion in einer Anweisung ohne diese Bedingung.

Mit der folgenden Ressourcenrichtlinie können Konten Abonnenten auf dem orders Bus 444455556666 erstellen und deren Filter ändern. Beides ist nur zulässig, wenn der METADATA Filter des Abonnenten tenant genau dem entsprichtacme. Ein Abonnent ohne METADATA Filter oder mit einem Filter, der einen anderen Mandanten benennt alsacme, wird verweigert. EventBridge liefert einen Metadaten-Bedingungsschlüssel nur für die Felder, die ein Filter deklariert. Die Null Bedingung ist also, was einen Filter ablehnt, der auslässt. tenant Die Bedingungen beschränken nur die Gewährung dieser Erklärung. Wenn ein anderer Kontoauszug oder eine AWS RAM Aktie diese Rechnung events:CreateSubscriber ebenfalls vorsieht, schränken die Bedingungen diese Gewährung nicht ein.

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

Aktionen und die Ressourcen, anhand derer sie geprüft werden

In der folgenden Tabelle sind alle Aktionen aufgeführt, der Ressourcen-ARN, der in das Resource Element der Richtlinie eingefügt werden soll, und ob ein Busbesitzer die Aktion einem anderen Konto über eine Ressourcenrichtlinie oder eine AWS RAM Freigabe gewähren kann. Die drei List Aktionen werden mit keiner Ressource abgeglichen. Erteilen Sie sie also mit"Resource": "*".

IAM-AktionGeprüft gegenKann einem anderen Konto gewährt werden
events:CreateEventBusDer Bus wird erstelltNein. Erstellt im eigenen Konto des Anrufers
events:DescribeEventBusDer BusJa
events:UpdateEventBusDer BusNein. Nur für Busbesitzer
events:DeleteEventBusDer BusNein. Nur für Busbesitzer
events:ListEventBusesNichts. Account-wideNein. Listet die eigenen Busse und die gemeinsam genutzten Busse des Anrufers auf
events:PutEventsDer Bus, einmal pro Eintrag in der AnfrageJa
events:PutRawEventsDer Bus, einmal pro Eintrag in der AnfrageJa
events:CreateSubscriberDer Bus und der Abonnent, der gerade erstellt wirdJa
events:DescribeSubscriberDer AbonnentDer Besitzer des Abonnenten autorisiert es
events:UpdateSubscriberDer Abonnent und der Bus, wenn die Anfrage eine beinhaltet FilterConfigurationJa, für den Buscheck
events:DeleteSubscriberDer AbonnentDer Besitzer des Abonnenten autorisiert es
events:ListSubscribersNichts. Account-wideNein. Listet die eigenen Abonnenten des Anrufers auf
events:RevokeResourceDer BusNein. Nur für Busbesitzer
events:CreateEventSourceDer Bus und die Ereignisquelle, die gerade erstellt werdenJa
events:DescribeEventSourceDie EreignisquelleDer Eigentümer der Ereignisquelle autorisiert sie
events:UpdateEventSourceDie Ereignisquelle und der Bus, wenn die Anfrage eine enthält ConfigurationJa, für den Bus-Check
events:DeleteEventSourceDie Quelle des EreignissesDer Eigentümer der Ereignisquelle autorisiert sie
events:ListEventSourcesNichts. Account-wideNein. Listet die eigenen Ereignisquellen des Anrufers auf
events:PutResourcePolicyDer BusNein. Nur für Busbesitzer
events:GetResourcePolicyDer BusNein. Nur für Busbesitzer
events:DeleteResourcePolicyDer BusNein. Nur für Busbesitzer
events:ListResourcePoliciesDer BusNein. Nur für Busbesitzer
events:TagResourceDer Bus, der Teilnehmer oder die in der Anfrage angegebene EreignisquelleNein. Nur der Besitzer der Ressource
events:UntagResourceDer Bus, der Abonnent oder die in der Anfrage angegebene EreignisquelleNein. Nur der Besitzer der Ressource
events:ListTagsForResourceDer Bus, der Abonnent oder die in der Anfrage angegebene EreignisquelleNein. Nur der Besitzer der Ressource

Um einen Teilnehmer oder eine Ereignisquelle auf einem Bus zu erstellen, benötigt der Anrufer die Aktion sowohl auf dem Bus als auch auf der neuen Ressource. Auf diese Weise kann ein Busbesitzer in den eigenen Richtlinien des Busses entscheiden, welche Konten dem Bus irgendetwas zuordnen dürfen. CreateSubscriberführt vier separate Autorisierungsprüfungen durch, die alle vier zulassen müssen: events:CreateSubscriber auf dem Bus, events:CreateSubscriber auf dem Teilnehmer, iam:PassRole auf der Rolle in und events:TagResource auf dem AbonnentenInvokeConfiguration.RoleArn, wenn die Anfrage Tags enthält. CreateEventSourceführt dieselben Prüfungen auch ohne ausiam:PassRole, da eine Ereignisquelle keine Rolle spielt. UpdateSubscriberüberprüft auch events:UpdateSubscriber den Bus, wenn die Anfrage eine enthältFilterConfiguration. Es überprüft auch iam:PassRole die RolleInvokeConfiguration.RoleArn, wenn die Anfrage eine enthält. Sie benötigen events:CreateSubscriber also ein anderes Konto, um Abonnenten anzubinden und deren Filter zu aktualisieren. events:UpdateSubscriber Die AWS RAM verwalteten Berechtigungen für das Hinzufügen von Abonnenten beinhalten beides.

Anmerkung

Eine Ressource, die noch nicht existiert, hat keinen vollständigen ARN, daher verwendet eine Erstellungsprüfung einen ARN, der mit einem Platzhalter endet, z. B. arn:aws:events:us-east-1:111122223333:subscriber/name/* Eine Richtlinie, die auf einen Abonnenten beschränkt ist, entspricht daher nicht exakt dem Namenspräfix. Ein Create ohne Tags liefert Nein aws:ResourceTag für die neue Ressource, sodass eine StringEquals Bedingung für diesen Schlüssel dies verweigert.

Beispiele für identitätsbasierte Richtlinien in

Ein Produzent benötigt events:PutEventsevents:PutRawEvents, oder beides, auf dem Bus ARN. Gewähren Sie die Aktion, die der aufgerufenen API entspricht. Ein Hersteller, der an einen Bus angebunden ist, der mit einem vom Kunden verwalteten Schlüssel verschlüsselt wurde, benötigt ebenfalls Zugriff auf diesen Schlüssel; sieheVerschlüsselung im Ruhezustand für Amazon EventBridge Custom Event Bus. Ein Abonnentenbesitzer benötigt events:CreateSubscriber sowohl auf dem Bus als auch auf dem Abonnenten die Zustellungsrolle und die Aktionen zum Beschreiben, Aktualisieren und Löschen von Abonnenten für die von ihm verwalteten Abonnenten. iam:PassRole Für eine UpdateSubscriber Anfrage, die eine beinhaltetFilterConfiguration, muss sie auch events:UpdateSubscriber auf dem Bus sein. Ein Busadministrator benötigt die Aktionen zum Erstellen, Aktualisieren und Löschen von Bussen, die vier Ressourcenrichtlinien-Aktionen undevents:RevokeResource.

Die folgende Richtlinie ermöglicht es einem Producer, mit einer der beiden Publish-APIs auf einem Bus zu veröffentlichen und den Bus zu lesen, sodass er bestätigen kann, dass der Bus an ACTIVE erster Stelle steht. Die Veröffentlichung wird für jeden Eintrag in der Anfrage einmal autorisiert, und es gibt keine teilweise Autorisierung: Wenn ein Eintrag eine Zustandsprüfung nicht besteht, EventBridge wird die gesamte Anfrage abgelehnt, einschließlich der Einträge, die bestanden hätten.

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

Tagging

Sie können einen Bus, einen Teilnehmer oder eine Ereignisquelle taggen. Stellen Sie das Tags beim Erstellen eines Anrufs ein oder verwenden Sie TagResourceUntagResource, und ListTagsForResource danach. Jede Ressource hat ihren eigenen Tagsatz, sodass durch das Taggen eines Busses nicht die an ihn angeschlossenen Abonnenten oder Ereignisquellen markiert werden.

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

Bei einer Antwort auf das Erstellen werden die von Ihnen angegebenen Tags nicht wiedergegeben. Lesen Sie sie daher mit, list-tags-for-resource wenn Sie sie bestätigen müssen. Schlüssel, die mit beginnen, aws: sind für jeden Schreibvorgang reserviert AWS und werden bei jedem Schreibvorgang zurückgewiesen, einschließlichUntagResource. Verwenden Sie die drei Tag-Aktionen in der obigen Tabelle und die aws:TagKeys Bedingungstasten, und um Richtlinien zu erstellen aws:RequestTagaws:ResourceTag, die von Tags abhängen.