第1章 Hybrid Cloud Console との通信アプリケーションの統合
Hybrid Cloud Console を Microsoft Teams、Google Chat、または Slack に接続して、任意の通信アプリケーションでイベント通知を受信します。
1.1. Microsoft Teams と Hybrid Cloud Console の統合 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Hybrid Cloud Console を設定して、Microsoft Teams の新規または既存のチャネルのすべてのユーザーにイベント通知を送信できます。この Microsoft Teams 統合は、Hybrid Cloud Console の全サービスからのイベントに対応しています。Microsoft Teams 統合では、受信 Webhook を使用してイベントデータを受信します。
サポートへの問い合わせ
Hybrid Cloud Console と Microsoft Team のインテグレーションに問題がある場合は、Red Hat に連絡してサポートを依頼してください。Help (? アイコン) > Open a support case をクリックするか、? > Support options から他のオプションを表示し、Hybrid Cloud Console から直接 Red Hat サポートケースを開くことができます。
Microsoft はトラブルシューティングを提供しません。Hybrid Cloud Console と Microsoft Teams の統合は、Red Hat によって完全にサポートされています。
1.1.1. Microsoft Teams での受信 Webhook の設定 リンクのコピーリンクがクリップボードにコピーされました!
Microsoft Teams で受信 Webhook を設定すると、Red Hat Hybrid Cloud Console からのイベント通知を Microsoft Teams チャネルで受信できます。
現在、Microsoft Teams 統合のワークフローでは、Adaptive Card 形式の受信 Webhook が使用されています。既存の Microsoft Teams 統合が Hybrid Cloud Console で設定されている場合は、2025 年末までに、このセクションで説明する新しいワークフローを使用して再設定する必要があります。受信 Webhook と Adaptive Cards の詳細は、Microsoft Teams ドキュメントの Create Incoming Webhooks を参照してください。
前提条件
- Microsoft チームの管理者権限がある。
- Hybrid Cloud Console の Organization Administrator または Notifications administrator の権限がある。
手順
- Microsoft Teams で、Workflows をクリックします。
- Create タブをクリックします。
- Create from blank ボタンをクリックして、カスタムワークフローを作成します。
トリガーを設定します。
- 検索バーに webhook と入力します。
- Triggers リストから、When a Teams webhook request is received トリガーを選択します。
- Who can trigger the flow で、ドロップダウンリストから Anyone を選択します。
- New step ボタンをクリックします。
アクションを設定します。
- Choose an operation の検索バーに card と入力します。
- Actions リストから、Post card in a chat or channel を選択します。
- Post as で、Flow bot が選択されていることを確認します。
- Post in で Channel を選択します。Channel を選択すると、さらに多くのオプションが表示されます。
- Team で、イベント通知を送信するチームを選択します。
- Channel で、イベント通知を送信するチャネルを選択します。
- Adaptive Card で、リストをクリックしてダイアログを開きます。ダイアログの Dynamic content で Adaptive Card を選択します。
- Save をクリックします。
Webhook URL をコピーします。
- トリガー領域 (When a Teams webhook request is received) をクリックして、情報を展開します。
- HTTP POST URL を構築して表示する必要がある場合は、画面を更新します。
- HTTP POST URL をコピーして、Hybrid Cloud Console で統合を設定します。
1.1.2. Red Hat Hybrid Cloud Console での Microsoft Teams 統合の設定 リンクのコピーリンクがクリップボードにコピーされました!
Microsoft Teams を Hybrid Cloud Console と統合するように設定したら、Microsoft Teams の受信 Webhook URL を Hybrid Cloud Console に追加して、Microsoft Teams で Red Hat サービスからのイベントに関する通知を受信できるようにします。
前提条件
Organization Administrator または Notifications administrator のパーミッションを持つユーザーとして Hybrid Cloud Console にログインしている。
注記メールアドレスが Red Hat ログインと同じでない場合、メールアドレスで Hybrid Cloud Console にログインすることはできません。詳細は、ログインの検索 を参照してください。
- Microsoft チームからの受信 Webhook URL がある。
手順
- Hybrid Cloud Console で、Settings > Integrations に移動します。
- Communications タブをクリックします。
- Add integration をクリックします。
- インテグレーションタイプとして Microsoft Office Teams を選択し、Next をクリックします。
- Integration name フィールドに、インテグレーションの名前 (例: console-teams) を入力します。
- Microsoft Teams からコピーした受信 Webhook URL (HTTP POST URL) を Endpoint URL フィールドに貼り付けます。
- Next をクリックします。
オプション: インテグレーションでイベントを割り当てます。これを行うと、動作グループが自動的に作成されます。
注記このステップを省略し、後でイベントタイプを関連付けることができます。
- OpenShift、Red Hat Enterprise Linux、Console などの製品ファミリーを選択します。
- インテグレーションをどのイベントに対応させるか選択します。
- インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。
- Integrations ページを更新して、Integrations > Communications リストに Microsoft Teams インテグレーションを表示します。Last connection attempt のステータスが Ready になっている場合は、接続が Hybrid Cloud Console からの通知を受け入れることができることを示しています。
検証
Microsoft Teams が Hybrid Cloud Console に正しく接続されていることを確認するためのテスト通知を作成します。
- Integrations > Communications ページの Microsoft Teams インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
- Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
- Microsoft Teams チャネルを開き、Hybrid Cloud Console から送信されたメッセージを確認します。
- Hybrid Cloud Console で Notifications > Event Log に移動し、Integration: Microsoft Teams イベントに緑色のラベルでリストされていることを確認します。
1.1.3. Microsoft Teams インテグレーション用の動作グループの作成 リンクのコピーリンクがクリップボードにコピーされました!
動作グループは、通知サービスが特定のイベントを受信したときに、Microsoft Teams などの外部サービスにどの通知を送信するかを定義します。イベントは、Red Hat Hybrid Cloud Console サービスから動作グループにリンクできます。動作グループの詳細は、Hybrid Cloud Console 通知動作グループの設定 を参照してください。
前提条件
Organization Administrator または Notifications administrator のパーミッションを持つユーザーとして Hybrid Cloud Console にログインしている。
注記メールアドレスが Red Hat ログインと同じでない場合、メールアドレスで Hybrid Cloud Console にログインすることはできません。詳細は、ログインの検索 を参照してください。
- Microsoft チームのインテグレーションが設定されている。Microsoft Teams インテグレーションの設定に関する情報は、「Microsoft Teams での受信 Webhook の設定」 を参照してください。
手順
- Hybrid Cloud Console で、Settings > Notifications に移動します。
- Notifications で Configure Events を選択します。
- イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、または OpenShift) を選択します。
- Behavior Groups タブをクリックします。
- Create behavior group ウィザードを開くには、Create new group をクリックします。
- 動作グループの名前を入力し、Next をクリックします。
- Actions and Recipients の手順で、Actions ドロップダウンリストから Integration: Microsoft Teams を選択します。
- Recipient ドロップダウンリストから、作成したインテグレーションの名前 (console-teams など) を選択し、Next をクリックします。
- Associate event types ステップで、通知を送信する 1 つ以上のイベント (Policies: Policy triggered など) を選択し、Next をクリックします。
- 動作グループの設定を確認し、Finish をクリックします。新しい動作グループは、Behavior Groups タブの Notifications > Configure Events ページに表示されます。
検証
-
Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、ポリシーイベントをトリガーするシステムで
insights-clientを実行します。 - 数分待ってから、Microsoft Teams に移動します。
- 左側のメニューから設定したチャネルを選択します。設定プロセスに成功すると、このページには Hybrid Cloud Console からの通知が表示されます。通知には、イベントをトリガーしたホストの名前と、そのホストへのリンク、および対応する Hybrid Cloud Console サービスを開くイベントおよびリンクの数が含まれます。
Hybrid Cloud Console で、Settings > Notifications > Event Log に移動して、Integration: Microsoft Teams というラベルが表示されたイベントを確認します。
- ラベルが緑色であれば、通知は成功しています。
ラベルが赤色の場合は、受信 Webhook コネクターが Microsoft Teams で適切に作成されていること、および正しい受信 Webhook URL が Hybrid Cloud Console インテグレーション設定に追加されていることを確認してください。
注記詳細は、通知ドキュメントの 通知失敗のトラブルシューティング を参照してください。