イベントの公開のためのエンドポイントの設定

イベント公開を有効化 Sterling Intelligent Promising するには、クラウドストレージプロバイダーのエンドポイントを構成する必要があります。

始める前に

Webhookについては、Webhookの概念に関するドキュメントを確認し、OAuth 2.0 認証を使用するWebサーバーをプロビジョニング済みであることを確認してください。また、WebhookとOAuthサーバーの詳細情報を保持していることを確認してください。 プロビジョニング中はサーバーをオンラインにしておく必要があります。 Google Cloud ストレージ、 Azure Blobストレージ、およびAmazon Webサービスについては、提供されている概念ドキュメントリソースを参照してください。

手順1および手順2に従って IBM Cloud® Object Storage
  1. IBM Cloud Object Storage バケットを用意します。 詳細については、を参照してください はじめに IBM Cloud Object Storage

    IBM Cloud Object Storage バケットには、1つのデータタイプのみを割り当てます。

  2. ファイル転送アダプタに提供するために、 IBM Cloud Object Storage バケットに関する以下のプロビジョニング情報を収集します
    • サービスインスタンス用のエンドポイント URL を提供してください。 詳細については、 エンドポイントと保存場所を参照してください。
    • IBM Cloud Object Storage 用のIAMキー。 詳細については、 IAMの概要を参照してください。
    • バケット名。

このタスクについて

イベント公開ルールは、イベントを処理するシステムをガイドし、イベントをどこに公開するかを決定します。 Publishエンドポイントの設定で、複数のストレージプロバイダーがサポートされるようになりました。 特定のストレージプロバイダーを選択する際には、そのストレージプロバイダーの設定詳細を提供する必要があります。

