View a markdown version of this page

Recevoir des événements d'un partenaire SaaS avec Amazon EventBridge - 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.

Recevoir des événements d'un partenaire SaaS avec Amazon EventBridge

Pour recevoir des événements des applications et services partenaires SaaS, vous avez besoin d’une source d’événement partenaire provenant du partenaire. Une source d'événements partenaire est une ressource créée par un partenaire que vous pouvez ensuite accepter comme source d'événements. Pour accepter la source de l'événement partenaire, vous devez créer un bus d'événements personnalisé - Classic et le faire correspondre à la source de l'événement partenaire.

Note

Pour recevoir les événements des partenaires sur un bus d'événements personnalisé, créez une source d'événements qui désigne la source de l'événement partenaire comme origine ; l'intégration des partenaires sur cette page reste la même. Consultez Sources d'événements pour un bus événementiel personnalisé.

Un partenaire SaaS envoie un événement à une source d'événements partenaire, qui l'envoie au bus d'événements partenaire.

La vidéo suivante présente les intégrations SaaS avec EventBridge :

Intégrations de partenaires SaaS prises en charge

EventBridge prend en charge les intégrations de partenaires SaaS suivantes :

Configuration d'Amazon EventBridge pour recevoir des événements à partir d'une intégration SaaS

La configuration EventBridge pour recevoir les événements des partenaires comprend deux étapes principales :

  • Création de la source d'événements partenaires

  • Associer cette source partenaire à un bus événementiel partenaire

    Note

    Tout événement publié par un partenaire sur une source d’événements partenaire qui n’a pas été associé à un bus d’événements sera immédiatement supprimé. Ces événements ne se poursuivront pas dans EventBridge le calme.

Création d'une source d'événements pour les partenaires (console uniquement)
  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Partner event sources (Sources d'événements partenaires).

  3. Recherchez le partenaire de votre choix, puis choisissez Configurer pour ce partenaire.

  4. Pour copier votre ID de compte dans le presse-papiers, choisissez Copier.

  5. Dans le volet de navigation, choisissez Partner event sources (Sources d'événements partenaires).

  6. Accédez au site web du partenaire et suivez les instructions pour créer une source d’événement partenaire à l’aide de votre ID de compte. La source d’événement que vous créez est disponible uniquement pour votre compte.

Associer la source partenaire à un bus d'événements partenaire (console)
  1. Dans la EventBridge console, choisissez Sources d'événements partenaires dans le volet de navigation.

  2. Sélectionnez le bouton en regard de la source d’événement partenaire, puis choisissez Associer au bus d’événements.

    Le statut de la source d’événement passe de Pending à Active et le nom du bus d’événements est mis à jour pour correspondre au nom de la source d’événement partenaire. Vous pouvez désormais commencer à créer des règles qui correspondent à des événements de la source d’événement partenaire.

Associez la source partenaire à un bus événementiel partenaire (AWS CLI)
  • Permet create-event-bus de créer un bus d'événements partenaires associé à la source de l'événement partenaire.

    Les deux name event-source-name doivent être définis sur le nom de la source de l'événement partenaire.

    Par exemple :

    aws events create-event-bus \ --name "aws.partner/saas-integration/name" \ --event-source-name "aws.partner/saas-integration/name" \ --region us-east-1

    Après avoir EventBridge créé le bus de l'événement, vous pouvez appeler describe-event-source pour obtenir des informations sur la source partenaire. Le State nom de la source partenaire doit êtreACTIVE.

    aws events describe-event-source --name "aws.partner/saas-integration/name"
    Note

    L'appel put-permission à un bus événementiel partenaire renvoie un message d'erreur. Seul le compte partenaire de la source d'événements associée au bus d'événements partenaire est autorisé à lui envoyer des événements.

Associez la source partenaire à un bus événementiel partenaire (CloudFormation)
  1. Créez un CloudFormation modèle qui fournit une AWS::Events::EventBus ressource avec la source de l'événement partenaire.

    Les deux Name EventSourceName doivent être définis sur le nom de la source de l'événement partenaire. Par exemple :

    AWSTemplateFormatVersion: 2010-09-09 Description: Cloudformation template to create Event Bus for receiving partner events Resources: ExamplePartnerEventBus: Type: AWS::Events::EventBus Properties: EventSourceName: 'aws.partner/saas-integration/name' Name: 'aws.partner/saas-integration/name'
  2. Utilisez cloudformation create-stack ou la CloudFormation console pour créer une pile à partir du modèle. Par exemple :

    aws cloudformation create-stack --stack-name eventbridge-saas --template-body file://template.yml --region us-east-1
    Note

    L'inclusion d'une AWS::Events::EventBusPolicy ressource pour le bus de l'événement partenaire dans votre modèle entraînera une erreur. Seul le compte partenaire de la source d'événements associée au bus d'événements partenaire est autorisé à lui envoyer des événements.