Form Fill Authentication (via Plugin)
The Form Fill Authentication (via Plugin) Type allows administrators to configure an application to use the RapidIdentity Browser Plug-in.
This configuration is available when administrators select Form Fill Authentication (via Plugin) as the Type in the SSO tab of the Add Application menu.
Note
These configuration settings are dependent on the system administrator having a good understanding of the inherent functionalities of HTML5.
The exact steps necessary to configure the authentication vary based on how the service provider has its authentication process configured. As a representative example, form fill to Gmail is shown.
Create an application definition.
Complete the required fields in the Details tab. In the SSO tab, select Form Fill Authentication (via Plugin) as the Type. The next action here will be to edit Login Step 1 by clicking the pencil icon.
Gmail's login process requires two steps: first to enter the Email address on the first page and then the password on the next page. The main information should be entered in the Edit Login Step menu, then each of the granular configuration menus will start with defining an Element. Enter a Step Name for the step, the expected Page Title (for verification purposes), as well as Match Attempts and Retry Interval in Seconds. Then click to Add Another Element.
Table 352. Form Fill Authentication (via Plugin) FieldsField Name
Description
Step Name
A name for the step (e.g., Enter Username)
Page URL Matching
The URL for which information will be form filled in the step. Wildcard (*) URLs are supported (e.g. https://www.example.com/*)
Page Title Matching
The name of the URL page (e.g. Gmail). If a wildcard URL was listed in Page URL Matching, this field should be an asterisk.
Match Attempts
The number of attempts the browser plugin should attempt to complete the form.
Retry Interval (seconds)
The time interval for the browser to "wait" before attempting to match the Page Elements for each Match Attempt.
Each step will contain the configuration details required to describe each action the browser is to take. The first step directs the browser to the Google Mail URL, has it enter the user's email address, and then tells it to click Next. This requires configuring multiple Steps, their Elements, and the Actions performed within. Defining this element will instruct the browser on the steps to enter the email address.
Note
The element being defined must be unique on the page in order for the browser to find it successfully.
Table 353. Create Element FieldsField
Description
Name
Provide a brief name for the element that will be part of this step.
Find By
Use the drop-down list to determine which element to locate on the website on which to perform the next action. The choices are as follows:
By ID - searches for HTML elements by their ID
By Name - searches for HTML elements by their name (e.g., <input name="example"/>)
By Class - searches for HTML elements by their CSS class
By Tag - searches for HTML elements using a defined element tag (e.g., <button>)
By XPath - searches for an HTML element using an XPath descriptor
By Selector - searches for an HTML element using its Selector
Find by Value
Enter the exact value or a code string to represent the item chosen from the Find By drop-down list.
Required
Clicking this checkbox ensures that the browser will not continue with the steps until this element has been met.
To create an Action for the browser to perform on the selected Element, click Add Another Action. For this Google Mail application, choose Action Type Text and give it the value
%mail%.
Table 354. Add Another Action Menu FieldsField
Description
Expected Value(s)
Action Type
Choose an Action Type from the drop-down menu.
Text
The text that should be entered into the chosen Element. This text should be entered as an expression
Password
The password that should be given to the chosen element. This password can be entered manually or chosen from available saved logins
Click
Click the chosen element
Checkbox
Determine whether the item should be selected as a checkbox
Select
Choose a value from a drop-down option. The option will need to be defined
Send Event
Send a javascript event to an element on the web page. RapidIdentity supports the common Change, Focus, and Blur events, and provides an Other type with the opportunity to define any type of arbitrary event that can be sent to the web page or web application
Delay
Introduce a delay in milliseconds before moving to the next action
Enable
Enable the chosen element
Click Update to return to the Edit Element menu, and Update again to return to the Add Login Step menu. Using the above information on functionality, add the following configuration details to finish setting up a Google Mail via Plugin application.
Table 355. Complete Gmail via Plugin ApplicationStep
Element
Action
Name: Enter Username
Name: Click Next Button
Find By: By ID
Find by Value: next
Required: [checked]
Action Type: Click
Name: Enter Password Page URL Matching: [Provide URL for initial login]
Page Title Matching: Gmail
Match Attempts: [Recommend 5]
Retry Interval (Seconds): [Recommend 1]
Name: Enter Password
Find By: By ID
Find By Value: Passwd
Required: [checked]
Action Type: Text Value: %session.password%
Click Update until you return to the main menu, then click Save to return to the Catalog. The application is now ready to use.