Assisted Sign-On configuration
To implement Assisted Sign-On, you must configure an application and interrogate the appropriate user ID and password fields along with the login button. Use an application’s Credential Collection Editor to set up Assisted Sign-On.
You can also group identical ID and password combinations for situations where the same sign-on information applies to multiple applications. Assisted Sign-On can also help you handle situations where a user has multiple logins for a single application, such as credentials for a web application.
The Credential Collection Editor window is displayed when you click the More icon on the Credential property in the application properties grid.
To configure the Assisted Sign-On feature, click Add to create a reference of which credentials to configure for the application. The properties of the Credential Collector are divided into the following categories: Behavior, Controls, Optional, and Required.
| Property | Description |
|---|---|
| AutoFillOnCreate |
True, for the system to automatically add the login information when the login dialog is created. False if you do not want this information automatically filled in. |
| FailedLoginRematchAttempts | Number of failed login attempts allowed. The default is three (3). |
| FailedLoginRematchDetectTime |
The maximum amount of time (in milliseconds) for which a control rematch would be considered a failed login attempt and not a separate, additional login attempt. The default (recommended) is 5000, or 5 seconds. This property is used to prevent an infinite loop when a page rematches after a failed login attempt. If the FailedLoginRematchDetectTime threshold is too low and invalid credentials are supplied, causing the controls to rematch, the credentials are automatically used again. This action leads to an infinite loop of login attempts. This may also result in the lockout of the enterprise application user. |
| RequiresDomain |
In some cases, information is required, and the user ID and password, such as a domain name, a Personal Identification Number (PIN), or a region. Web applications typically use this additional information. To allow the additional information, enter True. The default is False. Note: You must handle the processing of the Domain information in your automation.
|
| LoginControl | Select the control used to send or process the sign-on information, such as a Sign In or Log In button. |
| PasswordControl | Select the control used for the password. |
| UserNameControl | Select the control used for the user ID. |
| Category |
Enter a value in this property to display a drop-down list and filter applications on the Assisted Sign-On Login window |
| Group |
This property identifies the particular application as part of a group. For instance, if you use the same user ID and password for multiple applications, you could assign all the applications to a group, which you would identify here. This way, you only set up the username and password once on the Enter Credentials window for all of the applications you assign to that group. The property is case sensitive when referenced in an automation. |
| ApplicationKey | Enter application key. This field helps to identify the application uniquely. The system defaults to the name that you assigned to the application, and it is case-sensitive when referenced in automations. The end user sees the application key on the Enter Credentials window. Include spaces if necessary to make your entry easier to read. |
You can use settings in the PegaRuntimeConfig.xml file to determine whether the Credential dialog box is displayed each time Runtime starts, whether the credentials are stored locally on the workstation, and determine the location of the stored credentials file (ASO.db). As a best practice, avoid using the Credential dialog box for an unattended automation.
| Property | Description |
|---|---|
| ShowDialogOnStart | With a value of True, the Assisted Sign-On Credential dialog launches automatically when Pega Robot Runtime starts. The default value is True. |
| StorePassword | When set to True, the password saves to the local disk of the user after saving the credentials on the Assisted Sign-On Credential dialog. |
| FileLocation | Enter the path location to store the ASO.db file. |
Check your knowledge with the following interaction.
This Topic is available in the following Module:
If you are having problems with your training, please review the Pega Academy Support FAQs.
Want to help us improve this content?