Configure System Error Notifications Using Custom Templates

Last updated
Save as PDF

System errors can be communicated via end-user notifications, using either the Skyhigh default template or a custom template. You can select the custom end-user notification setting to define notification preferences. To create a custom setting, you can create a new configuration that includes language, collection, and block reason. These settings are important because, when the Secure Web Gateway needs to perform a specific action, the system will reference the settings applied to the relevant rule.

Create an End User Notification Template

You can create an end-user notification template by navigating to Policy > End User Notification Pages > Actions and clicking New Template. You can also clone the existing Skyhigh default template.

To create a new end-user notification template:

Navigate to Policy > Web Policy > End User Notification.
On the End User Notification page, you can view the collection of Skyhigh default templates and Custom templates.
A notification template includes the header, title body, button, background, variables, footer, and acceptable usage policy. Several default templates are available, you can clone and modify them to suit your requirements. You can edit the header, title body, button, background, variables, footer, and acceptable usage policy. For details, see Create a Template for an End User Notification Page.

Clone a Template

You can use the Skyhigh default template and replicate it to create a custom template.

To clone and edit the existing Skyhigh default templates:

Go to Policy > Web Policy > End User Notification Pages.
Navigate to the Skyhigh Default tab or Custom Templates, and select the template you want to clone.
Select Clone from the Actions menu.
Click Clone.
Enter the name for the cloned template and click Save.
You can find the newly saved template under the Custom Collection tab.

Configure Notification Settings

You can configure settings for notification templates. The settings include language, collection, and block reason.

To configure custom notification settings:

Go to Policy > Web Policy > Feature Configuration.
Go to Feature Config tree > End User Notification settings > New Configuration.
Enter a name for the End User Notification Settings.
The default setting allows you to configure the language for the template, as well as the collection and block reason.
Select the required Language Setting either Auto (browser) or Force to (Language).
Select the Collection from the available list:
- Custom Template: A template you will create.
- Skyhigh SAML: Provided by Skyhigh.
- Skyhigh Default: Another default template provided by Skyhigh.
Select the required Template from the list.
Enter the reason for blocking the user.
Click Save.
Click the yellow badge to publish.

Settings are now configured for the template.

Customize System Error Notifications using Custom Templates

Authentication required, Bad Gateway, Bad Request, and DNS resolution failures are system errors that are mapped to the default end-user notification setting. You can now customize the end-user notification settings for the system errors using a custom template.

To select the required end user notification template for system errors :

Navigate to Policy > Web Policy > Feature Configuration.
Click End User Notification Settings.
You can view the list of system errors under the System Error Mapping section.

Screenshot (18)_2.png

Select the required system error in the System Error Mapping section to configure the corresponding end-user notification.
Click the Default dropdown and select the appropriate setting from the list.
The settings will include whatever has been configured in the default or custom template.

Screenshot (19)_1.png

Click Save.
Click the yellow badge to publish your changes.

System errors are now configured with custom end-user notifications.