How to 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
-
Go to the Organization view from the sidebar menu.
-
Select the Endpoints tab.
-
Select or Add a new endpoint.
-
In the Endpoint creation drawer, select Webhook.
-
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.
-
In the Authentication section, select an authentication type if required.
-
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.
-
Add a certificate authority.
For more information about configuring SSL, refer to the Configure SSL topic.
Use certificates only from trusted, predefined authorities for secure connections. Custom certificate authorities are not allowed.
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.
-
Turn on the Disable host name verification toggle if you want to bypass the verification of the server's host name against the certificate.
-
Select Confirm.