MS Teamsチャンネルへのメッセージ投稿

このドキュメントには外部ソースへの参照があります。 Nexthinkは、サードパーティのドキュメントまたは外部の更新の精度を制御しないため、不整合が発生する可能性があります。

エラーや不整合がある場合は、Nexthinkサポートに報告してください。

このドキュメントでは、Webhookを使用してMS Teamsのチャンネルにメッセージを投稿する方法を示します。

MS Teams

MS Teamsのチャンネルを新しく作成した後にMicrosoft Power Automateを使用して新しいワークフローを構成してください。

1. 作成したチャンネルの3つのドットをクリックし、Workflows を選択します。

2. ポップアップから、Webhookリクエストが受信されたときにチャンネルに投稿するオプションを検索して選択してください。 下記の画像を参照してください。

1. ワークフローの名前を指定し、ワークフロー接続を定義してください。

   • Nexthink Webhookを使用して通知するMS Teamsのチャンネルを定義します。

2. 新しいワークフローを作成するには、Add Workflow ボタンを選択します。

3. 将来の参考のためにURLをコピーしてください。 これは、NexthinkのWebインターフェースでコネクター認証情報とWebhook設定のためです。 下記の画像を参照してください。

   • NoAuthの例: https://defaultXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.XX.environment.api.powerplatform.com:443/powerautomate/automations/direct/workflows/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=1&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

   • OAuth2の例: https://defaultXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.XX.environment.api.powerplatform.com:443/powerautomate/automations/direct/workflows/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=1&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0

OAuth2メソッドを使用する場合、URLからsigパラメーターを削除し、URLがエンコードされていないことを確認してください。

1. Manage your Workflow を選択します。

• 適切な権限が設定されていることを確認してください。

  • NoAuthの場合: Anyoneに設定します。

  • OAuth2の場合: 最初にワークフローを保存した後に、Any user in my tenantに設定します。

• 出力フォーマットが添付ファイルに設定されていることを確認してください。

• アダプティブカードがコンテンツに定義されていることを確認してください。

• プライベートチームチャンネルの場合、ドロップダウンを使用してPost as: Userに設定します。 それ以外の場合、Flow Bot を選択できます。

URLをNexthinkでのWebhook設定に貼り付ける前に、Power Automatorからデコードする必要があります。

Entra ID

コネクタ認証情報にOAuth 2.0を必要としない場合は、Nexthinkセクションにジャンプしてください。

Microsoft Entra IDで下記の手順を追います:

1. Entra IDインスタンスにアクセスして新しいアプリケーションを登録します。

   • Manage > App registrations > New registration

2. アプリケーションの名前を指定し、サポートされるアカウントタイプを定義します。

3. アプリケーションを登録し、Nexthinkで認証情報の設定時に将来的に参照するためにアプリケーションIDをコピーしてください。

4. 新しいクライアントシークレットをクリックして有効期限を設定します。

5. Nexthinkで認証情報を設定する際に将来的に参照するために、シークレットの値（IDではなく）をコピーしてください。

   • シークレットの値は作成後にのみコピーできます。

6. API パーミッションタブに移動し、サインインしたユーザーとしてのMicrosoft Flowにアクセスする権限を追加します。

7. ちょうど登録したアプリの概要ページに戻り、エンドポイントタブに移動します。

8. NexthinkでWebhookを設定する際に将来参照するために**OAuth 2.0トークンエンドポイント（v2）**を保存してください。

Nexthink

NexthinkのWebインターフェースから:

• MS TeamへのアウトゴーイングWebhookのためのコネクタ認証情報を設定する

  • 認証なし: No Auth (None)

  • OAuth 2.0 認証を使用する

• MSチャンネルにメッセージを投稿するためのWebhookを設定してテストする

認証なしでMS Teamのためのコネクタ認証情報を設定する

コネクタ認証情報設定ページから、MS Teamsに設定した受信Webhookの情報を使用してフィールドを記入する:

1. プロトコルドロップダウンからHTTPSオプションを選択してください。

2. MS TeamsからのURLからルートhttps://xxxxx.your-instance.logic.azure.com:443をURLアドレスフィールドに貼り付けてください。

3. 承認 ドロップダウンから No Auth (None) オプションを選択してください。

4. 認証情報を保存してください。

認証付きでMS Teamのためのコネクタ認証情報を設定する

コネクタ認証情報設定ページから、MS Teamsに設定した受信Webhookの情報を使用してフィールドを記入する:

1. プロトコルドロップダウンからHTTPSオプションを選択してください。

