Webhook Authentication Methods

Bringg supports the following authentication methods for Webhooks:

FieldDescription
JSON Web Token (JWT)This method consists of three parts: a header, a payload, and a signature. The header contains information about the type of token and the algorithm used for the signature. The payload contains the claims or information about the user or entity being authenticated. The signature is created by hashing the header and payload with a secret key to ensure the integrity of the token.
OAuth 2.0Include Client ID, Client Secret, Auth URL, Path, Request Type, and Scope.
Static HeadersInclude an authorization token or API key in the header of the HTTP request.

You can configure JWT and OAuth 2.0 via the Authentication Methods page.

Configure static headers within each individual webhook - see Step 5 of the Procedure outlined in Bringg Webhooks for instructions.

To add a new Authentication Method for webhooks:

  1. Select your username > ​Settings > Platform Integrations > Authentication Methods
  2. Click Add Authentication Method
  3. In Use for, choose Webhooks
  4. Enter a Display name for the authentication method that you and other members of your team will recognize.
  5. Select the relevant type, either JWT or OAuth 2.0
  6. Enter the relevant details for the selected method.
    1. OAuth2.0
      1. You must include a Client ID, Client secret, Authorization URL (and path to an endpoint to retrieve tokens), and the request type/
      2. (Optional) If you'd also like to add static headers to all webhooks using this authentication method, you can add the relevant key-value pairs in the Headers section.
    2. JWT
      1. You must include a Signature key, the Issuer, the Algorithm, the Audience, and the Subject.
Images of adding OAuth 2.0 (left) and JWT (right) Authentication Methods

Images of adding OAuth 2.0 (left) and JWT (right) Authentication Methods