Teams Webhooks

KeeperのレポートとアラートをMicrosoft TeamsへWebhookで通知

Microsoft Teamsのセットアップと連携

書式付きのアラートをMicrosoft Teamsのチャンネルへ送るには、以下の手順に従います。

(1) 通知を出したいTeamsチャンネルで、[⋯] (その他メニュー) をクリックし、[ワークフロー] を選びます。

(2) 検索ボックスに webhooks と入力してワークフローを絞り込み、[Send webhook alerts to a channel] を選びます。

(3) チャンネルが属するチームを選びます。対象チャンネルは最初から選ばれていることが多いです。

(4) 作成したワークフローの画面に表示されるWebhook URLをコピーします。

(5) Keeper管理コンソールにログインし、[レポートとアラート] > [アラート] を開き、新規でアラートを作成するか、既存のアラートを開きます。

アラートの追加

(6) [受信者] > [受信者を追加] をクリックします。

受信者の追加 (Teams)

(7) 受信者名とメールアドレスを入力し、[Webhookを追加] をクリックします。

Webhookの追加

(8) 手順 (4) でコピーしたWebhook URLを入力欄に貼り付けます。続けて、下記のJSONを [HTTPボディ] 欄にコピーして貼り付けます。

URLとHTTPボディの追加

{
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "themeColor": "0076D7",
    "summary": "Alert: #alert_name",
    "sections": [{
        "activityTitle": "#description",
        "activitySubtitle": "#alert_name",
        "activityImage": "https://keeper-email-images.s3.amazonaws.com/common/Keeper_512x512.png",
        "facts": [{
            "name": "User",
            "value": "#username"
        }, {
            "name": "Timestamp",
            "value": "#timestamp"
        }, {
            "name": "IP Address",
            "value": "#remote_address"
        }],
        "markdown": true
    }]
}

(9) 受信者の設定で [保存] をクリックし、続けてアラートの画面でも [保存] をクリックします。

Webhookの追加

以上です。イベントがTeams側に届き始めるまで最大15分かかることがあります。HTTP本文は用途に合わせて書き換えてかまいません。カードの見た目を細かく調整するときは、Microsoftのコネクタに関するドキュメントをご参照ください。

Webhook本文を新しく作った直後や編集した直後は、内容が有効になるまで最大15分かかることがあります。

コマンドラインによるWebhooksのテスト (任意)

Mac/Linux環境では、書式を手早く試すために curl が使えます。

• test.json などのファイルにWebhook本文 (JSON) を保存

• 以下のコマンドの <WEBHOOK URL> を、実際のSlackまたはTeamsのWebhook URLに置き換えて実行

# MacおよびLinuxの場合:
curl -X POST -H 'Content-type: application/json' -d @test.json <WEBHOOK URL>

# Windowsの場合
curl.exe -H "Content-Type:application/json" -d @test.json <WEBHOOK URL>