Red Hat Hybrid Cloud Console とサードパーティーアプリケーションのインテグレーション

手順

1. Microsoft Teams で新しいチャネルを作成するか、既存のチャネルを選択します。
2. Apps に移動し、Incoming Webhook アプリケーションを検索します。
3. Incoming Webhook アプリケーションを選択し、Add to a team をクリックします。
4. チームまたはチャネル名を選択し、Set up a connector をクリックします。
5. 受信 Webhook の名前を入力します (例: Red Hat Notices)。この名前は、Microsoft Teams チャネルがこの受信 Webhook を通じて Red Hat Hybrid Cloud Console から受信するすべての通知に表示されます。
6. オプション: 受信 Webhook の名前に関連付けるイメージをアップロードします。このイメージは、Microsoft Teams チャネルがこの受信 Webhook を通じて Hybrid Cloud Console から受信するすべての通知に表示されます。
7. Create をクリックして作成を完了し、webhook URL を表示します。
8. URL をクリップボードにコピーします。Hybrid Cloud Console で通知を設定するには、URL が必要です。
9. Done をクリックします。Microsoft Teams ページには、チャネルと受信 Webhook が表示されます。
10. Hybrid Cloud Console で、Settings > Integrations に移動します。
11. Communications タブをクリックします。
12. Add integration をクリックします。
13. インテグレーションタイプとして Microsoft Office Teams を選択し、Next をクリックします。
14. Integration name フィールドに、インテグレーションの名前 (例: console-teams) を入力します。
15. Microsoft Teams からコピーした受信 Webhook URL を Endpoint URL フィールドに貼り付けます。
16. Next をクリックします。
17. インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。

1. Integrations > Communications ページの Microsoft Teams インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
2. Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
3. Microsoft Teams チャネルを開き、Hybrid Cloud Console から送信されたメッセージを確認します。
4. Hybrid Cloud Console で Notifications > Event Log に移動し、Integration: Microsoft Teams イベントに緑色のラベルでリストされていることを確認します。

手順

1. Hybrid Cloud Console で、Settings > Notifications に移動します。
2. Notifications で Configure Events を選択します。
3. イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、OpenShift、または Subscription Services) を選択します。
4. Behavior Groups タブをクリックします。
5. Create behavior group ウィザードを開くには、Create new group をクリックします。
6. 動作グループの名前を入力し、Next をクリックします。
7. Actions and Recipients の手順で、Actions ドロップダウンリストから Integration: Microsoft Teams を選択します。
8. Recipient ドロップダウンリストから、作成したインテグレーションの名前 (console-teams など) を選択し、Next をクリックします。
9. Associate event types ステップで、通知を送信する 1 つ以上のイベント (Policies: Policy triggered など) を選択し、Next をクリックします。
10. 動作グループの設定を確認し、Finish をクリックします。新しい動作グループは、Behavior Groups タブの Notifications > Configure Events ページに表示されます。

検証

1. Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、ポリシーイベントをトリガーするシステムで insights-client を実行します。
2. 数分待ってから、Microsoft Teams に移動します。
3. 左側のメニューから設定したチャネルを選択します。設定プロセスに成功すると、このページには Hybrid Cloud Console からの通知が表示されます。通知には、イベントをトリガーしたホストの名前と、そのホストへのリンク、および対応する Hybrid Cloud Console サービスを開くイベントおよびリンクの数が含まれます。

4. Hybrid Cloud Console で、Settings > Notifications > Event Log に移動して、Integration: Microsoft Teams というラベルが表示されたイベントを確認します。

   • ラベルが緑色であれば、通知は成功しています。

   • ラベルが赤色の場合は、受信 Webhook コネクターが Microsoft Teams で適切に作成されていること、および正しい受信 Webhook URL が Hybrid Cloud Console インテグレーション設定に追加されていることを確認してください。

     注記

     詳細は、通知ドキュメントの イベントログおよびインテグレーション設定での通知の失敗 を参照してください。

手順

1. Google スペースで、スペース名の矢印をクリックしてドロップダウンメニューを開きます。

   1. Apps & Integrations を選択します。
   2. Webhooks をクリックします。

2. Incoming webhooks ダイアログに以下の情報を入力します。

   1. インテグレーションの名前を入力します (例: Engineering Google Chat)。
   2. オプション: 通知用のアバターを追加するには、イメージへの URL を入力します。
   3. Save をクリックして Webhook URL を生成します。
   4. Hybrid Cloud Console での設定に使用する Webhook URL をコピーします。

手順

1. Hybrid Cloud Console で、Settings > Integrations に移動します。
2. Communications タブを選択します。
3. Add integration をクリックします。
4. インテグレーションタイプとして Google Chat を選択し、Next をクリックします。
5. Integration name フィールドに、インテグレーションの名前 (例: console-gchat) を入力します。
6. Google スペースからコピーした受信 Webhook URL を Endpoint URL フィールドに貼り付け、Next をクリックします。
7. インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。

