How do I use webhooks with vRx? (Use Cases)

Use webhooks to further automate your security posture

Some events in vRx generate a webhook post request. These webhooks can be "posted" to any platform that can receive webhooks. These platforms can then be used to perform other actions, such as, sending emails, creating tickets, or even performing other tasks in vRx via the API. 

Use Cases

• Email notifications 
• Slack notifications 

Automation Platforms (Suggestions)

• n8n
• Azure Logic Apps
• Zapier

Webhooks

Webhooks are used as the triggering event for automation workflows. 

Configuring webhooks in vRx:

1. Open your automation platform - Create a webhook node - Copy the webhook URL.
2. At your vRx dashboard, navigate to Settings -> Integrations -> select the "webhook" tag to add new Webhook integration.
3. In the new webhook integration, configure the following:
   
   1. Display name of the webhook.
   2. Paste the webhook URL.
   3. Select "Setup Integration".
   4. Select "Send Test Event" to test your integration.

   5. 

Webhook Integration Examples

n8n

Templates:

• vRx_Email_FailedEvents_n8n.json

Azure Logic Apps

Templates:

• azLogicApp-Failedtask.json

Zapier

Templates:

• How-to-get-notifications-to-slack/email

Manual configuration:

1. Navigate to Zapier and sign in 
2. Create a new Zap 
3. Trigger
   1. App event - Webhook 
   2. Event - Catch Raw Webhook 
   3. Test trigger 
      1. Configure the webhook integration with the provided webhook url
      2. Send a test Event and confirm it is received by Zapier
      3. Perform the action in vRx you wish to be the triggering event. As an example, If you wish to trigger the Zap when a new vulnerability is identified the test event will work. If you wish to receive email notifications based on failed tasks, Run a task (patch an asset). This will generate the corresponding webhook. 
   4. In this example we will use tasks in a failed status.
   5. Once A patch has started in vRx, select the dropdown box under "We Found a request" to sort through the different posts requests that have been sent to Zapier.
   6. Locate the request that starts with "taskEndpointsEventEndpoint" then click continue
4.   Action:
   1. App - Filter by Zapier, then click continue
   2. Under Filter setup and testing select fill out the Only continue if section as follows 
      
      1. Task Endpoints Event Organization Endpoint Patch Patch Packages organization Endpoint Patch Patch Packages Action Status action Status Name 
      2. (Text) Exactly matches 
      3. Failed
         1. Repeat these steps for any other parameters you want to add.
   3. Click continue 
5. Action: 
   1.  App - Email by Zapier
   2. Event Send Outbound Email 
   3. Set up Action 
      1. Fill out the required information 
      2.  You can use data from the webhook to populate parts of the email subject and body. 
      3. Suggested information 
         1. Asset Name - "task Endpoints Event Endpoint endpoint name"
         2. Action Status - "task endpoints event organization endpoint patch patch packages organization endpoint patch patch packages action status action status name"
         3. Message - "task endpoints event organization endpoint patch patch packages organization endpoint patch patch packages status message"
         4. Patch - "task endpoints event organization endpoint patch patch packages organization endpoint patch patch packages patch patch name"
         5. Patch Description - "task endpoints event organization endpoint patch patch packages organization endpoint patch patch packages patch patch description"