Skip to content

How to Add a Local HttpRequest Endpoint#

This topic provides step-by-step instructions for adding a local HttpRequest 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 or Add a new endpoint.

  4. In the Endpoint creation drawer, select Http.

  5. Enter the following information:

    - Name

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

    - Method

    Select an HTTP method from the dropdown list.

    - URL

    The destination URL where the HTTP request should be sent. This must be a valid and accessible endpoint.

  6. Select in the Headers section to add headers.

    Enter a header key and its corresponding value to include in the HTTP request. Use headers to send authentication tokens, content types, or other metadata required by the external system.

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

  8. 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.

  9. 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.

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

  11. Select Confirm.

Next steps