1. Integrations > Communications ページの Google Chat インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
2. Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
3. Google スペースを開き、Hybrid Cloud Console から送信されたメッセージを確認します。
4. Hybrid Cloud Console で Notifications > Event Log に移動し、Integration: Google Chat イベントが緑色のラベルでリストされていることを確認します。

手順

1. Hybrid Cloud Console で、Settings > Notifications に移動します。
2. Notifications で Configure Events を選択します。
3. イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、OpenShift、または Subscription Services) を選択します。
4. Behavior Groups タブをクリックします。
5. Create behavior group ウィザードを開くには、Create new group をクリックします。
6. 動作グループの名前を入力し、Next をクリックします。
7. Actions and Recipients の手順で、Actions ドロップダウンリストから Integration: Google Chat を選択します。
8. Recipient ドロップダウンリストから、作成したインテグレーションの名前 (console-gchat など) を選択し、Next をクリックします。
9. Associate event types ステップで、通知を送信する 1 つ以上のイベント (Policies: Policy triggered など) を選択し、Next をクリックします。
10. 動作グループの設定を確認し、Finish をクリックします。新しい動作グループが Notifications ページに表示されます。

検証

1. Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、ポリシーイベントをトリガーするシステムで insights-client を実行します。
2. 数分待ってから、Google Chat に移動します。
3. Google Space で、Hybrid Cloud Console からの通知を確認します。

4. Hybrid Cloud Console で、Settings > Notifications > Event Log に移動して、Integration: Google Chat のラベルが表示されているイベントを確認します。

   • ラベルが緑色であれば、通知は成功しています。
   • ラベルが赤色の場合は、インテグレーションを調整する必要がある可能性があります。
5. インテグレーションが想定どおりに機能しない場合は、受信 Webhook コネクターが Google Chat で適切に作成されていること、および正しい受信 Webhook URL が Hybrid Cloud Console インテグレーション設定に追加されていることを確認してください。

手順

1. Slack アプリケーションを作成します。

   1. Slack API Web ページに移動し、Create your Slack app ボタンをクリックします。これにより、Create an app ダイアログが開きます。
   2. Slack 設定 UI を使用してアプリケーションを作成するには、From scratch を選択します。

   3. アプリケーションの名前を入力し、通知を受信するワークスペースを選択します。

      注記

      管理者の承認が必要であるというメッセージが表示された場合は、次の手順で承認をリクエストできます。

   4. Create App をクリックして、Slack アプリケーションの作成を完了します。

2. 着信 Webhook を有効にします。

   1. 左側のナビゲーションの Features 見出しの下にある Incoming Webhooks をクリックします。
   2. Activate Incoming Webhooks スイッチを On に切り替えます。
   3. Request to Add New Webhook ボタンをクリックします。必要に応じて、管理者にアプリケーションへのアクセスを許可するメッセージを入力し、Submit Request をクリックします。成功メッセージが表示され、正しく設定されたことが確認されます。

3. Incoming Webhook の作成

   1. 左側のナビゲーションの Settings で、Basic Information をクリックします。
   2. Install your app セクションで、Install to Workspace ボタンをクリックします。
   3. Slack アプリケーションが通知を投稿するチャネルを選択するか、ダイレクトメッセージとして通知を送信するユーザーを選択します。
   4. 変更を保存するには、Allow をクリックします。

4. オプション: Hybrid Cloud Console の通知が Slack にどのように表示されるかを設定します。

   1. 下にスクロールして 情報を表示します。
   2. 必要に応じて、アプリケーションの説明、アイコン、背景色を設定します。

5. Webhook URL をコピーします。

   1. Features の下で、Incoming Webhooks をクリックします。
   2. Webhook URL の横にある Copy ボタンをクリックします。この URL を使用して、「Red Hat Hybrid Cloud Console での Slack インテグレーションの設定」 の Hybrid Cloud Console で統合を設定します。

手順

1. 必要に応じて、Slack API Web ページにアクセスし、設定した Webhook URL をコピーします。

   注記

   Slack Webhook URL を作成する手順は、「Slack で受信 Webhook の設定」 を参照してください。

2. Hybrid Cloud Console で、Settings > Integrations に移動します。
3. Communications タブを選択します。
4. Add integration をクリックします。
5. インテグレーションタイプとして Slack を選択し、Next をクリックします。
6. 統合の名前を入力します (例: My Slack notifications)。
7. Slack からコピーした Slack Webhook URL を Workspace URL フィールドに貼り付けて、Next をクリックします。
8. インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。
9. 統合ページを更新して、Integrations > Communications リストに Slack インテグレーションを表示します。Last connection attempt のステータスが Ready になっている場合は、接続が Hybrid Cloud Console からの通知を受け入れることができることを示しています。