2. MS TeamsからのURLからルートhttps://xxxxx.your-instance.logic.azure.com:443をURLアドレスフィールドに貼り付けてください。

3. 承認 ドロップダウンからOAuth 2.0 - クライアントクレデンシャルオプションを選択してください。

4. Entra ID アプリケーション登録の値を使用して、アクセストークンURL、クライアントID、およびクライアントシークレットを入力してください。

5. 認証情報を保存してください。

リソースURLのデフォルト/.defaultを末尾に持つトークンを要求するとき、ダブルスラッシュ//の使用が必須です。 例えば: https://service.flow.microsoft.com//.default.

詳細に関しては、トレーリングスラッシュとデフォルトについてMicrosoft ドキュメントを参照してください。

Nexthinkは、サードパーティのドキュメントまたは外部の更新による不整合の精度を制御しません。

MSチャンネルのWebhook設定

Webhook設定ページから、MS Teamsで作成した接続と、Nexthinkで定義されたコネクタ認証情報の情報を使用してフィールドを記入します。

1. Webhook NQL条件の設定ドキュメントに従い、NQL 条件を入力します。 以下のクエリを参照してください。

   • NQL条件を入力した後、システムはペイロードの許可されたプレースホルダーをリストします。

alert.alerts
| where monitor.tags contains "web-applications"
| where alert.context contains "*Salesforce*" or alert.context contains "*Microsoft*"
| list alert.monitor.name, alert.status, monitor.tags, alert.context, trigger_time, recovery_time, alert.monitor.thresholds, monitor.priority, alert.trigger_values, alert.trigger_reference_value, alert.recovery_values, alert.context, device_view_link , issue_view_link

1. ケースによっては、認証付きか認証なしかをMS Teamのために構成されたコネクタ認証情報を認証情報ドロップダウンから選択します。

2. メソッドドロップダウンからPOSTを選択します。

3. MS Teams構成からルートURLアドレスを削除して、URLエンドポイントをリソースフィールドに貼り付けます。 例えば: /workflows/XXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=?????&sp=/triggers/manual/run&sv=1.0&sig=XXXXXXXXXXXXXXX

URLがエンコードされていないことを確認してください。

1. 送信したいメッセージをペイロードに追加します。 以下の例を参照してください。

• 以下のペイロード例では、Alertデータモデル変数の特別なプレースホルダーが使用さています。

{
  "type": "message",
  "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.0",
        "msteams": {
          "width": "Full"
        },
        "body": [{
            "type": "TextBlock",
            "text": "Nexthink Alert",
            "id": "Title",
            "spacing": "Medium",
            "horizontalAlignment": "Center",
            "size": "ExtraLarge",
            "weight": "Bolder",
            "color": "Accent"
          }, {
            "type": "Container",
            "items": [{
                "type": "TextBlock",
                "text": "{{alert.alert.context.application.name}},{{alert.monitor.name}}",
                "wrap": true,
                "color": "Default",
                "size": "Medium"
              }
            ],
            "style": "emphasis"
          }, {
            "type": "FactSet",
            "facts": [{
                "title": "Assigned to",
                "value": "Infrastructure Team"
              }, {
                "title": "Triggered on: ",
                "value": "{{alert.alert.trigger_time}}"
              }, {
                "title": "Application Name",
                "value": "{{alert.alert.context.application.name}}"
              },
            ]
          }, {
            "type": "TextBlock",
            "text": "Condition breached:",
            "wrap": true
          }, {
            "type": "Table",
            "columns": [{
                "width": 1
              }, {
                "width": 1
              }, {
                "width": 1
              }, {
                "width": 1
              }
            ],
            "rows": [{
                "type": "TableRow",
                "cells": [{
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Metric name",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Threshold",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Metric value",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Baseline Value",
                        "wrap": true
                      }
                    ]
                  }
                ]
              }, {
                "type": "TableRow",
                "cells": [{
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[0].alias}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.monitor.thresholds[0].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[0].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_reference_value}}",
                        "wrap": true
                      }
                    ]
                  }
                ]
              }, {
                "type": "TableRow",
                "cells": [{
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[1].alias}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.monitor.thresholds[1].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[1].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "",
                        "wrap": true
                      }
                    ]
                  }
                ]
              }
            ],
            "showGridLines": false
          }, {
            "type": "ActionSet",
            "actions": [{
                "type": "Action.OpenUrl",
                "title": "View in Nexthink",
                "URL": "{{alert.alert.issue_view_link}}"
              }
            ]
          }
        ]
      }
    }
  ]
}

1. MS Teamsにメッセージがプッシュされていることを確認するために 送信テスト を行ってください。