Skip to main content
Version: 1.21.3

Authorization Properties

Use the following properties to set up the authorization and login, including key email messages, default language and timezone, content of the login page, links, and others.

To get a list of available system properties, navigate to System PropertiesAll Properties.

email.reset_password.email_body


Specify the email body for the password reset request.

Type: String

Default value: Not defined

Value example: Follow the link to change the password.

email.reset_password.subject


Specify the subject for the email sent when the password reset was requested.

Type: String

Default value: Not defined

Value example: Your new password.

email.reset_password.unchanged_password


Specify the message body of the email about an unchanged password.

Type: String

Default value: Not defined

Value example: This user cannot change the password.

email.validation.reg_exp


Specify a pattern to validate the email addresses. If the property value is empty, the /.*@.*/ expression is used.

warning

Any change to this pattern may cause the email address validation engine to work incorrectly.

Type: String

Default value: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,6}\b/

Value example: /.*@.*.ru/

page_access.redirect_url


Specify a URL redirect from the authorization page for users without the required roles to the Service Portal page.

Type: String

Default value: /portal

simple.auth_page.help_info.en


Specify a message that users see when clicking Help on the authorization page. This property is for the message in English.

Type: String

Default value: Not defined

Value example:

<p>If you need help, please contact us</p>
<p>E-mail: service@example.com</p>
<p>Phone: +7(555)30092019</p>
<p><a tohref='Go'> support page</a></p>

simple.auth_page.help_info.ru


Specify a message that users see when clicking Help on the authorization page. This property is for the message in Russian.

Type: String

Default value: Not defined

Value example:

`<p>Если вам требуется консультация, свяжитесь с нами</p>
<p>E-mail: service@example.com</p>
<p>Телефон: +7(555)30092019</p>
<p><a href='Go'>Go'>https://simpleone.ru/'>Go to support page</a> </p>`

simple.auth_page.support_email


Specify a contact email for the authorization page.

Type: String

Default value: Not defined

Value example: service@example.com

simple.auth_page.support_phone


Specify a contact phone for the authorization page. Numbers, spaces and the plus sign (+) are allowed.

Type: String

Default value: Not defined

Value example: +1 800 5555555

simple.auth_page.support_site


Specify a URL of the service desk site displayed on the authorization page.

Type: String

Default value: Not defined

Value example: https://service.example.com/

simple.login.username.sensitivity.enabled


To enable the creation of the similar usernames with case-sensitivity (like "username" and "UserName"), set this property to true.

Type: Boolean

Default value: false

simple.passwordreset.enabled


To enable the password reset functionality when logging in the system, set the property to true. If this property is set to false, the system rejects password reset requests to API.

Type: Boolean

Default value: false

simple.signup.enabled


To enable displaying the Sign-up option when logging in the system, set the property to true.

Type: Boolean

Default value: false

simple.user.password_reset_token_expiry


Specify the password reset token expiration time (in seconds). If not specified, then the default value is applied (3600 seconds, or 1 hour).

Type: Integer

Default value: 3600

simple.username.pattern


Specify a pattern for username validation. For more information, refer to the regular expression documentation.

Type: String

Default value: /^[A-Za-z][A-Za-z0-9_.-@]*$/

simple.sso.active


To enable the Single Sign-On authorization, set the property to true.

Type: Boolean

Default value: false

simple.sso.priority_over_welcome_page


To enable the Single Sign-On login page priority over the welcome page, set the property true.

If the value is true, the redirection leads to the SSO URL only if the simple.sso.active property is set to true.

Type: Boolean

Default value: false

simple.welcome_page.url


Specify the welcome page URL, or enter false to disable redirection to the page.

Type: String

Default value: Not defined

Value example: portal/login
https://example_welcome_page.com

caution

If the redirection URL is set to a nonexistent page, the redirection leads to one of the existing pages of the portal.

user.language.default


Set the system language available for users by default on the instance.

Users can change the language in the Preferences menu. The "out-of-the-box" solution contains two languages: Russian and English.

Type: String

Default value: en

user.timezone.default


Specify the user default timezone.

Users can change the default timezone in the Preferences menu.

Type: String

Default value: Not defined

Value example: Europe/Moscow

user.token.ttl


Specify the user token lifetime in seconds (1 day = 86400 seconds)

Type: Integer

Default value: 864000