EventBridge で API ターゲットの接続を作成 - Amazon EventBridge

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

EventBridge で API ターゲットの接続を作成

次のステップでは、HTTPS エンドポイントへの接続を作成する方法について説明します。

接続を定義

  1. [EventBridge コンソール] を開きます。

  2. 左側のナビゲーションペインの [統合] で、[接続] を選択します。

  3. [接続を作成] を選択します。

  4. [接続を作成] ページで、[接続名]、および [説明] を入力します。

呼び出しエンドポイントを設定

次に、[呼び出しを設定] セクションを使用して、接続で呼び出す API タイプを指定します。EventBridge 接続は、パブリック API とプライベート API をサポートしています。

  • [API タイプ] で、エンドポイントがパブリック API かプライベート API かを選択します。

    プライベート API を選択した場合は、接続に使用する VPC Lattice リソース設定を指定します。

    [プライベート API] の場合:

    • 既存の VPC Lattice リソース設定を使用するには、ドロップダウンメニューからリソース設定を選択します。

    • 新しい VPC Lattice リソース設定を作成するには、[新規リソース設定] を選択します。

      新しい設定を作成できる Amazon VPC Lattice サービスコンソールに移動します。詳細については、「Amazon VPC Lattice User Guide」の「Create a resource configuration」を参照してください。

エンドポイント認可を設定

次に、エンドポイントへのアクセスに使用する認可設定を指定します。

EventBridge は、ベーシック、OAuth クライアント認証情報、API キー認証方法をサポートしています。

  1. [認証を設定] で、接続するエンドポイントのタイプを選択します。

    Custom endpoint

    接続がパートナーエンドポイント以外のエンドポイントにある場合は、[カスタム設定] を選択します。

    1. [認証タイプ] で、使用する接続の認可方法を選択します。

    2. 選択した認可方法の認可設定の詳細を指定します。

      • ベーシック

        HTTPS エンドポイントで認可するために使用する [ユーザー名][パスワード] を入力します。

      • [OAuth クライアントの認証情報]

        1. [OAuth 認可エンドポイント] の場合、接続認可に使用するエンドポイントがパブリックエンドポイントかプライベートエンドポイントかを選択します。

          [プライベート] を選択した場合は、[プライベート OAuth エンドポイントリソース設定] を指定します。

          • 既存のリソース設定を使用するには、ドロップダウンメニューからリソース設定を選択します。

          • 新しいリソース設定を作成するには、[新規リソース設定] を選択します。

            新しい設定を作成できる Amazon VPC Lattice サービスコンソールに移動します。詳細については、「Amazon VPC Lattice User Guide」の「Create a resource configuration」を参照してください。

        2. 次の認可情報を指定します。

          • 認可エンドポイント

          • HTTP メソッド

          • クライアント ID

          • クライアントシークレット

        3. [OAuth Http パラメータ] で、認可エンドポイントでの認可に必要なパラメータがあれば追加します。

          そのためには、次の操作を行います。

          • ドロップダウンリストで [パラメータ] を選択します。

          • [キー][値] を入力します。

          追加のパラメータを含めるには、[パラメータの追加] を選択します。

      • API キー

        API キー認可に使用する [API キー名] とそれに対応する [値] を入力します。

    Partner endpoint

    パートナーエンドポイントへの接続の場合は、[パートナーテンプレートを使用] を選択します。利用可能なエンドポイントのリストについては、「API 送信先パートナー」を参照してください。

    1. [パートナーの送信先] から、接続先のパートナーを選択します。

      [認証タイプ] では、EventBridge はパートナーで使用できる認可方法を有効にします。

    2. [認証タイプ] で、使用する接続の認可方法を選択します。

    3. 選択した認可方法の認可設定の詳細を指定します。

      • ベーシック

        HTTP エンドポイントで認可するために使用する [ユーザー名][パスワード] を入力します。

      • [OAuth クライアントの認証情報]

        1. [OAuth 認可エンドポイント] では、接続認可に使用するエンドポイントがパブリックエンドポイントかプライベート (VPC) エンドポイントかを選択します。

          [プライベート] を選択した場合は、[プライベート OAuth エンドポイントリソース設定] を指定します。

          • 既存の VPC Lattice リソース設定を使用するには、ドロップダウンメニューからリソース設定を選択します。

          • 新しい VPC Lattice リソース設定を作成するには、[新規リソース設定] を選択します。

            新しい設定を作成できる Amazon VPC Lattice サービスコンソールに移動します。詳細については、「Amazon VPC Lattice User Guide」の「Create a resource configuration」を参照してください。

        2. 次の認可情報を指定します。

          • 認可エンドポイント

          • HTTPS メソッド

          • クライアント ID

          • クライアントシークレット

        3. [OAuth Http パラメータ] で、認可エンドポイントでの認可に必要なパラメータがあれば追加します。

          そのためには、次の操作を行います。

          • ドロップダウンリストで [パラメータ] を選択します。

          • [キー][値] を入力します。

          追加のパラメータを含めるには、[パラメータの追加] を選択します。

      • API キー

        API キー認可に使用する [API キー名] とそれに対応する [値] を入力します。

  2. [呼び出し Http パラメータ] で、認可リクエストに含めるパラメータを追加します。

    パラメータを追加するには:

    1. ドロップダウンリストで [パラメータ] を選択します。

    2. [キー][値] を入力します。

    追加のパラメータを含めるには、[パラメータの追加] を選択します。

暗号化を設定

最後に、EventBridge がシークレットとして保存する認可パラメータを暗号化および復号するときに使用する KMS キーのタイプを指定します AWS Secrets Manager。デフォルトでは、EventBridge は を使用します AWS 所有のキー。

詳細については、「接続の暗号化」を参照してください。

  1. 接続シークレットを暗号化するときに EventBridge 使用する KMS key の を選択します。

    • Use AWS 所有のキー for EventBridge を選択して、 を使用してシークレットを暗号化します AWS 所有のキー。

      これは、複数の AWS アカウントで使用するために KMS key EventBridge を所有および管理する AWS 所有のキー です。一般に、リソースを保護する暗号化キーを制御する必要がない限り、 AWS 所有のキー は良い選択です。

      これがデフォルトです。

    • Use カスタマー管理キー for EventBridge を選択して、指定または作成した を使用してシークレット カスタマー管理キー を暗号化します。

      カスタマーマネージドキー は、作成、所有、管理する AWS アカウント KMS keys にあります。ユーザーは、この KMS keysに関する完全なコントロール権を持ちます。

      1. 既存の を指定するか カスタマー管理キー、新規作成 KMS keyを選択します。

        EventBridge は、指定された に関連付けられているキーステータスとキーエイリアスを表示します カスタマー管理キー。

  2. [接続の作成] を選択します。

    注記

    プライベートエンドポイントの接続の場合、EventBridge は接続の作成時に必要なリソースの関連付けを作成します。これには最大 90 秒かかります。