You use the Secure Form Fill Admin Client (Oracle Enterprise Single Sign-On (ESSO) Administrative Console) to create secure form fill configuration files for your custom secure form fill apps in Oracle Identity Cloud Service. Use these instructions to create secure form fill configuration files and then import those files into Oracle Identity Cloud Service.
Note:This documentation explains, at a high level, how to use the Secure Form Fill Admin Client only as it pertains to custom secure form fill apps and Oracle Identity Cloud Service. For additional instructions, see the help in the ESSO Administrative Console.
- Launch the Secure Form Fill Admin Client.
- Right-click Applications, and then choose New Web App. Alternatively, use any of the following options:
- Click Applications, Add, and then choose Application Type: Web in the first pane of the wizard.
- Choose Insert, Application, and then choose Application Type: Web in the first pane of the wizard.
- On the Add Application dialog, enter the name of the application.
Important:The application name must be the same name that you use when you create the secure form fill application in Oracle Identity Cloud Service.
- Leave all other default options selected, and then click Finish.
- Choose the Logon form type. This form is used to set up your Web app template.
Note:No other form type is supported at this time.
- In the Address field, enter the URL for the Web app, click Go, and then navigate to the login page.A list of all fields on the login page appear on the bottom of the screen. Select any field in the list on the bottom of the screen to highlight the field on the page.
- Using the fields on the bottom of the screen, complete the following steps:
Do no use the Third Field or Fourth Field options.
Do not use the Allow multiple field designation option.
Only use ordinals if field names or attribute level matching is not possible. Using ordinals is less amenable to page changes or differences across browsers, and are not recommended in most scenarios.
- Select the user name field, right-click, and then choose Username/ID.
- Select the password field, right-click, and then choose Password.
- Select the submit button, right-click, and then choose Submit.
- Click OK.
- On the Web dialog, make any of the following changes as necessary.
Click Edit to make changes. This is the URL or the URLs of the form to configure. For applications that have varying text in their URLs, you can use substrings or regular expressions to specify how to match the variable text.Your Match Type change options are:
Exact Match. Exact match matches a URL exactly as specified. This is generally an edge case and rarely used.
- ? matches any single character.
* matches zero or more occurrences of any character. If wild cards are used, to avoid a potential security issue, do not perform mid-string wildcard matches. Always exact match the start of the URL, for example,
Regular Expressions. This is the recommended option. Use the set of regular expressions to specify a string pattern that the form-fill agent should recognize as a match, for example,
Click a field, and then using the Edit button, adjust the primary form fields used for detection and injection of the user name and password fields as well as the submit button.
Do not use the SendKeys or the SendKeys using journal hook options.
Check each field type to ensure that it is the appropriate type (such as Password for password input fields, and so on).Your Field options are:
Field Identification. Allows you to fine tune how the input fields for the form are located. Field identification can be adjusted for any form field. Click the ellipsis to display the Field identification options. Identify fields by:
Name. The default and recommended option. Beware that not every input field has a name or sometimes the name is not consistent every time the page is loaded. If so, then it is recommended to use the Matching option.
Ordinal. This option identifies fields based on sequence. This option is not the recommended alternative since it is easily impacted by minor changes to the page. Also, the fields and the field ordinals can be inconsistent across browsers.
Matching. Identifies fields based on tag types, attribute values, HTML, and so on. This option is the recommended option if Name is not possible. Often, matching is used to match the “id” attribute of the input field or a regex on the name attribute. Matching can be a regex, substring match, or whole string match.
Events. Pre Inject and Post Inject events allow secure form fill to trigger a specific event on the field before and after injecting the credentials into that field. This is useful as some fields will not recognize that injection has occurred unless a specific event is triggered in that field. Event values are: blur, change, click, focus, focusin, focusout, input, keydown, keypress, keyup, and mouseover.
Create or modify granular page matching criteria for the selected web form.
Secure Form Fill in Oracle Identity Cloud Service uses the matching criteria you supply here to distinguish among similar forms.
Matching can also be used to refine the detection match criteria, that is, the set of HTML tags and values you use to identify a specific field to perform more specific matching beyond just the form fields themselves.
Do not change these settings.
- Click OK.
- Use the following tabs to make any necessary changes:
Note:Do not change any other options on any other sub tabs other than those listed in the table below.
Enter a description for the Web app.
Add, edit, or delete forms. This option allows you to set all the forms relevant for this Web app. Use this option if you have multiple login forms for your Web app.
All other settings are not required for secure form fill and should not be changed.
Error Loop TabSecure form fill supports the detection of an error loop condition. Error loop conditions generally occur if secure form fill has the wrong credentials for the Web app and attempts to submit these credentials repeatedly to the Web app.
Logon timeout (sec.). The maximum time in seconds between successive logon attempts before a logon error is triggered.
Max. retries. The maximum number of retries (after first try) allowed before a logon error is triggered.
Logon Loop Grace Period. Allows control over the response during login grace period (for example, controls reinjection).
Auto-submit. Use this option to turn auto-submit on or off for all forms used by the app.
- Click File, and then Save.
Tip:Name the Web app file, the *.ini file, and the name of the Oracle Identity Cloud Service app with the same name.
- To export the file, click File, Export, select the application to export, and then click OK.
- Name the file.
Important:The *.ini file name must match the name of the application created in Oracle Identity Cloud Service.