Inventory service から Webhook へのイベントのパブリッシュ

Webhook にイベントをパブリッシュするには、以下の前提条件を満たす必要があります。

構成可能なイベントごとに、Web フック・エンドポイントのセットアップとイベント・サブスクリプションの構成を要求する以下の詳細を IBM® サポート Case に指定する必要があります。

  • Sterling Inventory Visibility テナント ID。
  • イベント名。
  • イベントURL
    Webhookイベントが投稿される URL URL URLでなければなりません）。
  • アクセURL
    oauth2 トークンが利用URL URL URL である必要があります）。
  • OAuth2 クライアント IDおよび OAuth2 クライアント秘密鍵
    Web フックを認証するための資格情報。
  • トークンの期間 (時間単位)。

IBM サポートから必要な情報についてのご返答には、約2週間かかります。

WebHooks の構成ガイドライン

以下のように、Webhook 構成ガイドラインに従う必要があります。
  • Webhook を実装する際は、グラントタイプ認証フロー Oauth2 client credentials を使用する必要があります。 OAuth2 リクエストの手順は、 「トークンの取得」 の手順と同じです
    。 唯一の違いは、 OAuth2 サーバーをホストするのはお客様で、 IBM はお客様が提供する認証情報を使用して、トークンリクエストをサーバーに送信します。
  • 両方のURLに対する SSL の証明書が、ルートCAによって署名されたものであることを確認してください。 デフォルトでは、 IBM は OpenJDK 11によって提供される証明書を信頼します。
  • IBMからのアウトバウンドコールでサポートされている HTTPSは443のみです。 IBMは、許可リスト作成のためのカスタムポート指定をサポートしていません。
  • IBM は mTLSをサポートしていません。
  • セキュリティー・ポリシーで着信 IBM Prerequisite Scannerの許可リスティングが必要な場合は、 IBM サポートに連絡して、 IBM Prerequisite Scanner 許可リストを入手してください。
  • Webhook 実装は、応答コードとして 200 を返す必要があります。
  • 認証および許可が失敗した場合、Webhook 実装では、 401401 または 403などの標準応答コードを生成する必要があります。
  • ゲートウェイ上の Webhook 構成では、ペイロードを収容するための十分なスペースを確保する必要があります (1 MB が参考になります)。
  • Web フックに対して生成されたアクセス・トークンは、少なくとも 1 時間は有効でなければならないことをお勧めします。