Page Comparison

An Event Forwarder rule is a webhook subscription that lets Avigilon Alta Access (the “sender”) send notifications to the third-party app (“receiver”) via a Target URL.

In order for For the Event Forwarder rule to work, Avigilon Alta Access follows the Immediate Confirmation model to validate the rule. Avigilon Alta sends an “Intent to Subscribe” HTTP POST request that includes an X-Hook-Secret header that contains a randomly generated string to the third-party app at the given target URL. The app must return an HTTP response that includes an X-Hook-Secret response header containing that same string. The Avigilon Alta cloud confirms the values match, and then allows the rule to be successfully created.

...

1. Create an Event Forwarder rule in the Avigilon Alta Control Center Access with https://api.mycompany.com/openpath-receiver as the target URL

   1. To learn how to create rules, refer to How do I use the Rules Engine?

2. Avigilon Alta’s cloud sends the app an HTTP request at https://api.mycompany.com like this:

   Code Block
   POST /openpath-receiver HTTP/1.1 Host: api.mycompany.com X-Hook-Secret: someLongRandomString12345 [other standard http headers, not relevant here][no request body]

3. The receiver app’s API must respond to that request with a 200 response code and the same X-Hook-Secret:

   Code Block
   HTTP/1.1 200 OK X-Hook-Secret: someLongRandomString12345 [other standard http headers, not relevant here][no response body]

4. Avigilon Alta finishes saving the rule and considers it now validated and active

...