Skip to content

Add a Local Webhook Endpoint#

This topic provides step-by-step instructions for adding a local Webhook endpoint in TheHive.

Once created, this endpoint is available solely for your organization. To create an endpoint for multiple organizations, refer to the Add a Global Endpoint topic.

Required permissions

Only users with the manageConfig permission can manage local endpoints in TheHive.

Procedure

  1. Go to the Organization view from the sidebar menu.

    Organization view

  2. Select the Endpoints tab.

    Endpoints tab

  3. Select .

  4. In the Endpoint creation drawer, select Webhook.

  5. Enter the following information:

    - Name

    The endpoint name, used to identify this webhook integration in TheHive. This name must be unique, as two endpoints can't have the same name.

    - URL

    The URL to which TheHive will send webhook requests.

    - Version

    Enter the webhook version supported by your external system. This determines the payload format and request structure that TheHive will use when sending data.

  6. In the Authentication section, select an authentication type if required.

  7. In the Proxy settings section, select the proxy settings you want to apply:

    • Default configuration
    • Disabled
    • Enabled:
      • Enter the type of protocol, either HTTP or HTTPS.
      • Enter the IP address or domain name of the proxy server.
      • Enter the port number used by the proxy server.
      • Turn on the Authentication toggle if you want to require a username and password to authenticate with the proxy server.

  8. Add a certificate authority (CA).

    The server's SSL/TLS certificate must be trusted by the Java virtual machine (JVM) truststore for secure connections. If your server uses a certificate from an internal CA or self-signed certificate, add it to the JVM truststore first. See Configure JVM Trust for SSL/TLS Certificates for instructions.

    You can turn off the Don't check certificate authority toggle to bypass certificate validation, but this isn't recommended as it may compromise connection security.

  9. Turn on the Disable host name verification toggle if you want to bypass the verification of the server's host name against the certificate.

  10. Select Confirm.

Next steps