Amazon EventBridge での SaaS パートナーからのイベントの受信

SaaS パートナーアプリケーションおよびサービスからイベントを受信するには、そのパートナーからのパートナーイベントソースが必要です。パートナーイベントソースは、パートナーによって作成されたリソースで、イベントソースとして受け入れることができます。パートナーイベントソースを受け入れるには、カスタムイベントバスを作成し、対応するパートナーイベントソースに一致させることができます。

次のビデオでは、EventBridge と SaaS の統合について説明します。

トピック

• サポートされる SaaS パートナー統合

• SaaS パートナー統合のリージョン可用性

• SaaS 統合からイベントを受信するように Amazon EventBridge を設定する

• Amazon EventBridge の AWS Lambda 関数 URLsからの SaaS イベントの受信 EventBridge

• Amazon EventBridgeで Salesforce からイベントを受信する

サポートされる SaaS パートナー統合

EventBridge では、次の SaaS パートナー統合がサポートされています。

• Adobe

• Auth0

• Blitline

• Buildkite

• CleverTap

• Datadog

• Epsagon

• Freshworks

• Genesys

• GS2

• Karte

• Kloudless

• Mackerel

• MongoDB

• New Relic

• OneLogin

• Opsgenie

• PagerDuty

• Payshield

• SaaSus Platform

• SailPoint

• Saviynt

• Segment

• Shopify

• SignalFx

• Site24x7

• Stax

• Stripe

• SugarCRM

• SugarCRM

• Symantec

• Thundra

• TriggerMesh

• Whispir

• Zendesk

• [Amazon Seller Partner API] (Amazon セラーパートナー API)

SaaS パートナー統合のリージョン可用性

パートナーイベントソースは、次のリージョンで利用できます。

コード	名前
us-east-1	米国東部 (バージニア北部)
us-east-2	米国東部 (オハイオ)
us-west-1	米国西部 (北カリフォルニア)
us-west-2	米国西部 (オレゴン)
ca-central-1	カナダ (中部)
eu-central-1	欧州 (フランクフルト)
eu-central-2	欧州 (チューリッヒ)
eu-west-1	欧州 (アイルランド)
eu-west-2	欧州 (ロンドン)
eu-west-3	欧州 (パリ)
eu-north-1	欧州 (ストックホルム)
eu-south-1	欧州 (ミラノ)
eu-south-2	欧州 (スペイン)
af-south-1	アフリカ (ケープタウン)
ap-south-1	アジアパシフィック (ムンバイ)
ap-south-2	アジアパシフィック (ハイデラバード)
ap-east-1	アジアパシフィック (香港)
ap-northeast-1	アジアパシフィック (東京)
ap-northeast-2	アジアパシフィック (ソウル)
ap-northeast-3	アジアパシフィック (大阪)
ap-southeast-1	アジアパシフィック (シンガポール)
ap-southeast-2	アジアパシフィック (シドニー)
ap-southeast-3	アジアパシフィック (ジャカルタ)
ap-southeast-4	アジアパシフィック (メルボルン)
cn-north-1	中国 (北京)
cn-northwest-1	中国 (寧夏)
me-central-1	中東 (UAE)
me-south-1	中東 (バーレーン)
sa-east-1	南米 (サンパウロ）
il-central-1	イスラエル (テルアビブ)

SaaS 統合からイベントを受信するように Amazon EventBridge を設定する

パートナーイベントを受信するように EventBridge を設定する手順は、主に 2 つあります。

• パートナーイベントソースの作成

• そのパートナーソースをパートナーイベントバスに関連付ける

  注記

  パートナーがパートナーイベントソースに公開したイベントのうち、イベントバスに関連付けられていないものはすぐに削除されます。これらのイベントは、EventBridge に保管された状態では保持されません。

パートナーイベントソースを作成する (コンソールのみ）

1. Amazon EventBridge コンソールの https://console.aws.amazon.com/events/ を開いてください。

2. ナビゲーションペインで、[Partner event sources (パートナーイベントソース)] を選択します。

3. 目的のパートナーを見つけ、そのパートナーの [Set up] (設定) を選択します。

4. アカウント ID をクリップボードにコピーするには、 [Copy] (コピー) を選択します。

5. ナビゲーションペインで、[Partner event sources (パートナーイベントソース)] を選択します。

6. パートナーのウェブサイトにアクセスして手順に従い、アカウント ID を使用してパートナーイベントソースを作成します。作成したイベントソースは、アカウントでのみ使用できます。

パートナーソースをパートナーイベントバスに関連付ける (コンソール）

1. EventBridge コンソールで、ナビゲーションペインでパートナーイベントソースを選択します。

2. パートナーイベントソースの横にあるボタンを選択し、[Associate with event bus] (イベントバスと関連付ける) を選択します。

   そのイベントソースのステータスが Pending から Active に変わり、イベントバスの名前がパートナーイベントソース名と一致するように更新されます。これで、パートナーイベントソースからのイベントに一致するルールの作成を開始できます。

パートナーソースをパートナーイベントバスに関連付ける (AWS CLI）

• create-event-bus を使用して、パートナーイベントソースに関連付けられたパートナーイベントバスを作成します。

  name と の両方をパートナーイベントソース名に設定event-source-nameする必要があります。

  以下に例を示します。

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

  EventBridge がイベントバスを作成したら、 describe-event-sourceを呼び出してパートナーソースに関する詳細を返すことができます。パートナーソースStateの は である必要がありますACTIVE。

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

  注記

  パートナーイベントバスput-permissionで を呼び出すと、エラーが返されます。パートナーイベントバスに関連付けられたイベントソースのパートナーアカウントのみがイベントを送信できます。

パートナーソースをパートナーイベントバスに関連付ける (AWS CloudFormation）

1. パートナーイベントソースを使用して AWS::Events::EventBusリソースをプロビジョニングする AWS CloudFormation テンプレートを作成します。

   Name と の両方をパートナーイベントソース名に設定EventSourceNameする必要があります。以下に例を示します。

   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. cloudformation create-stack または AWS CloudFormation コンソールを使用して、テンプレートからスタックを作成します。以下に例を示します。

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

   注記

   テンプレートにパートナーイベントバスの AWS::Events::EventBusPolicyリソースを含めると、エラーが発生します。パートナーイベントバスに関連付けられたイベントソースのパートナーアカウントのみがイベントを送信できます。