1. Integrations > Communications ページの Slack インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
2. Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
3. 設定した Slack チャネルを開き、Hybrid Cloud Console から送信されたメッセージを確認します。
4. Hybrid Cloud Console で Notifications > Event Log に移動し、Integration: Slack イベントが緑色のラベルでリストされていることを確認します。

手順

1. Hybrid Cloud Console で、Settings > Notifications に移動します。
2. Notifications で Configure Events を選択します。
3. イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、OpenShift、または Subscription Services) を選択します。
4. Behavior Groups タブをクリックします。
5. Create behavior group ウィザードを開くには、Create new group をクリックします。
6. 動作グループの名前を入力し、Next をクリックします。
7. Actions and Recipients ステップで、Actions ドロップダウンリストから Integration: Slack を選択します。

8. Recipient ドロップダウンリストから、作成した統合の名前 (たとえば、My Slack notifications) を選択し、Next をクリックします。

   

9. Associate event types ステップで、通知を送信する 1 つ以上のイベント (Policies: Policy triggered など) を選択し、Next をクリックします。

10. 動作グループの設定を確認し、Finish をクリックします。新しい動作グループは、Behavior Groups タブの Notifications > Configure Events ページに表示されます。

    注記

    複数の動作グループを作成および編集して、通知サービスがサポートする追加のプラットフォームを含めることができます。

11. Settings > Integrations の順に選択し、Communications タブをクリックします。Slack インテグレーションがイベントを Slack に送信する準備ができると、Last connection attempt 列に Ready が表示されます。通知が Slack に正常に到達した場合は、Last connection attempt 列に Success と表示されます。

    

検証

1. Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、ポリシーイベントをトリガーするシステムで insights-client を実行します。
2. 数分待ってから Slack に移動します。
3. Slack チャネルで、Hybrid Cloud Console からの通知を確認します。

4. Hybrid Cloud Console で、Settings > Notifications > Event Log に移動して、Integration: Slack のラベルが表示されているイベントを確認します。

   • ラベルが緑色であれば、通知は成功しています。
   • ラベルが赤色の場合は、インテグレーションを調整する必要がある可能性があります。

5. インテグレーションが想定どおりに機能しない場合は、受信 Webhook コネクターが Slack で適切に作成されていること、および正しい受信 Webhook URL が Hybrid Cloud Console インテグレーション設定に追加されていることを確認してください。

   注記

   詳細は、通知ドキュメントの イベントログおよびインテグレーション設定での通知の失敗 を参照してください。

手順

1. Splunk 用 Red Hat Insights アプリケーションをインストールします。

   1. Splunk にログインします。
   2. ホームページでフィルターボックスで Red Hat Insights を検索し、選択します。
   3. Install をクリックします。インストールプロセスが完了すると、Install successful というメッセージが表示されます。
   4. ホームページで、Settings メニュー (歯車アイコン) をクリックします。Apps ページが開きます。
   5. filter ボックスに Red Hat Insights と入力し、虫眼鏡をクリックします。アプリケーションが検索結果に表示されます。
   6. ホームページで、画面の左側にある Apps 見出しの下にある Find more apps をクリックします。Browse More Apps ページが開きます。
   7. フィルターボックスに Red Hat Insights と入力し、Enter キーを押します。Red Hat Insights が検索結果に表示されます。
   8. Red Hat Insights を選択します。
   9. Install をクリックします。
   10. Splunk のユーザー名とパスワードを確認または入力し、Agree and Install をクリックします。インストールプロセスが完了すると、Complete ダイアログボックスが開きます。

2. Splunk 用の Red Hat Insights アプリケーションを設定します。

   1. Complete ダイアログボックスで、Open the App をクリックします。App configuration ページが開きます。

   2. Continue to app setup ページ をクリックします。Set up integration with Red Hat Insights ページが開きます。このページには、HTTP イベントコレクター (HEC) 名とデフォルトのインデックスフィールドが含まれています。

      

   3. Create Red Hat Default Index で Settings > Index をクリックします。Indexes ページが新しいタブで開きます。
   4. Indexes ページで、New Index をクリックします。
   5. Name フィールドにインデックスの名前を入力します (例: redhatinsights)。
   6. Max raw data size および Searchable retention (days) フィールドに値を入力します。
   7. Save をクリックします。作成したインデックスが Indexes リストに表示されます。これは、デフォルトで有効になっています。
   8. 最初の Splunk 画面の Set up integration with Red Hat ページで、HEC 名フィールドに HEC の名前を入力します (例: redhatinsights)。
   9. Default インデックスフィールドに、先ほど作成したインデックスの名前を入力します (例: redhatinsights)。
   10. Next をクリックします。
   11. Review をクリックしてから Submit をクリックします。作成した HEC 名が HEC 名フィールドに表示されます。

   12. Next をクリックして、HEC URL と HEC トークンを作成します。

       

