View a markdown version of this page

Partage d'un bus d'événements personnalisé avec d'autres comptes - Amazon EventBridge

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Partage d'un bus d'événements personnalisé avec d'autres comptes

Pour autoriser un autre compte à publier sur votre bus, y associer des abonnés ou y associer des sources d'événements, partagez le bus avec AWS Resource Access Manager (AWS RAM). Choisissez ensuite l'une des quatre autorisations gérées. Par exemple, partagez le orders bus en 444455556666 utilisant un compteAWSRAMEventBridgeEventBusV2SubscribeOnly, et ce compte pourra créer des abonnés. Écrivez plutôt une politique de ressources sur le bus lorsque vous avez besoin d'une clé expliciteDeny, d'une clé de condition ou d'une autorisation qu'aucune autorisation gérée n'exprime. L'autre compte doit toujours effectuer les mêmes actions dans ses propres politiques d'identité, car les deux parties doivent l'autoriser.

Conditions préalables au partage d'un bus

  • Vous connaissez les politiques basées sur l'identité et les ressources IAM, car le partage d'un bus nécessite des autorisations correspondantes à la fois sur le bus et sur l'identité du consommateur.

  • Vous devez être propriétaire du bus. Un compte client ne peut pas partager un bus en partance.

  • Pour partager avec les comptes de votre organisation sans invitation, activez le partage avec AWS Organizations in AWS RAM. Pour partager avec un compte extérieur à votre organisation, le compte doit accepter l'invitation de partage de ressources avant de pouvoir utiliser le bus.

  • Le bus et les abonnés du consommateur se trouvent dans la même région et sur la même partition. Un consommateur publie sur le bus et y crée des abonnés dans la région du bus.

Partage d'un bus

Nous vous AWS RAM recommandons de rédiger vous-même une politique de ressources. Avec AWS RAM, vous avez un seul endroit pour voir et révoquer ce que vous avez partagé. AWS RAM travaille également avec AWS Organizations et rédige pour vous la politique en matière de AWS_RAM ressources du bus. Créez un partage de ressources qui nomme l'ARN du bus, les comptes de consommateurs ou les unités organisationnelles, ainsi que l'une des quatre autorisations AWS gérées pour le type de ressource de bus, chacune àarn:aws:ram::aws:permission/name.

Le tableau suivant indique ce que le compte client peut faire avec chaque autorisation gérée.

Autorisation géréeCe que le compte consommateur peut faire

AWSRAMEventBridgeEventBusV2PublishOnly

Publier dans le bus et décrire le bus

AWSRAMEventBridgeEventBusV2SubscribeOnly

Associez des abonnés au bus, mettez à jour leurs filtres et décrivez le bus

AWSRAMEventBridgeEventBusV2EventSourceAccess

Joindre et mettre à jour les sources d'événements, et décrire le bus

AWSRAMEventBridgeEventBusV2FullAccess

Publiez avec l'une ou l'autre des API, décrivez le bus et créez, mettez à jour et supprimez ses propres abonnés et sources d'événements

aws ram create-resource-share \ --name orders-bus-share \ --resource-arns arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --principals 444455556666 \ --permission-arns arn:aws:ram::aws:permission/AWSRAMEventBridgeEventBusV2SubscribeOnly

Pour accorder une autorisation inférieure à une autorisation gérée ou pour ajouter une clé de condition, créez une autorisation gérée par AWS RAM le client. AWS RAM rejette celle qui nomme une action réservée au propriétaire du bus. Relisez une autorisation avec l' AWS RAM GetPermissionopération plutôt que de supposer sa liste d'actions exacte.

Annulation du partage d'un bus

Pour arrêter le partage, supprimez le bus ou le principal du partage de ressources, ou supprimez le partage. EventBridgeautorise un abonné ou une source d'événement lors de sa création, de sorte qu'un abonné créé par le consommateur alors que le partage était actif continue de livrer une fois que vous avez annulé le partage. Pour l'arrêter, révoquez-le avecRevokeResource. Pour plus d'informations sur la révocation d'un abonné ou d'une source d'événement, consultezRévocation d'un abonné ou d'une source d'événement. Le consommateur ne peut plus publier ni créer de nouveaux abonnés une fois le partage terminé.

Travailler avec un bus partagé avec vous

Un bus partagé avec votre compte apparaît dans vos ListEventBuses résultats avec le compte du propriétaire dans son ARN, et vous l'utilisez selon cet ARN, dans la région du bus. Ce que vous y créez vous appartient : lorsque vous listez les abonnés du bus partagé, vous ne voyez que vos propres abonnés, tandis que le propriétaire du bus les voit tous. Le partage d'un bus n'expose que celui-ci ; vous ne voyez jamais les autres bus du propriétaire. Vous ne pouvez pas mettre à jour ou supprimer le bus, modifier sa politique de ressources ou le partager ultérieurement, et vous ne pouvez pas agir sur un abonné détenu par un autre compte. Le propriétaire du bus peut retirer n'importe lequel de vos abonnés ou sources d'événements RevokeResource ; une ressource révoquée s'arrête définitivement et vous ne pouvez que la supprimer.