手順

  1. Order Hub にログインしてください。
  2. メニューから 「エンドポイント」 をクリックします。
  3. 「公開」タブを選択します。
    エンドポイントページは次の情報と共に開きます:
    表 1. エンドポイントページ
    フィールド名 説明
    エンティティー 公開イベントルールを設定するイベントの種類。
    • 任意のエンティティリンク をクリックすると、エンドポイントの詳細が表示されます。 エンティティリンクは、ルールの設定時にのみ利用可能です。 エンティティをソートするには、 エンティティの列にカーソルを合わせて、 ソートアイコンを選択します。
    説明 イベントタイプの説明。
    ファイル・タイプ エンドポイントでサポートされているファイルの種類、例えば、 Events ファイル。
    状況 エンドポイントの状態と設定されているかどうか。 エンティティは、アクティベートまたは構成されるまで、未構成の状態のままです。
    • 有効なオプションは 「構成済み」 または 「未構成」 です。
    アクション 設定済みのエンドポイントを編集するか、エンドポイントを設定します。 設定済みのエンドポイントを削除する。
    情報をソートするには、任意の列見出しを選択できます。
  4. 次のいずれかの手順を実行します。
    • エンドポイントを構成するには、 未構成状態にあるエンドポイントの編集アイコンをクリックします。
    • 公開イベントルールを設定するエンティティを選択してください。
  5. エンドポイントページでは、提供されている以下のエンドポイント構成情報を確認します:
    エンドポイント ID
    設定するエンドポイントに関連付けられたID。
    エンティティー
    公開イベントルールを設定するイベントの種類。
    説明
    イベントタイプの説明。
    ファイル・タイプ
    エンドポイントでサポートされているファイルの種類、例えば、 Events ファイル。
    状況
    エンドポイントの状態およびそれがアクティブか非アクティブか。
    エンドポイントを有効にするには、 ステ ータストグルを 「アクティブ」 にスライドしてください。
    失敗したイベントをスキップする (オプション)
    オプション: アプリケーションが定義されたエンドポイント内でトランザクションを完了できない場合、イベントは失敗します。 保持期間内の任意の時点で失敗したイベントを取得します。
    失敗したイベントをスキップするには、トグルをオンにスライドしてください。
  6. ストレージプロバイダー設定セクションで、クラウドストレージプロバイダーを設定するか、 ストレージプロバイダー のドロップダウンリストから割り当てデータを公開するWebhookを設定するには、以下のいずれかのオプションを選択してください。
    • Amazon S3
    • Microsoft Azure Blob Storage
    • Google Cloud Storage
    • Web フック
    • Amazon S3
      表 2. Amazon S3 ハッシュベースのメッセージ認証(HMAC)認証情報
      資格情報 説明
      HMAC アクセスキー バケットにアクセスするために使用されるアクセスキー。
      HMAC 秘密鍵 バケットにアクセスするために使用される秘密鍵。
      リージョン S3 サービスインスタンスに関連付けられているリージョン。
      エンドポイントURL インスタンス IBM Cloud Object Storage のエンドポイント URL エンドポイント URL は、バケットの場所と耐障害性に依存します。 詳細については、 Amazon Simple Storage Service のエンドポイントとクォータを参照してください。
      テーブル3。 Amazon S3 エクスポート場所の詳細
      エクスポート場所 説明
      バケット名 バケットの名前。
      オプション: プレフィックス オプション: バケット内の入力パブリッシュデータの保存場所のプレフィックス値。
    • IBM Cloud Object Storage
      テーブル4。 IBM Cloud Object Storage HMAC 認証情報
      HMAC 認証情報 説明
      アクセス・キー バケットにアクセスするために使用されるアクセスキー。
      秘密鍵 バケットにアクセスするために使用される秘密鍵。
      リージョン インスタンス IBM Cloud Object Storage に関連付けられている領域。
      エンドポイントURL インスタンス IBM Cloud Object Storage のエンドポイント URL エンドポイント URL は、バケットの場所と耐障害性に依存します。 詳細については、 エンドポイントと保存場所を参照してください。
      代わりに、HMAC認証情報の代わりに、以下の IBM Cloud Object Storage API認証情報を提供してください:
      テーブル5。 IBM Cloud Object Storage API認証情報
      資格情報 説明
      API キー IAM APIキーは、 Writer バケットへのアクセス権限を持っています。
      エンドポイントURL インスタンス IBM Cloud Object Storage のエンドポイント URL エンドポイント URL は、バケットの場所と耐障害性に依存します。 詳細については、 エンドポイントと保存場所を参照してください。
      テーブル6。 IBM Cloud Object Storage エクスポート場所の詳細
      エクスポート場所 説明
      バケット名 バケットの名前。
      接頭部 バケット内の入力パブリッシュデータの格納場所のプレフィックス値。
    • Microsoft Azure Blob Storage
      表 7. Microsoft Azure Blob Storage 認証情報
      認証 説明
      認証タイプ 以下のオプションのいずれかを選択し、必要な詳細情報を提供してください:
      • 共有キー(アクセスキー)
        • アカウント名: Azure Blob コンテナへのアクセスに使用される、 Azure ストレージ アカウントの名前。
        • アカウントキー: Azure Blob ストレージアカウントへのアクセスに使用されるアクセスキー。 Azure ストレージアカウントにアクセスするために使用されます。
      • Azure SAS資格
        • 署名: Azure Blob コンテナへのアクセスに使用される共有アクセス署名。
      エンドポイントURL Microsoft Azure Blob Storage インスタンスのエンドポイント URL。
      表 8. Microsoft Azure Blob Storage エクスポート場所の詳細
      エクスポート場所 説明
      コンテナー名 Azure Blob コンテナ名。
      オプション: Blobプレフィックス バケット内の入力パブリッシュデータの格納場所のプレフィックス値。
    • Google Cloud Storage
      表 9. Google Cloud Storage 構成の詳細
      Google クラウド認証情報 説明
      サービスアカウントキー(JSON) バケットにアクセスするために使用される秘密鍵。
      エンドポイントURL Google Cloud Storage インスタンスのエンドポイント URL。
      表 10. Google Cloud Storage エクスポート場所の詳細
      エクスポート場所 説明
      バケット名 バケットの名前。
      オプション: プレフィックス エクスポート公開データのバケット内における格納場所のプレフィックス値。
    • Webhook
      表 11. Webhook設定の詳細
      Webhookの設定 説明
      認証タイプ Webhook接続を認証するために使用されるセキュリティプロトコル。 現在、OAuth 2.0 がサポートされており、これにより安全なトークンベースの認証が保証されます。
      付与タイプ 選択した認証タイプに対してアクセストークンを取得するために使用される方法。 OAuth 2.0 では、 クライアント認証情報のグラントタイプが使用されます。
      表 12. Webhookエクスポートの保存場所の詳細
      エクスポート場所 説明
      Web フックの URL HTTPS タイプの URL で、ウェブフックイベントが投稿されるもの。
      イベントフォーマッタ イベントが配信されるフォーマット (JSON配列またはオブジェクトを含む)。 デフォルトのフォーマットは配列です。 詳細については、 新しいイベント配信形式を参照してください
      表 13. クライアント資格情報
      資格情報 説明
      トークンURL OAuth 2.0 トークンが利用可能な URL の HTTPS タイプ。
      クライアント ID OAuth 2.0 トークンサーバーのクライアント ID。
      クライアント・シークレット OAuth 2.0 トークンサーバーのクライアントシークレット。
  7. 「保存」をクリックします。
  8. 既存の構成のエンドポイント詳細を表示するには、 [公開] タブを選択し、[ 構成済み] ステータスを持つエンティティリンクのいずれかをクリックします。
    エンドポイントページには設定の詳細が表示されます。
  9. 設定を編集または削除します。
    • 設定情報を編集するには、 エンドポイントページ「編集」アイコン をクリックします。 エンドポイント構成の詳細を編集し 、[保存] をクリックします。

    アクティブなトグルを非アクティブに変更するためのトグルボタンがあります。 この変更によりイベントの公開は停止しますが、エンドポイントの設定は保存できます。

    • 設定を削除するには、[ エンドポイント] ページで削除アイコンをクリックします。 削除確認ダイアログで、 [削除] をクリックします。