Customizing Blocked HTML Template Page¶
When Web Safety detects the prohibited access attempt, it replaces its contents with “403 Forbidden” HTTP error page. Template for this page is stored in /opt/websafety/etc/blocked_page.html file. This is an ordinary HTMLs file which can be customized according to your needs. Upon blocking some macros in this file are replaced with their actual values.
Available macros include:
- INCIDENT
ID of the blocked HTTP object, this can later be used to find more information about the object in the access.log or in Web UI / Monitoring / Surfing History.
- USER_NAME, USER_IP and POLICY
User name (if set up in Squid), user IP address and matched filtering policy.
- URI
Requested URL of the blocked object.
- DURATION
Scan duration in milliseconds.
- MODULE
Name of the filtering module that blocked the object.
- RESULT_ID and RESULT_INFO
Detection results in human readable form (why the object was blocked). If object was blocked because of adult language detection the actual reason for blocking is within the HTML comments tag so that it is not directly visible. To see it right click on the blocked page in your browser and select Show HTML Source menu. To always show the detected information, clear the [ ] Hide explicit scan results on the blocked page checkbox in Safety / Policies / Policy / Advanced.
- VERSION
Version of the product.
- SERVERNAME
Name of the server where detection occurred.
- TIMESTAMP
Date and time of block.
Note
When AdBlock or Online Privacy module detects a forbidden URL and browser that sent the request seems to be expecting the image back, Web Safety uses transparent gif located at /opt/websafety/etc/transparent.gif as blocked placeholder. It hides the advertised images nicely in some browsers and improves usage experience of proxy users.