Slack Webhooks

Slackにアラートを送ります。

Slackの設定と実装例

Webhook機能を使用すると、以下の手順でSlackチャンネルにカスタムアラートとアクションを送信できます。

(1) https://api.slack.com/appsに移動して、アプリを新規作成します。

(2) アプリに名前を付け、目的のワークスペースを選択して、アプリを作成（Create App）をクリックします。

(3) 着信Webhooks（Incoming Webhooks）をクリックします。

(4) Webhookを有効にして、「新しい Webhookをワークスペースに追加（Add New Webhook to Workspace）」をクリックします。

(5) アラートを送信するSlackチャンネルを選択します。次に以下の手順で、「コピー（Copy）」をクリックして、管理コンソールインタフェースに接続するために必要なWebhookのURLを取得します。

(6) 左側の「基本情報」セクションで、Keeperアイコンを追加できます。画像を右クリックして保存します。以下のリンクを使用して、Keeperの512 x 512 PNGアイコンをダウンロードします。 https://keeper-email-images.s3.amazonaws.com/common/Keeper_512x512.png

(7) Keeper管理コンソールにログインし、レポートとアラート > アラートにアクセスして、アラートを新規作成します。目的のイベントタイプと属性を選択したら、「受取人を追加」をクリックします。以下の例では、すべてのポリシー変更が選択されています。

(8) イベントを受信する名前とメールアドレスを入力し、Webhookを追加をクリックします。

(9) 手順5のWebhook URLを貼り付け、以下のHTTP本文の内容をコピーして貼り付けます。

(10) 以下のJSONコンテンツをHTTP Bodyセクションにコピーして貼り付けます。

{
  "text":"Keeper Security Event",
  "blocks": [
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Alert Name*\n#alert_name"
        }
      ]
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Event Details*\n#description"
        }
      ]
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*IP Address*\n#remote_address"
        },
        {
          "type": "mrkdwn",
          "text": "*Timestamp*\n#timestamp"
        }
      ]
    },
    {
      "type": "actions",
      "elements": [
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text":"Vault Login",
            "emoji": true
          },
          "value": "vault",
          "url": "https://keepersecurity.com/vault",
          "action_id": "actionId-1"
        },
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text":"Console Login",
            "emoji": true
          },
          "value": "console",
          "url": "https://keepersecurity.com/console",
          "action_id": "actionId-2"
        }
      ]
    }
  ]
}

(10) 追加をクリックし、アラートを保存します。

以上です。イベントの送信が開始するまでに最大15分かかる場合があることにご注意ください。HTTPボディは、好みに応じて変更できます。 SlackのBlock Kit Builderを使用すれば、ルック＆フィールを完全にカスタマイズできます。

Webhookボディの内容の新規作成や編集の場合、内容の反映に最大15分かかります。

💡Slack - 共有記録の通知

別の使用例は、特定の共有フォルダに記録が追加された場合の通知の送信です。

(1) 上記のSlackの設定手順に従って、基本のSlack実装を作成します。

(2) Webボルトで、報告したい共有フォルダのUIDを取得します。

(3) 管理コンソールで、「共有フォルダに記録を追加しました」を追跡しているイベントの新しいアラートを作成します。

(4) 属性セクションで、共有フォルダのUIDを貼り付けます。

(5) 「受取人」で、新しいWebhookの受信者を作成します。

(6) 以下のJSONテキストボディをHTTPボディセクションにコピーして貼り付けます。作成しているアラートに合わせて、textフィールドを編集してください。

{
  "text":"Keeper - Added Record to Shared Folder",
  "blocks": [
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Alert Name*\n#alert_name"
        }
      ]
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Event Details*\n#description"
        }
      ]
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*IP Address*\n#remote_address"
        },
        {
          "type": "mrkdwn",
          "text": "*Timestamp*\n#timestamp"
        },
        {
          "type": "mrkdwn",
          "text": "*Record UID*\n#record_uid"
        }
      ]
    },
    {
      "type": "actions",
      "elements": [
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text":"Open Record",
            "emoji": true
          },
          "value": "vault",
          "url": "https://keepersecurity.com/vault#detail/#record_uid",
          "action_id": "actionId-1"
        },
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text":"Console Login",
            "emoji": true
          },
          "value": "console",
          "url": "https://keepersecurity.com/console",
          "action_id": "actionId-2"
        }
      ]
    }
  ]
}