9.2.3 Authentication error message file (webauth.msg)

The authentication error message file (webauth.msg) contains the messages presented to the user when an attempt to log in or out of Web authentication fails.

You can configure the Switch to send custom error messages instead of the default messages. This process requires that you create a file containing nine lines of data, each corresponding to a specific message as described in the table below.

Table 9-5: Contents of each line in the authentication error message file
Line number	Description
1	The message output when the user enters the wrong login ID or password, or when an authentication error is caused by the Web authentication DB. Default message: "User ID or password is wrong.<BR>Please enter correct user ID and password."
2nd line	The message output when an authentication error is caused by RADIUS. Default message: "RADIUS: Authentication reject."
3rd line	The message output in an environment configured to use RADIUS authentication when the Switch cannot establish a connection to the RADIUS server. Default message: "RADIUS: No authentication response."
4th line	The message output when login fails due to an error in the Switch configuration or a conflict with other functionality. Default message: "You cannot login by this machine."
5th line	The message output when a minor error occurs in a Web authentication program. Default message: "Sorry, you cannot login just now.<BR>Please try again after a while."
6th line	The message output when a major error occurs in a Web authentication program. Default message: "The system error occurred.<br>Please contact the system administrator."
7th line	The message output when a critical error occurs in a Web authentication program. Default message: "A fatal error occurred.<BR>Please inform the system administrator."
8th line	The message output when logout fails for such reasons as the CPU becoming overloaded while processing the logout request. Default message: "Sorry, you cannot logout just now.<BR>Please try again after a while."
9th line	The message output when a user who is not logged in issues a logout request. Default message: "The client PC is not authenticated."

<Structure of this section>

(1) Setting conditions

If a line contains only a line break, the switch outputs the default message for that line.
When saving the file, specify CR+LF or LF as the line break code.
Each line can contain a maximum of 512 single-byte characters, including HTML markup and the line break tag <BR>. Any excess characters are ignored.
If the authentication error message file contains more than nine lines, subsequent lines are ignored.

(2) Points of Authentication Error Message File Creation

The text in the authentication error message file is handled as HTML text by the Web browser. If you include HTML markup in an error message, the message is formatted accordingly.
Each message must occupy one line in the file. If you want to insert a line break in an error message, use the HTML line break tag <BR>.

(3) Setting example

The following figure shows an example of the source code for the authentication error message file (webauth.msg).

Figure 9-14: Example of an authentication error message file (webauth.msg)

(4) Display example

The following figure shows an example of the login failed page displayed to a user who enters the wrong password in an environment where the default authentication error message file applies.

Figure 9-15: Login failure screen (browser display example)