3. Insights で Splunk 統合を設定します。

   1. Copy をクリックして、Splunk Enterprise に HEC URL 値をコピーします。

   2. Next: Configure Splunk integration in Insights をクリックします。新しいブラウザータブで Hybrid Cloud Console が開きます。

      注記

      このボタンは、HEC URL または HEC トークンの Copy ボタンをクリックするまで無効になります。

   3. Hybrid Cloud Console で、Settings > Integrations に移動します。

1. HEC URL の値を Splunk HEC URL フィールドに貼り付けます。

   注記

   コンソールの新しいタブが開かない場合は、ブラウザーのポップアップブロッカーを無効にしてください。

2. 必要に応じて、ポートを追加します。Splunk Cloud Platform のデフォルトポートは 443 です。Splunk Enterprise と Splunk Cloud の無料トライアルのデフォルトポートは 8088 です。

   

3. オプション: Splunk Cloud を使用している場合は、Splunk Cloud 形式と一同じように、Integrations ページの Splunk HEC URL フィールドに貼り付けた HEC URL を編集します。

   • Google Cloud Platform (GCP) を除くすべてのクラウド上の Splunk Cloud Platform には次の形式を使用します。

     <protocol>://http-inputs-<host>.splunkcloud.com:<port>

   • Google Cloud Platform (GCP) 上の Splunk Cloud Platform には次の形式を使用します。

     <protocol>://http-inputs.<host>.splunkcloud.com:<port>

     以下のプレースホルダーを置き換えます。

   • protocol: http または https のいずれか
   • host: HEC を実行する Splunk Cloud Platform インスタンスの名前の後にドメイン .splunkcloud.com が続きます。

   • port: HEC ポート番号 (Splunk Cloud Platform インスタンスではデフォルトで 443)。

     例:

   • JSON を使用した GCP 上の Splunk Cloud Platform:

     https://http-inputs.myhost.splunkcloud.com:443

   • raw イベントを使用した AWS での Splunk Cloud 無料トライアル:

     https://http-inputs-otherhost.splunkcloud.com:443

     1. 設定プロセスを完了します。
4. Splunk の HEC Token 値をコピーし、Hybrid Cloud Console の Integrations ページの Splunk HEC Token フィールドに貼り付けます。

5. Hybrid Cloud Console で、Run configuration をクリックします。Hybrid Cloud Console はインテグレーションをセットアップし、動作グループを作成して、Hybrid Cloud Console イベントを動作グループに関連付けます。ページの右側にあるステータスメッセージセクションには、これらの各アクションのステータスが表示されます。

   

6. セットアップが正常に完了したら、Next: Review をクリックします。アプリケーションは、Splunk integration in Insights completed というメッセージを返します。

   

7. Go back to the Splunk application をクリックします。これにより、Splunk の Red Hat とのインテグレーションのセットアップ画面にリダイレクトされます。

8. Finish set up をクリックして、Splunk でのセットアップを完了します。

   

9. Go to dashboard をクリックして、Splunk ダッシュボードにリダイレクトします。

   

   注記

   Insights のセットアッププロセス中にインテグレーション設定が失敗した場合は、Red Hat サポートにお問い合わせください。

   1. Splunk ダッシュボードで Hybrid Cloud Console イベントのリストを表示するには、イベントタブをクリックします。各イベントは Hybrid Cloud Console にハイパーリンクされています。

      

手順

1. Splunk ホームページから、Settings に移動します。

2. Data Inputs を選択し、HTTP Event Collector を選択します。HTTP Event Collector ページには、HEC、そのトークン値、セットアップ中に選択した対応するインデックス、および HEC のステータスが表示されます。

   

3. ページの右上隅にある Global Settings をクリックします。グローバル設定の編集ダイアログボックスが表示されます。

   

4. Enabled を選択します。これにより、セットアッププロセス中に自動的に作成された HEC トークンが有効になります。

   注記

   HEC トークンは、デフォルトの HTTP ポート番号 8088 を使用します。別のポート (Splunk Cloud のポート 443 など) を使用している場合は、一致するように Hybrid Cloud Console Splunk インテグレーションを更新する必要があります。

手順

1. Settings > Identity & Access Management をクリックします。
2. Identity & Access Management で、必要に応じて User Access を展開し、Groups を選択します。
3. Create group をクリックします。Name and description ページが表示されます。
4. グループの名前 (例: splunknotifgroup) を入力し、説明を入力して、Next をクリックします。Add roles ページが開きます。
5. Notifications administrator ロールを追加するには、検索ボックスに notif と入力します。
6. 検索結果から Notifications Administrator を選択し、Next をクリックします。Add Members ページが開きます。
7. このグループに追加するユーザーを選択します。検索ボックスを使用すると、特定の名前を検索できます。
8. Next をクリックします。Review Details ページが開きます。
9. 情報を確認し、Submit をクリックしてグループを作成します。
10. Exit をクリックします。Groups ページが開きます。

