REST

This section details how to configure REST notifications.

How to create a REST notification

1. Log in to Horizon Administration Interface.

2. Access REST from the drawer or card: Notifications  REST.

3. Click on Add REST notification.

4. Fill in all mandatory fields.

  • Name* (string input):
    Enter a meaningful REST notification name.

  • Event type* (select):
    Select the event type to notify (certificate or request).

  • Event* (select):
    Select the event to notify.

  • Retries in case of error (int):
    Select the number of times Horizon should retry to send the notification in case of error. The default value is set to 10.

  • HTTP Method and URL*: (select & string input)
    Choose the HTTP method and the destination URL for your notification. The URL is a template string and can contain keys for parametrization.

  • Proxy: (select)
    Define a proxy for this REST API call.

  • Timeout* (finite duration):
    Connection timeout when executing the REST API call. Must be a valid finite duration.

  • Accepted response HTTP code* (multiselect | input):
    Response codes meaning the REST call was a success. If another one is received, a failure will be logged.

  • Authentication type and credentials* (select & select):
    Choose the authentication type and the credentials to perform the authentication. Custom authentication allows the credentials values to be accessible in headers.

  • Headers (input string & input string):
    Choose the header name and value. Header values are template strings and can contain keys for parametrization.

  • Body* (string input):
    Enter the REST body. It is a template string and can contain keys for parametrization.

You can click on the "Dynamic attributes" drawer in order to get a range of possibilities from which one or more may be chosen.

6. Click on the save button.

You can edit Edit RESTs, duplicate Duplicate RESTs or delete Delete RESTs the REST Notification.