WebHooks

With QLM Enterprise v11, QLM can invoke external webhooks when certain events occur.

Events fall into two general categories:

  • License events: these events pertain to changes to the license keys data.

  • Customer events: these events pertain to changes to the customer's data.

License Events

Customer Events

Configuring WebHooks

To configure your webhooks:

  • Launch the QLM Management Console

  • Go to the Manage Keys tab

  • Click Sites and select your site

  • Go to the Server Properties tab

  • Locate the webhook events section (if you do not see this section and you are running QLM Enterprise v11, upgrade your DB schema from the General tab in the same editor, then close the editor and reopen it).

  • For each event, set the URL of the webhook that you wish to invoke. If you need to invoke more than one webhook per event, separate the URLs with a semi-comma.

  • Click Ok

WebHooks Payload

When a webhook is invoked, QLM sends a JSON payload with specific information about the affected object along with the event type.

To verify the authenticity of the request, the webhook request header includes a SHA256 value of the request's content + a secret key. The hash value is stored in a header entry called: X-QLM-Signature

WebHooks Settings

WebHooks settings allow you to control the behavior of webhooks processing.

Retry Mechanism

If a webhook invocation fails, QLM adds the webhook call to a retry queue and will retry at a regular interval for a period of time, as specified in the webhook settings.

Logging

All webhook invocations are logged by QLM and stored in a log table.

Configuration

To configure your webhook settings:

  • Launch the QLM Management Console

  • Go to the Manage Keys tab

  • Click Sites and select your site

  • Go to the Server Properties tab

  • Locate the webhook settings section (if you do not see this section and you are running QLM Enterprise v11, upgrade your DB schema from the General tab in the same editor, then close the editor and reopen it).

Last updated