検証

1. 検索ボックスに新しいグループ名を入力します。
2. グループ名をクリックします。グループのページが開きます。
3. Roles タブで、グループに Notifications administrator ロールがあることを確認します。
4. Members タブをクリックして、グループに正しいメンバーが含まれていることを確認します。

手順

1. Hybrid Cloud Console で、Settings > Integrations に移動します。
2. Reporting & Automation タブを選択します。
3. Add integration をクリックします。
4. インテグレーションタイプとして Splunk を選択し、Next をクリックします。
5. 新しいインテグレーションの名前を Integration name フィールドに入力します (例: redhat_splunk)。

6. Endpoint URL フィールドに、Splunk HEC エンドポイント URL を追加します。

   1. Splunk Enterprise の場合、Splunk はデフォルトでポート 8088 を使用します。例: https://<splunk-endpoint>:8088

   2. Splunk Cloud の場合、Splunk はポート 443 を使用します。Splunk Cloud on AWS または GCP の詳細は Send data to HTTP Event Collector を参照してください。

      注記

      サービスは <endpoint> (http パス) を自動的に追加します。エンドポイント URL のフォーム入力に含める必要はありません。

      以下の例は、Splunk プラットフォームの正しいポート番号を持つエンドポイント URL を示しています。

      • オンプレミス (Splunk Enterprise): https://splunk.company.com:8088
      • Splunk Cloud (AWS 上): https://http-inputs-mycompany.splunkcloud.com:443
      • Splunk Cloud (GCP 上): https://http-inputs.mycompany.splunkcloud.com:443
7. Secret token フィールドに、Splunk HEC トークンの値を追加します。
8. Next をクリックします。
9. インテグレーションの詳細を確認し、Submit をクリックします。

手順

1. ServiceNow インスタンスにログインします。

2. ServiceNow Store ホームページ に移動し、Flow Templates をインストールまたは更新します。

   • Red Hat Insights アプリケーションのフローテンプレートを ServiceNow ストアから (または 更新セット として) インストールします。

     1. ユーザー ID rh_insights_integration で 新しいユーザーを作成します。
     2. 作成したユーザーの Internal Integration User を確認します。
     3. ユーザーが Active であることを確認します。
     4. ロール x_rhtpp_rh_webhook.rest をユーザーに割り当てます。
     5. ユーザーのパスワードを生成します。設定プロセスで使用するため、この情報をコピーしてください。
3. 新しいブラウザーウィンドウまたはタブで Hybrid Cloud Console を開きます。

4. Settings > Integrations の順に移動し、Reporting & Automation タブを選択し、以下の手順を実行します。

   1. Add integration をクリックします。
   2. インテグレーションタイプとして ServiceNow を選択し、Next をクリックします。
   3. ServiceNow integration など、インテグレーションの名前を作成します。

   4. Endpoint URL を指定し、<instance.servicenow.com> は、ServiceNow インスタンスに置き換えます。

      https://<instance.servicenow.com>/api/x_rhtpp_rh_webhook/flow_templates_for_red_hat_insights

   5. SSL を有効にするチェックボックスはデフォルトでオンになっています。
   6. Secret token フィールドに、ServiceNow で作成した rh_insights_integration ユーザーの生成パスワードを貼り付けます。
   7. Next をクリックします。
   8. インテグレーションの詳細を確認し、Submit をクリックします。

5. Hybrid Cloud Console > Settings > Notifications に移動し、次の手順を実行します。

   1. Notifications で Configure Events を選択します。
   2. イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、OpenShift、または Subscription Services) を選択します。
   3. Behavior Groups タブをクリックします。
   4. Create behavior group ウィザードを開くには、Create new group をクリックします。
   5. Name フィールドに新しい動作グループの名前を入力し、Next をクリックします。
   6. Actions については、ドロップダウンリストから Integration: ServiceNow を選択します。
   7. Recipient には、以前に作成した ServiceNow のインテグレーションを選択します (例: ServiceNow integration)。
6. Next をクリックします。Associate event types ウィンドウが開きます。

7. 一覧から以下のイベントタイプを選択します。

   • Advisor の新しい推奨事項
   • CVSS >= 7.0 の新しい脆弱性
   • 重大度が Critical (重大) の新たな脆弱性
   • セキュリティールールを含む新しい脆弱性
   • 既知の不正使用の脆弱性
8. Next、Finish の順にクリックして設定プロセスを開始します。

手順

