第7章 Hybrid Cloud Console と Webhook のインテグレーションの設定
ネイティブの Hybrid Cloud Console 統合が利用できないサードパーティーアプリケーションの場合は、Webhook インテグレーションタイプを使用して、選択したアプリケーションの Hybrid Cloud Console からイベント通知を受信できます。Webhook インテグレーションは、すべての Hybrid Cloud Console サービスからのイベントをサポートします。
サードパーティーアプリケーションは、Webhook を公開し、それを使用して受信イベントをリッスンすることで、受信データ要求を許可するように設定できます。Hybrid Cloud Console インテグレーションサービスは、この機能を使用して、各サービスからイベントと関連データを送信します。
これらのサードパーティーアプリケーションの Webhook エンドポイントに POST メッセージを送信するように、Hybrid Cloud Console 通知サービスを設定できます。たとえば、新しいアドバイザー推奨事項が見つかったときにトリガーされたイベントを自動的に転送するように Hybrid Cloud Console を設定できます。イベントとそのデータは、受信 Webhook エンドポイント上のサードパーティーアプリケーションに HTTP POST メッセージとして送信されます。
通知サービスでエンドポイントを設定した後、Hybrid Cloud Console イベントのストリームをサブスクライブし、選択した Webhook に、そのストリームを自動的に転送できます。各イベントには追加のメタデータが含まれており、運用ワークフローの一部としてイベントを処理する (たとえば、特定のアクションを実行したり、応答をトリガーしたりする) ために使用できます。アプリケーション内での実装とデータ処理を設定します。
サポートへの問い合わせ
Hybrid Cloud Console と Webhook のインテグレーションに問題がある場合は、Red Hat に連絡してサポートを依頼してください。Help (? アイコン)> Open a support case をクリックするか、? > Support options から他のオプションを表示し、Hybrid Cloud Console から直接 Red Hat サポートケースを開くことができます。
7.1. Hybrid Cloud Console と Webhook のインテグレーションの設定
ネイティブの Hybrid Cloud Console インテグレーションが利用できないサードパーティーアプリケーションの場合は、選択したアプリケーションで Hybrid Cloud Console からイベント通知を受信するように Webhook インテグレーションを設定します。
前提条件
- サードパーティーアプリケーションで Webhook が設定されている。
- Hybrid Cloud Console の Organization Administrator または Notifications administrator の権限がある。
手順
- Hybrid Cloud Console で、Settings > Integrations に移動します。
- Webhooks タブをクリックします。
- Add integration をクリックします。
- Integration name フィールドに、インテグレーションの名前を入力します。
- サードパーティーアプリケーションの Webhook URL を Endpoint URL フィールドに貼り付けます。
オプション: シークレットトークン が設定されている場合は入力します。
注記Secret トークンは、インテグレーションエンドポイントに送信されるデータを保護するために必要であり、Hybrid Cloud Console をサードパーティーアプリケーションと統合するときは常に使用する必要があります。
- Next をクリックします。
- インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。
- インテグレーションページを更新すると、Integration > Webhook リストに Webhook インテグレーションが表示されます。Last connection attempt のステータスが Ready になっている場合は、接続が Hybrid Cloud Console からの通知を受け入れることができることを示しています。
検証
アプリケーションが Hybrid Cloud Console に正しく接続されていることを確認するためのテスト通知を作成します。
- Integrations > Webhooks ページで統合の横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
- Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
- サードパーティーアプリケーションを開き、Hybrid Cloud Console から送信されたメッセージを確認します。
- Hybrid Cloud Console で Notifications > Event Log に移動し、Integration: Webhook イベントが緑色のラベルでリストされていることを確認します。
関連情報
- Notifications administrator パーミッションの設定に関する詳細は、通知ドキュメントの 通知を管理するためのユーザーアクセスの設定 を参照してください。
