Set up an HTTP Webhook integration

The HTTP Webhook Integration allows FireTail to send alert and incident notifications to a HTTP endpoint, making it easy to connect with external systems, custom applications, or third-party services. You can customize the content of webhook notifications to fit your needs. When an alert resource policy notification or incident occurs, FireTail posts the relevant data to the specified webhook URL, automating alert handling and integrating seamlessly into your existing incident response workflows. To set up an integration:

1. In the side menu, go to Platform, then select Integrations.

2. Click Create Integration. Filter by selecting the Notifications category.

3. Click HTTP Webhook.

4. Enter the Required Details:

   • Name of Integration: Enter a unique name to identify this integration.
   • Secret Value: Enter the secret value used for authenticating the webhook.
   • Webhook URL: Enter your HTTPS endpoint where the alert notifications will be sent.

5. Click Submit to create the integration.

The integration is created and listed under the existing integrations tab You can now select this integration as a notification method when you create an alert,create a resource policy or create an incident.

Verify the Webhook

You can verify the validity of your webhook by using Python. Use the script below:

import hmac
import hashlib

def verify_webhook(request_body, request_headers, webhook_secret):
    digester = hmac.new(bytes(webhook_secret, 'utf-8'), request_body, hashlib.sha512)
    calculated_signature = digester.hexdigest()
    if calculated_signature != request_headers.get('x-ft-sign', None):
        raise("Invalid webhook signature")
    return True