# TheHive Trigger

TheHive (opens new window) is a scalable open-source and free security incident response platform.

# Example Usage

This workflow allows you to receive updates when an event occurs in TheHive. You can also find the workflow (opens new window) on the website. This example usage workflow would use the following node.

The final workflow should look like the following image.

A workflow with the TheHive Trigger node

# 1. TheHive Trigger node

This node will trigger the workflow whenever a new event occurs in TheHive. To trigger the workflow for a specific event, select that event instead.

  1. First of all, you'll have to add the webhook URL in TheHive instance configuration. Refer to the FAQs to learn how to configure a webhook in TheHive.
  2. Select the * from the Events dropdown list. This will trigger the workflow for all the events.
  3. Click on Execute Node to run the node.

💡 Activate workflow for production

You'll need to save the workflow and then click on the Activate toggle on the top right of the screen to activate the workflow. Your workflow will then be triggered as specified by the settings in the TheHive Trigger node.

# FAQs

# How to configure a Webhook in TheHive?

To configure the webhook for your TheHive instance follow the steps mentioned below.

  1. Copy the webhook URL from TheHive Trigger node.
  2. Add the following lines to the application.conf file. This is TheHive configuration file.
notification.webhook.endpoints = [
    {
        name: WEBHOOK_NAME
        url: WEBHOOK_URL
        version: 0
        wsConfig: {}
        includedTheHiveOrganisations: ["ORGANIZATION_NAME"]
        excludedTheHiveOrganisations: []
    }
]
  1. Replace WEBHOOK_URL with the URL you copied in the previous step.
  2. Replace ORGANIZATION_NAME with your organization name.
  3. Execute the following cURL command to enable notifications.
curl -XPUT -uTHEHIVE_USERNAME:THEHIVE_PASSWORD -H 'Content-type: application/json' THEHIVE_URL/api/config/organisation/notification -d '
{
    "value": [
        {
        "delegate": false,
        "trigger": { "name": "AnyEvent"},
        "notifier": { "name": "webhook", "endpoint": "WEBHOOK_NAME" }
        }
    ]
}'