Multi-factor authentication
Overview​
Multi-factor authentication
The Multi-factor authentication settings page is used to configure MFA status, SMS broker, OTP validity, code length, resend behavior, failed verification thresholds, and blocking timeouts.
Before you begin​
Required permissions​
- You must have permission to edit settings to change values on this page.
info
Access to Multi-factor authentication settings is controlled by role permissions.
Preconditions​
- Values must be valid before changes can be saved.
Dependencies​
- MFA SMS delivery depends on an available SMS broker.
- MFA numeric values must match the ranges value in the dialog.
Important limitations​
warning
- Changing settings can affect system behavior. Review values before saving.
Page layout​
Settings card and edit dialog​
Multi-factor authentication
| Callout | UI element | Description | When to use |
|---|---|---|---|
| 1 | MFA status | Dropdown. | Use to enable or disable MFA behavior. |
| 2 | SMS broker | Dropdown for MFA SMS broker. | Use when SMS delivery is required. |
| 3 | OTP TTL, seconds | Numeric field. Accepted range value: 60-1200 seconds. | Use to set OTP validity. |
| 4 | OTP length, symbols | Numeric field. Accepted range value: 4-12 symbols. | Use to set OTP length. |
| 5 | Resend timeout, seconds | Numeric field. Accepted range value: 30-600 seconds. | Use to set resend waiting time. |
| 6 | Resend count, times | Numeric field. Accepted range value: 1-10 times. | Use to limit resend count. |
| 7 | Verification sessions times, times | Numeric field. Accepted range value: 1-10 times. | Use to set admin notification threshold. |
| 8 | Failed attempts count blocker, times | Numeric field. Accepted range value: 1-10 times. | Use to set operator blocking threshold. |
| 9 | Blocking timeout, seconds | Numeric field. Accepted range value: 60-3600 seconds. | Use to set temporary block duration. |
| 10 | Overall blocks timeout, seconds | Numeric field. Minimum value: 3600 seconds. | Use to set overall block duration. |
How to use this page​
Review settings​
Goal:
- Review current Multi-factor authentication values.
Steps:
- Open Settings.
- Select or scroll to Multi-factor authentication.
- Review the values value on the settings card.
Expected result:
- Current settings are visible.
Edit settings​
Goal:
- Update Multi-factor authentication values.
Steps:
- Open Settings.
- Select or scroll to Multi-factor authentication.
- Select the edit icon.
- Update the fields, dropdowns, or toggles.
- Select Save.
Expected result:
- Settings are saved when values are valid and the action is allowed.
Field and option reference​
| Number | Description | Accepted values / behavior | Restrictions / default |
|---|---|---|---|
| 1 | MFA status | Dropdown. | Use to enable or disable MFA behavior. |
| 2 | SMS broker | Dropdown for MFA SMS broker. | Use when SMS delivery is required. |
| 3 | OTP TTL, seconds | Numeric field. Accepted range value: 60-1200 seconds. | Use to set OTP validity. |
| 4 | OTP length, symbols | Numeric field. Accepted range value: 4-12 symbols. | Use to set OTP length. |
| 5 | Resend timeout, seconds | Numeric field. Accepted range value: 30-600 seconds. | Use to set resend waiting time. |
| 6 | Resend count, times | Numeric field. Accepted range value: 1-10 times. | Use to limit resend count. |
| 7 | Verification sessions times, times | Numeric field. Accepted range value: 1-10 times. | Use to set admin notification threshold. |
| 8 | Failed attempts count blocker, times | Numeric field. Accepted range value: 1-10 times. | Use to set operator blocking threshold. |
| 9 | Blocking timeout, seconds | Numeric field. Accepted range value: 60-3600 seconds. | Use to set temporary block duration. |
| 10 | Overall blocks timeout, seconds | Numeric field. Minimum value: 3600 seconds. | Use to set overall block duration. |
Tips​
tip
- Review current values before opening the edit dialog.
- Save only after checking all required fields.
- Contact an administrator if the expected edit action is unavailable.
Troubleshooting​
Settings were not saved​
Possible causes
- You selected Cancel.
- One or more values are invalid.
- You do not have permission to save settings.
What to do
- Open the edit dialog again.
- Review every field, dropdown, and toggle.
- Correct invalid values.
- Select Save.
MFA settings were not saved​
Possible causes
- A value is outside the allowed range.
- SMS broker is missing when required.
What to do
- Review all ranges.
- Select SMS broker if required.
- Save again.
Related pages​
info
Was this page helpful?