1. 環境を Red Hat Ansible Automation Hub に接続します。

   1. Hybrid Cloud Console で、Ansible Automation Platform > Connect to Hub に移動します。
   2. Offline token で、以下の文字列をコピーします。トークンは 30 日間使用しないと期限切れになります。トークンの有効期限が切れないように、以下のコマンドを定期的に実行してください。
   3. ターミナルウィンドウに、前の手順でコピーした文字列を貼り付けます。

2. Event-Driven Ansible の Red Hat Insights コレクションをインストールするには、以下のコマンドを入力します。

   $ ansible-galaxy collection install redhat.insights_eda

3. Red Hat Insights の要件をインストールするには、root ユーザーとして次のコマンドを入力します。

   # pip3 install -r ~/.ansible/collections/ansible_collections/redhat/insights_eda/requirements.txt

4. 次のコマンドを入力して、redhat.insights_eda が出力に含まれていることを確認します。

   $ ansible-galaxy collection list

   このコマンドの出力例：

   # /home/username/.ansible/collections/ansible_collections
   Collection         Version
   ------------------ -------
   ansible.eda        1.3.8
   community.general  7.0.1
   redhat.insights_eda 1.0.0

5. テキストエディターを使用して、Red Hat Insights コレクションを使用するシンプルな Ansible ルールブックを含む YAML ファイルを作成します。たとえば、次の内容を含む simple-rulebook.yaml というファイルを作成します。

   ---
   - name: Listen for events from Red Hat Insights
     hosts: all
     sources:
       - redhat.insights_eda.insights:
     rules:
       - name: Handle Red Hat Insights payload
         condition: event.payload is defined
         action:
           debug:
             msg: "Received: {{ event.payload }}"

   このシンプルな Playbook は、redhat.insights_eda.insights コレクションをソースとして使用します。ペイロード を持つイベントが定義されている場合、event.payload の内容が出力として表示されます。

   ルールブックは、イベントを受信し、Hybrid Cloud Console と通信するために使用されるエンドポイントを公開します。Red Hat Insights アドバイザー、コンプライアンス、および脆弱性サービスの高度な例は、Ansible Automation Hub の Event-Driven Ansible for Red Hat Insights ドキュメントを参照してください。

6. 関連する Playbook を含む YAML ファイルを作成します。たとえば、単純なインベントリーを含む inventory.yaml というファイルを作成します。

   all:

7. ansible-rulebook コマンドを実行して、Event-Driven Ansible リスナーを起動し、新しいイベントをリッスンします。次の例では、このコマンドはデフォルトのポート 5000 で localhost を公開します。

   $ ansible-rulebook --verbose --rulebook simple-rulebook.yml -i inventory.yml

8. 別のターミナルウィンドウで curl コマンドを実行して、Event-Driven Ansible リスナーが正しく設定されていることを確認します。次に例を示します。

   $ curl -H 'Content-Type: application/json' -d "{\"payload\": \"Test incoming event\"}" localhost:5000/endpoint

   この例では、設定が正しい場合、イベントの内容を含む新しいメッセージが EDA リスナーウィンドウに表示されます。

   Received: {'payload': 'Test incoming event'}

9. Hybrid Cloud Console で、Settings > Integrations に移動します。
10. Reporting & Automation タブを選択します。
11. Add integration をクリックします。
12. Event-Driven Ansible をインテグレーションタイプとして選択し、次に Next をクリックします。
13. Integration name フィールドに、統合の名前を入力します (例: My EDA Integration)。

14. Ansible ルールブックで設定した URL を Endpoint URL フィールドに入力します。これは、Event-Driven Ansible リスナーを指すエンドポイントです。

    注記

    Endpoint URL には http:// または https:// を含める必要があります (例: https://<eda_hostname>:5000/endpoint)。

    必要に応じて、組織のセキュリティー管理者に Red Hat Hybrid Cloud Console へのアクセスを設定するよう依頼してください。

15. オプション: シークレットトークン が設定されている場合は入力します。

    注記

    Secret トークンは、インテグレーションエンドポイントに送信されるデータを保護するために必要であり、Hybrid Cloud Console をサードパーティーアプリケーションと統合するときは常に使用する必要があります。

16. Next をクリックします。
17. インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。

1. Integrations > Reporting & Automation ページの Event-Driven Ansible インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
2. Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
3. Event-Driven Ansible リスナーターミナルで、Hybrid Cloud Console から送信されたメッセージを確認します。
4. Hybrid Cloud Console で、Notifications > Event Log に移動し、Integration: Event-Driven Ansible イベントが緑色のラベルでリストされていることを確認します。

手順

1. Ansible Automation Platform 2.5 環境で、Automation Decisions > Infrastructure > Credentials に移動します。
2. Credentials ページで Create credential をクリックします。
3. Create credential ページで、認証情報の名前を入力します (例: Red Hat Insights)。
4. Organization タイプを選択し、Credential type で Token Event Stream を選択します。

