Page tree
Skip to end of metadata
Go to start of metadata

For cPanel & WHM version 60

Overview

If a user fails to authenticate with cPanel through a custom login form, the /var/cpanel/failurls file allows a reseller to redirect that user to a custom error page.

Requirements

Make certain that your entries in the failurls file meet the following requirements:

  • Each entry must be on a separate line.
  • Each entry must be a static URL.
    • For example: http://example.com/index.php?failed=1 is not a valid entry because it is a dynamic URL.
  • The login page must pass dynamic content via hidden POST variables. GET query strings will fail because they will not match any entry in the failurls file.
    • For example: <input type="hidden" name="failurl" value="http://example.com/failed.html" /> is a valid hidden POST variable.
  • The failurl value in the custom login form must match one of the entries in the failurls file.
    • For example: http://example.com/failed.html in the failurls file matches the <input type="hidden" name="failurl" value="http://example.com/failed.html" /> hidden POST variable.

Restart cPanel

After you create the entries in the failurls file, use the following command as the root user to restart cPanel:

/usr/local/cpanel/startup 

Additional documentation

There is no content with the specified labels

There is no content with the specified labels

There is no content with the specified labels