Configure the webhook in LibreNMS

Configure webhook endpoints so that LibreNMS can use the endpoint to communicate with Incident Response.

Before you begin

Role required: Responder, Manager, or Administrator

About this task

Note: While this integration with a third-party product is supported, the documentation here is based upon information provided by that third-party. More current information about the operation of that third-party’s system may be available from them directly.

Procedure

  1. Log in to your LibreNMS account.
  2. Navigate to Alerts > Alert Transports.
    Alert transports.
  3. Click Create alert transport.
  4. In the Alert Transport form, fill in the fields:
    Field Description
    Transport name Name for the transport.
    Transport type Select API.
    Default Alert Set to ON.
    API Method Select POST.
    API URL Webhook URL copied from Incident Response. Cut the API key at the end of the webhook URL starting at the ?.
    Options Paste the API key at the end of the webhook URL. Remove the question mark(?) before the api_key.
    headers Enter Content-Type=application/json.
    body Payload copied from Incident Response.

    Alert transport form.

  5. Click Save Transport.

What to do next

Add the transport to the alerts that you want Incident Response to handle.

  1. For alert configuration, navigate to Alerts > Alert Rules.
  2. Create a new alert rule and enter all the required alert rule details.
  3. In Transports, select the webhook created earlier.

    Alert rule.

  4. Click Save Rule.