5. トークンを入力してコピーします。トークン値は、Hybrid Cloud Console と、Event-Driven Ansible を使用した Ansible Automation Platform 間のトークン認証に使用されます。

   注記

   トークン値には、大文字または小文字、数字、記号を含む任意の文字列を無作為に指定できます。トークンジェネレーターは Web にあります。

6. HTTP Header Key の下に X-Insights-Token を入力します。
7. Save credential をクリックします。
8. Automation Decisions > Event Streams に移動して、Create event stream をクリックします。
9. Create event stream ページで、イベントストリームの名前 (例: Red Hat Insights event stream) を入力します。
10. Organization で組織を選択します。
11. Event stream type で Token Event Stream を選択します。
12. 作成した認証情報 (例: Red Hat Insights) を選択します。
13. Create event stream をクリックします。
14. イベントストリームページの Details タブで、イベントストリームのエンドポイント URL をコピーします。この URL は、Hybrid Cloud Console で Event-Driven Ansible インテグレーションを設定するときに使用されます。

15. Github リポジトリーから Ansible ルールブックをインポートします。

    1. Ansible プロジェクトを作成するには、Red Hat Ansible Automation Platform > Automation Decisions > Projects に移動します。
    2. プロジェクトの作成 ページで、プロジェクトの名前 (例: Insights) を入力します。
    3. Source control URL で、Red Hat Insights ルールブックを含む Github リポジトリーの URL を貼り付けて、Create project をクリックします。
    4. Insights ルールブックを有効するには、Red Hat Ansible Automation Platform > Automation Decisions > Rulebook Activations に移動し、Create rulebook activation をクリックします。
    5. アクティベーションの名前を入力します (例: Insights rulebook)。
    6. Organization で、組織を選択します。
    7. Project で Insights を選択します。
    8. Rulebook で、リストからルールブックを選択します。
    9. Event streams の横にある歯車アイコンを選択し、作成したイベントストリームを選択します。
    10. Descision enviroment で Default Decision Environment を選択し、Create rulebook activation をクリックします。ルールブックのページが表示されます。
    11. アクティベーションのステータスが Running に変わるまで待ちます。
16. Hybrid Cloud Console で、Settings > Integrations に移動します。
17. Reporting & Automation タブを選択します。
18. Add integration をクリックします。
19. Event-Driven Ansible をインテグレーションタイプとして選択し、次に Next をクリックします。
20. Integration name フィールドに、統合の名前を入力します (例: My EDA Integration)。
21. 先ほどコピーしたイベントストリーム URL を Endpoint URL フィールドに入力します。これは、Event-Driven Ansible リスナーを指すエンドポイントです。Hybrid Cloud Console が HTTP POST イベントを送信するには、このエンドポイント URL にアクセスできる必要があります。Hybrid Cloud Console からの HTTP POST イベントを受け入れるには、ネットワークアクセスまたはファイアウォール、あるいはその両方を設定する必要がある場合があります。

22. 前に作成したシークレットトークンを入力します。

    注記

    Secret トークンは、インテグレーションエンドポイントに送信されるデータを保護するために必要であり、Hybrid Cloud Console をサードパーティーアプリケーションと統合するときは常に使用する必要があります。

23. Next をクリックします。
24. インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。

1. Integrations > Reporting & Automation ページの Event-Driven Ansible インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
2. Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
3. Ansible Automation Platform with Event-Driven Ansible で、Automation Decisions > Event Streams に移動します。
4. イベントストリームの Details タブで、Events received の数が増加していることを確認します。
5. Hybrid Cloud Console で、Notifications > Event Log に移動し、Integration: Event-Driven Ansible イベントが緑色のラベルでリストされていることを確認します。

手順

1. Hybrid Cloud Console で、Settings > Notifications に移動します。
2. Notifications で Configure Events を選択します。
3. イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、OpenShift、または Subscription Services) を選択します。
4. Behavior Groups タブをクリックします。
5. Create behavior group ウィザードを開くには、Create new group をクリックします。
6. 動作グループの名前を入力し、Next をクリックします。
7. Actions and Recipients の手順で、Actions ドロップダウンリストから Integration: Event-Driven Ansible を選択します。
8. Recipient ドロップダウンリストから、作成したインテグレーションの名前 (My EDA Listener など) を選択し、Next をクリックします。
9. Associate event types ステップで、通知を送信する 1 つ以上のイベント (たとえば、Advisor: New recommendation) を選択し、Next をクリックします。
10. 動作グループの設定を確認し、Finish をクリックします。新しい動作グループが Notifications ページに表示されます。

検証

1. Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、登録済みシステムで insights client コマンドを実行して、Advisor からの新しい推奨イベントをトリガーできます。

