AutoFill Settings

Settings

JavaScript API Documentation


Enable

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.

Default: Off

The app also has a JavaScript API that can notify your page when Kiosk Pro successfully autofills a username & password pair for a specific URL. This can be used to immediately trigger submission after a form is autofilled.

Documentation and sample code for this API can be found here.


Matched URLs

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
Wildcard examples:
  • '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.

Still stuck? How can we help? How can we help?