Kiosk Pro Enterprise allows you to automatically fill in login information for certain URLs to provide authentication credentials for site content that would not otherwise be accessible for your visitors.
Documentation and sample code for this API can be found here.
This setting allows you to define one or more URLs (web addresses) where the following username/password pair will be applied.
The ‘Matched URLs’ setting can accept multiple URLs, which should be separated by semicolons. It also supports wildcard characters so you can match multiple or dynamic URLs in that way as well:
- ? - matches any character zero or one time, matching only one time
- * - match any character zero or more times, matching as many times as possible
- '1' is matched by: '*' or '?'
- '12' is matched by: '*' or '**' or '*?' or '*2' or '1*' or '??' or '1?' or '?2'
- '123' is matched by: '*' or '???' and so on
For example, if you were using a URL that appended a dynamic parameter like ‘http://www.example.com/?search=term’ where ‘term’ could be any value, you could use a wildcard match.
Setting the ‘Matched URL’ setting to ‘http://www.example.com/?search=*’ would mean that any URL that matched the part of the string preceding the ‘*’ character would be autofilled.
Username & Password
This is the username and password you would like to be used on the site. They should be given exactly as they would be filled in the associated URL.
Username & Password Field Identifiers
These are the identifiers of the username and password fields in the .html source code, which allow Kiosk Pro to identify which fields to fill in.
To determine the correct field identifiers, you will need to look through the source code of the page to find either the id or the name associated with each field. This can be viewed in most browsers by right-clicking the page and choosing View Page Source, or right-clicking the input field and selecting ‘Inspect Element’.
As sites may define one, the other, or both, you can define this by filling in either the id or the name associated with the input field.
As an example of what you might be looking for in the source:
<form> <div class="login-form" id="login"> <label class="username-label">User name:</label> <input name="username" type="text" value=""> <label class="password-label">Password</label> <input id="secret" type="password" name="password" value=""> </div> </form>
In this example, the Username Field Identifier would be 'username' (as that is the name of the input field associated with the username and no id is provided) and the Password Field Identifier could either be set as 'secret' or 'password' (as both have been provided for this field, either can be used.)
You can also select inputs based on parent tags by using a colon. Using the code above as an example, you could set the Username Field Identifier to "login:username" where 'login' is referencing the div ID, and 'username' references the input name.