2. Hybrid Cloud Console が正常に統合されたことを確認するには、Hybrid Cloud Console で Settings > Notifications > Event Log に移動し、トリガーした最後のイベントに Integrations: Event-Driven Ansible のラベルが表示されていることを確認します。

   

   • ラベルが緑色であれば、通知は成功しています。
   • ラベルが赤色の場合は、ストリームが Event-Driven Ansible で適切に作成および公開されていること、および Hybrid Cloud Console 統合設定で正しいストリーム URL が設定されていることを確認してください。

手順

1. PagerDuty ホームページで、Services をクリックします。
2. New Service をクリックします。Create a Service ウィザードが開きます。
3. 新しいサービスの名前と説明 (例: Red Hat PagerDuty Service) を入力し、Next をクリックします。
4. 既存のエスカレーションポリシーを選択するか、新しいエスカレーションポリシーを生成して、Next をクリックします。
5. Reduce Noise 画面で必要な項目を選択し、Next をクリックします。
6. Create a Service 画面で Events API V2 インテグレーションを選択し、Create Service をクリックします。
7. 必要に応じて、Integrations ページで、Events API V2 の横にある矢印をクリックしてパネルを展開します。
8. Events API v2 Overview の横にあるインテグレーションキーをコピーします。このキーを使用して、サービスを Hybrid Cloud Console と統合します。

手順

1. PagerDuty ホームページで、Services をクリックします。
2. インテグレーションキーを生成するサービスを選択します。
3. Integrations タブを選択し、Add another integration をクリックします。
4. Add Integrations 画面で Events API V2 インテグレーションを選択し、Add をクリックします。
5. 必要に応じて、Events API V2 の横にある矢印をクリックしてパネルを展開します。
6. Events API v2 Overview の横にあるインテグレーションキーをコピーします。このキーを使用して、サービスを Hybrid Cloud Console と統合します。

手順

1. Settings > Integrations に移動します。
2. Reporting & Automation タブを選択します。
3. Add integration をクリックし、Add integration ウィザードを開きます。これが最初に追加するインテグレーションである場合は、この手順をスキップしてください。
4. PagerDuty を選択し、Next をクリックします。
5. インテグレーションに対してわかりやすい名前を入力します (例: PagerDuty Integration)。
6. 統合する PagerDuty アカウントのインテグレーションキーを入力します。インテグレーションキーの作成に関する詳細は、「PagerDuty サービスの作成」 を参照してください。
7. アラートの重大度を指定します。
8. Next をクリックします。
9. インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。
10. Integrations ページを更新して、PagerDuty インテグレーションを Integrations > Reporting & Automation リストに表示します。Last connection attempt のステータスが Ready になっている場合は、接続が Hybrid Cloud Console からの通知を受け入れることができることを示しています。

1. Integrations ページに移動し、Reporting & Automation タブを選択します。
2. PagerDuty インテグレーションが表示され、ステータスが Ready であることを確認します。
3. PagerDuty インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
4. Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
5. PagerDuty インスタンスを開き、Hybrid Cloud Console から送信されたメッセージを確認します。
6. Hybrid Cloud Console で Notifications > Event Log に移動し、Integration: PagerDuty イベントが緑色のラベルでリストされていることを確認します。

手順

1. Hybrid Cloud Console で、Settings > Notifications に移動します。
2. Notifications で Configure Events を選択します。
3. イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、OpenShift、または Subscription Services) を選択します。
4. Behavior Groups タブをクリックします。
5. Create behavior group ウィザードを開くには、Create new group をクリックします。
6. 動作グループの名前を入力し、Next をクリックします。
7. Actions and Recipients の手順で、Actions ドロップダウンリストから Integration: PagerDuty を選択します。
8. Recipient ドロップダウンリストから、作成したインテグレーションの名前 (PagerDuty Integration など) を選択し、Next をクリックします。
9. Associate event types ステップで、通知を送信する 1 つ以上のイベント (Policies: Policy triggered など) を選択し、Next をクリックします。
10. 動作グループの設定を確認し、Finish をクリックします。新しい動作グループが Notifications ページに表示されます。

検証

1. Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、ポリシーイベントをトリガーするシステムで insights-client を実行します。
2. 数分待ってから、PagerDuty に移動します。
3. PagerDuty アカウントで、Hybrid Cloud Console からの通知を確認します。

4. Hybrid Cloud Console で、Settings > Notifications > Event Log に移動して、Integration: PagerDuty のラベルが表示されているイベントを確認します。

   • ラベルが緑色であれば、通知は成功しています。
   • ラベルが赤色の場合は、インテグレーションを調整する必要がある可能性があります。
5. インテグレーションが想定どおりに機能しない場合は、Events API v2 インテグレーションキーが PagerDuty で適切に作成されていること、および正しい受信インテグレーションキーが Hybrid Cloud Console インテグレーション設定に追加されていることを確認してください。