Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page
LIB:_Version
LIB:_Version

Table of Contents
stylenone

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 thefollowing 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:

Code Block
languagetext
/usr/local/cpanel/startup 

Additional documentation

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("authentication","login") and label = "whm" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("authentication","login") and label = "cpanel" and space = currentSpace()


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("authentication","login") and label = "whm" and space in (currentSpace(),"CKB")


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("authentication","login") and space = "DD"