What are webhooks? #
A webhook is a way for one application to deliver data to another app in real time.
Most modern platforms support webhooks, or at least similar architectural approaches, such as Github, Trello, Confluence, Facebook, Stripe, and Google Calendar.
Some real-world examples of webhooks include: Automatically receiving an email every morning about your first meeting in case you forget to check your calendar.
Webhooks are basically user-defined HTTP callbacks (or small code snippets linked to a web application) that are triggered by specific events. Whenever that trigger event occurs in the source site, the webhook sees the event, collects the data, and sends it to the URL specified by you in the form of an HTTP request.
Shield Alerts and Webhooks #
GAT Shield offers webhook notifications for Alert rules. This means that anytime an alert rule is triggered, the alert will be sent to the webhook URL that is added in the Shield configuration. This allows for a more practical assessment of the alert triggers, where Alerts will be tied to specific webhooks and will not be overwhelming email inboxes.
How to configure webhooks for Shield Alerts #
At the moment we support webhooks for Google chat.
Manage webhooks #
To set up your webhook URL:
Navigate to Google chat directly or the Gmail app and create a space, once created select the dropdown menu and go to Manage webhooks.
In the next window, name your webhook and select save.
A URL for the webhook will be generated.
Copy the webhook URL
This URL will be used to connect Shield Alerts to the webhook space.
Add webhook in Shield #
Navigate to GAT Shield > General & CIPA > Webhooks
Here you will be able to add a webhook to the tool.
- Webhook name – enter the name for the webhook.
- Webhook type – select the type – Google Chat
- Webhook URL – paste the copied previously webhook URL
- Save – click to save the webhook
Test webhook #
You can quickly test the URL by selecting ‘send test message‘ this should send a generated message to the URL where your webhook resides.
Now that you have added the webhook to the Shield tool, it can be used throughout the Sheild Alert rules configuration.
Anytime an alert rule is triggered, the alert will be sent to the webhook URL that you have selected.
If this fails then the alert will be sent to the recipient email by default.
Note: When webhook is used, the Email notification will be ignored and not sent.
The Alert webhook should look like the one below.