Configuring event notifications

You can configure HYCU for Azure to send notifications when new events occur in your data protection environment. This allows you to monitor and manage your data protection environment more efficiently, and to immediately respond to the events if required. You can set up emails or webhooks as a notification channel.

Depending on which notification channel you want to use, see one of the following topics:

• “Creating email notifications”

• “Creating webhook notifications”

Creating email notifications

Procedure

1. In the Notifications dialog box, click the Email tab, and then click  New.

2. In the Subject field, enter a subject for the email notification.

3. From the Category drop-down menu, select one or more event categories. To include all categories, click Select All.

4. From the Severity drop-down menu, select one or more severity levels of events. To include all severity levels, click Select All.

5. In the Email address field, enter the recipient's email address. If you are entering more than one email address, make sure to press the Spacebar after entering each one.

6. Click Save.

Your changes take effect immediately and email notifications are sent to any email address that you specified in the notification settings.

You can later edit settings for existing email notifications (click  Edit and make the required modifications) or delete the ones that you do not need anymore (click  Delete).

Creating webhook notifications

Procedure

1. In the Notifications dialog box, click the Webhooks tab, and then click  New.

2. In the Name field, enter a name for the webhook notification and, optionally, its description.

3. From the Category drop-down menu, select one or more event categories. To include all categories, click Select All.

4. From the Severity drop-down menu, select one or more severity levels of events. To include all severity levels, click Select All.

5. In the Post URL field, enter the URL of the endpoint the webhook notifications should be sent to in one of the following formats:

   https://<Host>
   https://<Host>/<Path>

6. Only if the receiving endpoint requires sender's identification. In the Secret field, enter a secret for authentication.

7. Click Next.

8. Optional. Customize the body of the request that is sent by HYCU for Azure. You can click the appropriate fields in the HYCU fields list to easily insert event variables into the body.

   i Important  Make sure the format you define in the body is supported by the platform to which webhook notifications will be sent.

   For details on the webhook data format that HYCU for Azure sends to the specified URL, see “Webhook data format”.

9. Click Save.

Your changes take effect immediately and webhook notifications are sent to any URL that you specified in the notification settings.

You can later edit settings for existing webhook notifications (click  Edit and make the required modifications) or delete the ones that you do not need anymore (click  Delete).

Webhook data format

The webhook data format is defined by:

• HTTP request header sent by HYCU for Azure
• HTTP request body sent by HYCU for Azure

HTTP request headers

The request headers are sent in the following format:

content-type = application/json
x-hycu-signature = base64(hmac(body, secret, 'sha256'))

HTTP request body

The request body is sent in the following format:

{
"severity": "<severity-value>",
"authorityIdentifier": "<authorityIdentifier-value>",
"created": "<created-value>",
"details": "<details-value>",
"category": "<category-value>",
"message": "<message-value>",
"taskUUID": "<taskUUID-value>"
}