Close popover

Table of Contents

Security policies settings

Version:

To authenticate users and manage sessions, configure security policies.

Password policies settings

Policy Notes Default value Min value Max value
Minimum operator identifier (ID) length 8 3 64
Minimum operator password length 8 3 64
Minimum numeric [0-9] characters required in operator password 1 0 64
Minimum alphabetic [a-z, A-Z] characters required in operator password 1 0 64
Minimum lowercase [a-z] characters required in operator password 0 0 64
Minimum uppercase [A-Z] characters required in operator password 0 0 64
Minimum special characters required in operator password Available special characters include: ` ~ ! @ # $ % ^ & * ( ) _ + - = { } [ ] | \ : " ; ' < >? , . / 1 0 64
Maximum unique historical operator passwords If the value is 5, you cannot change your password to match any of the most recent five passwords that you used. 5 0 128
Maximum operator password age in days The maximum number of days before an operator must change the password.

If you set the value to 0, the password never expires. To set an expiration period for a password, select a value between 1 and 128.

30 0 128
Minimum operator password age in days The minimum number of days before an operator can change the password. 0 0 128
Minimum number of different characters between current and new operator passwords Minimum number of characters that should be different between the current password and the new password when changing the password. 0 0 64

CAPTCHA policies settings

Policy Notes Default value Min value Max value
CAPTCHA implementation If set to Default, the system displays the CAPTCHA implementation that is included with Pega Platform.

If set to Custom, the system displays the custom CAPTCHA implementation enabled for this system. An application can use third-party CAPTCHA solutions on the application login screen. However, a certain amount of developer work is required to prepare the custom ruleset to deliver the third-party resource.

Default
Enable CAPTCHA Reverse Turing test module If enabled, the system displays the CAPTCHA upon authentication fails, with a probability set by the following field.

If disabled, no CAPTCHA is displayed, even on login failure.

Disabled
Probability that CAPTCHA will be presented upon authentication failure (%) If the CAPTCHA reverse Turing test is enabled, the percentage set here is the likelihood that the CAPTCHA is displayed. 5 0 100
Enable presentation of CAPTCHA upon initial login If enabled, the CAPTCHA is displayed the first time that the user tries to log in to a new system or from a new computer. Disabled

Lockout policies settings

Policy Notes Default value Min value Max value
Enable authentication lockout penalty Set to Enabled or Disabled. If enabled, after a specified number of failed login attempts, the system imposes a lengthening delay of a number of seconds between every unsuccessful login attempt and the next login attempt. Disabled
Failed login attempts before employing authentication lockout penalty (Used when Enable authentication lockout penalty is Enabled.) After the set number of failed attempts, the user experiences a delay after each further attempt. The delay gets longer with each attempt. 5 0 128
Initial authentication lockout penalty in seconds (Used when Enable authentication lockout penalty is Enabled.) Set the initial delay time. 8 0 128
Track login failures duration in minutes (Used when Enable authentication lockout penalty is Enabled.) After this period of inactivity, the failed login counter is set back to 0. 60
Failed login attempts before password lockout (Used when Enable authentication lockout penalty is Disabled.) Set the number of allowed failed login attempts before the account is locked. 0
Password lockout duration in minutes (Used when Enable authentication lockout penalty is Disabled.) Set the time period for which the account remains locked after the allowed failed login attempts are exceeded.
  • Set to a non-zero value to automatically unlock the account after the lockout.
  • Set to zero to require the account to be unlocked manually from the Unlock Operators landing page.
0

Audit policies settings

Policy Notes Default value Min value Max value
Audit log level Set the Audit log level. The options are:
  • None — No log entry is added
  • Basic — Record failed login attempts only
  • Advanced — Record failed and successful login attempts
Basic

Multi-factor authentication policies (using one-time password)

Policy Notes Default value Min value Max value
Maximum one-time password failure attempts Set the allowed number of failed login attempts before the one-time password becomes invalid and another one-time password must be generated. 3 1 3
Maximum age of one-time password token in seconds Specify how long a current one-time password can be used to authenticate the user before it becomes invalid and another one-time password must be generated.
The maximum age of the one-time password token must be less than the shortlived requestor time-out period, which is defined in minutes in the prconfig setting timeout/requestor/shortlived, and which defaults to 1 minute. If you set the maximum age to be greater than one minute (or accept the default), you must increase the timeout/requestor/shortlived setting.
180
Validity of one-time password confirmation in minutes Specify how long a current one-time password confirmation is valid before another one-time password confirmation is required for further transactions in that session. 60
Email account from which one-time password needs to be sent Specify an email account that is used to send one-time passwords. If necessary, click the Add icon to edit the selected email account.

If you do not define an email account or an SMS account, the multifactor authentication policy is not applied.

SMS account from which one-time password needs to be sent Specify an SMS account that is used to send one-time passwords. If necessary, click the Add icon to add the SMS account.

If you do not define an SMS account or an email account, the multifactor authentication policy is not applied.

Operator disablement policy settings

Policy Notes Default value Min value Max value
Number of days of inactivity Specify how many days a user has to be inactive before being automatically disabled. 90 1 90
Exclusion list of operator IDs Show a list of operators who are excluded from the policy.

Administrator@pega.com is excluded by default.

Click Add Operator to exclude additional operators from the policy.

  • Enforcing policies from the Security Policies landing page

    To enforce security policies that are defined on the Security Policies landing page, configure your basic authentication service.

  • Defining security policies

    To define security policies for user authentication and session management, use the Security Policies tab.

  • Managing security policies

    Enable security policies for user authentication and session management to improve application security. You can control the strength of user IDs and passwords, manage session time-outs and the disabling of operator IDs, control the auditing of login events, and implement CAPTCHA and multifactor authentication.

  • Configure system settings from Dev Studio

    To configure your system, use the Dev Studio Configure System Settings menu.

Suggest Edit

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.