Discord Webhooks

Send Keeper advanced reporting and alert notifications to Discord

Discord Setup and Integration

Using the Webhook feature, you can send custom alerts and actions to your Discord server following the steps below. In this example, we are creating a new server, but the webhook can also be set up with an existing Discord server.

(1) Click on the + symbol in the top left corner of your Discord account to Add a Server.

(2) After clicking on Create My Own (or selecting a template), select whether the server is for yourself or for a community.

(3) Customize your server with an icon and a name, then click Create.

(4) You have now created your own Discord server! After clicking on the server name, a dropdown menu will open. From there, click on Server Settings.

(5) On the left-side menu, first select Integrations, then click on Create Webhook.

(6) After customizing the webhook to your liking (name and icon), click on Copy Webhook URL.

(7) Next, login to the Keeper Admin Console and visit Reporting & Alerts. First click on Alerts, then click on an existing alert or create a new one.

(8) After selecting the desired Event Types and Attributes, click on Add Recipient.

Add Recipient (Teams)

(8) Type in the Recipient Name and Email Address and click Add Webhook.

Add Webhook

(9) Paste the Webhook URL from Step 6, then copy and paste the content for the HTTP body below. Lastly, click Save.

(10) Copy this JSON content and paste it into the HTTP Body section in the screenshot above.

{
  "content": "Keeper Security Event",
  "embeds": [
    {
      "title": "Alert Name",
      "description": "#alert_name",
      "fields": [
        {
          "name": "Event Details",
          "value": "#description"
        },
        {
          "name": "IP Address",
          "value": "#remote_address"
        },
        {
          "name": "Timestamp",
          "value": "#timestamp"
        }
      ],
      "footer": {
        "text": "Keeper Security Notification"
      }
    }
  ]
}

That's it! Below you can find an example of a Discord Webhook alert. Please note that it can take up to 15 minutes for events to start transmitting. You can modify the HTTP Body according to your preferences.

References:

• https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks

• https://support.discord.com/hc/en-us/articles/204849977-How-do-I-create-a-server