Skip to content

How to Add a Local Mattermost Endpoint#

This topic provides step-by-step instructions for adding a local Mattermost 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 Mattermost.

  5. Enter the following information:

    - Name *

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

    - URL *

    The URL used to connect to your Mattermost instance.

    - Username

    The default username used to send messages. If left blank, the default username configured in Mattermost will be used.

    - Channel

    The default channel used to send messages. If specified, this overrides the default channel set in the Mattermost webhook configuration.

  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.

    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.

  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