Facturation et mesures

Le partage d'un bus n'a aucun coût en soi. La publication, la livraison et la conservation sont facturées comme décrit sur la page de EventBridge tarification d'Amazon. Le propriétaire du bus peut voir le volume de livraison par compte client dans les EgressBytes indicateurs EventsDelivered et avec la SubscriberAccount dimension. Pour plus d'informations sur l'observabilité, consultezObservabilité pour le bus d'événements personnalisé : métriques, journaux et CloudTrail.

Rédiger une politique de ressources personnalisée

Un bus d'événements est la seule ressource de bus d'événements personnalisé qui adopte une politique de ressources ; il EventBridge rejette tout autre ARN de ressource. Un bus contient deux polices nommées. La default politique est celle que vous rédigez, dans le langage de politique IAM complet, y compris les Deny déclarations. AWS_RAMest écrit uniquement par AWS RAM et reflète vos partages de ressources.

EventBridge évalue à la fois lorsqu'il autorise un appelant depuis un autre compte, et qu'un « in » explicite remplace un Allow « Deny in » dans l'autre. Lorsqu'un appel intercomptes est refusé et que la politique que vous avez rédigée semble l'autoriser, lisez l'autre politique.

La default politique suivante sur le orders bus permet aux comptes de 444455556666 rattacher des abonnés et de lire le bus, et rien d'autre.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowPartnerAccountToSubscribe", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::444455556666:root" }, "Action": [ "events:CreateSubscriber", "events:DescribeEventBus" ], "Resource": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef" } ] }

Gérez les politiques avec PutResourcePolicyGetResourcePolicy,DeleteResourcePolicy, etListResourcePolicies. Chacun prend le bus ARN--resource-arn. Les trois premiers agissent default lorsque vous omettez--policy-name. Vous ne pouvez ni écrire ni supprimer AWS_RAM : le nommage échoueAccessDeniedException. GetResourcePolicyéchoue ResourceNotFoundException lorsque la politique nommée n'existe pas, plutôt que de renvoyer un document vide, alors considérez cela comme une absence de politique. Un bus que vous avez partagé uniquement via n' AWS RAM a aucune default politique, donc get-resource-policy sans --policy-name renvoie cette erreur ; passez --policy-name AWS_RAM pour lire la politique AWS RAM écrite. ListResourcePoliciesrenvoie uniquement les noms des politiques et les identifiants de révision, jamais les documents. Pour rendre une écriture ou une suppression conditionnelle, transmettez la révision actuelle de la politique --expected-revision-id ; en cas de non-concordance, l'opération échoue. ConflictException Un document default de stratégie peut peser jusqu'à 20 Ko ; une politique plus volumineuse échouePolicyLengthExceededException. Ce quota est ajustable dans Service Quotas.

EventBridge rejette une default politique qui accorderait un accès public, avecPublicPolicyException, et ne l'attache pas. Ce contrôle est toujours activé. Un relevé donne accès au public lorsque son principal est un joker et qu'aucune condition ne limite les appelants à des comptes ou à des principaux spécifiques. Une condition sur le contenu de l'événement, telle queevents:source, ne permet pas d'identifier l'appelant. Une condition comme le aws:PrincipalOrgID fait. Une politique que vous rédigez est invisible pour vous AWS RAM, c'est donc à vous de la suivre.

Événements qui arrivent sans appel de publication

Les événements arrivent également dans un bus sans direct PutEvents ni PutRawEvents appel : depuis une source d'événement, ou depuis une règle ou un abonné d'un autre bus dont la cible est ce bus. EventBridge autorise une source d'événement une seule fois, lorsque vous la créez. Il ne vérifie plus rien au fur et à mesure que les événements arrivent, de sorte qu'une politique de bus ne peut pas filtrer ce trafic par la suite. Pour plus d'informations sur les sources d'événements, consultezSources d'événements pour un bus événementiel personnalisé. Une règle ou un abonné que vous pointez vous-même vers un bus est autorisé lors de l'ingestion, selon le rôle que vous avez indiqué, une fois pour chaque événement. EventBridge choisit l'action par événement : events:PutEvents pour un véritable AWS service ou un événement partenaire, et events:PutRawEvents pour un événement dont vous êtes à l'origine. Vous ne pouvez pas choisir l'action à utiliser. Un redirecteur transportant les deux types d'événements sur un même chemin doit se voir accorder les deux actions, dans la politique d'identité du rôle et dans la politique de ressources du bus de destination. N'en accorder qu'un seul refuse la moitié du stream.