References > Component Monitor Types > HTTP Monitors > HTTP Form Login Monitor

HTTP Form Login monitor

This component monitor tests the ability of a web server to serve web pages secured behind a forms-based login page. The test is performed by using the credential as the user name and password for the login form, retrieving the page behind the login form, and then searching the retrieved page for keywords that indicate either a successful or a failed login attempt.

The HTTP Form Login Monitor does not work on any login screens that are pop up.

Statistic

This component monitor does not compute a statistic.

Troubleshooting

For most form-based login pages, this component monitor functions without any customizations. But, some form-based login pages use unconventional HTML form tag names or form input tag names, and you need to assist the component monitor in identifying the names of these tags before the component monitor can function correctly.

This monitor does not work if the login control is located within an IFRAME HTML control.

If the component monitor cannot match the tag names in the login page against the list of expected keywords, you must add the actual tag name to the keywords list. SolarWinds SAM assists you with this by displaying an error status message if the component monitor is in a fail state: the error message lists all the form and form input names found in the HTML page, allowing you to identify the correct name so that you can type it in the appropriate Keywords field.

For example, consider the following HTML snippet with tags defining a form and some form inputs:

<form name="login_form" method="post" action="Login.aspx"><p>Status (optional): <input name="status" type="text" /></p><p>Username: <input name="nick" type="text" /></p><p>Password: <input name ="pswd" type="password" /></p><input type="submit" value="Submit" /></form>

In the example code, the actual login input tag name is "nick,” but testing the component monitor results in an error similar to the following:

Response page matches login error keywords Page contains 1 form(s). Form 'login_form' inputs: ( 'cust_id' 'nick' 'pswd' );  Assumed form with name = login_form as login form Assumed login input: name = status, password input: name = pswd

The error status message informs you that the component monitor incorrectly assumed the input tag with the name "status" was the login input. Recognizing this error, you correct it by adding the correct tag name "nick" to the list of keywords in the Login Control Keywords field: (login)|(name)|(email)|(nick)

Polling using Orion agent for Linux

This component monitor has the following limitations for Orion agent for Linux polling methods.

Does not support Kerberos authentication. Only basic and digest authentication types are supported when this probe runs using Orion agent for Linux. For Kerebos authentication on a Linux-based computer, select Agentless for the Preferred Polling Method on the monitor.

Field Descriptions

Description

This field provides a default description of the monitor. You have the ability to override the default description by adding to or replacing the text, which is automatically saved. The variable to access this field is ${UserDescription}.

Enable Component

Determines whether the component is enabled. Disabling the component leaves it in the application in a deactivated state not influencing either SolarWinds SAM application availability or status.

Credential for Monitoring

Select a credential that can log on to the web site. If the credential you need is not already present in the credentials list, use the Quick Credentials section to add a new credential.

Port Number

This field is the port number used for HTTP forms-based login sessions. The default value is 80.

Url

Allows you to specify the URL you want to monitor. The SolarWinds SAM variable ${IP} contained in the default value for this field attempts to monitor a web site at the IP address of the assigned node.

Host Header

Enter the address of the host header. For example, www.solarwinds.com.

Use Proxy

This check box allows you to use a web proxy to access the web site.

Proxy Address

This field allows you to specify the address of a web proxy to access the web site.

Ignore CA Errors

If checked, this indicates that Certificate Authorization (CA) errors will be ignored.

Ignore CN Errors

If checked, this indicates that Common Name (CN) errors will be ignored.

Accept Compression

If checked, indicates that compression is supported.

Login Form Keywords

This field lists the expected keywords that identify an HTML login form. The keywords are matched against the name attribute of the <form> tags found in the HTML of the login page. Each keyword in this list must be enclosed in parentheses '( )', and then separated from other keywords by a vertical bar '|'. The default keywords are: (login)|(auth)|(email).

Login Control Keywords

This field lists the expected keywords that identify the form's user name input element. The keywords are matched against the name attribute of the <input> tags found in the HTML of the login page. Each keyword in this list must be enclosed in parentheses '( )', and then separated from other keywords by a vertical bar '|'. The default keywords are (login)|(name)|(email).

Password Control Keywords

This field lists the expected keywords that identify the form's password input element. The keywords are matched against the name attribute of the <input> tags found in the HTML of the login page. Each keyword in this list must be enclosed in parentheses '( )', and then separated from other keywords by a vertical bar '|'. The default keywords are (password)|(pwd)|(passwd)|(psswd)|(pswd).

Login Failed Regular Expression

This field contains the regular expression for matching an unsuccessful login. This expression may appear anywhere in the HTML source of the page.

Login Success Keywords

This field contains the regular expression for matching a successful login. This expression may appear anywhere in the HTML source of the page.

Response Time Threshold

This field allows you to set the warning or critical threshold conditions based on the response time. The response time is the time in milliseconds it takes SolarWinds SAM to determine that a component is not Down and to retrieve any statistical data. See setting Application Monitor Thresholds for more information.

User Notes

This field allows you to add notes for easy reference. You can access this field by using the variable, ${UserNotes}.