Versions Compared

Old Version 1

changes.mady.by.user Dina Baksheeva

Saved on

compared with

New Version Current

changes.mady.by.user Dina Baksheeva

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

There are two ways to set up a password retrieval:

  • To set up a password reset via the "out-of-the-box" authorization widget, use the necessary system properties.
  • If a custom widget is used for authorization, it is necessary to set the parameter for the <authfull> SimpleTag.

Authorization widget


Enable password retrieval

Use

Configure various aspects of password by resetting functionality in your instance.

Enabling password retrieval

To enable password retrieval, set thesimple.passwordreset.enabled system property value to 'true'.To enable the to enable the password retrieval link on the portal login page, set thesimple.passwordreset.enabled system property value to 'true', and  and perform the following steps:

  1. Navigate to Portal Structure → Portals and choose the record you need Widget Instance.
  2. Navigate to the login page (specified in the Login page field of the portal record).
  3. Scroll down to the Related Lists area, navigate to the Page Container tab, and open a record.
  4. After this, scroll down to the Related Lists area, navigate to the Page Row tab, and open a record.
  5. Once you are in the page row, scroll down to the Related Lists area and navigate to the Page Column tab, and open a record.
  6. After this, scroll down to the Related Lists area, navigate to the Widget Instance tab, and open a record.
  7. Start editing the Schema Option Values value:
    • Specify the 'true' value for the password reset enabled option.
  8. Open the Authorization Widget record.
  9. Edit the Schema Option Values value:
    • Specify the true value for the passwordResetEnabled option.
Info

The password reset email contains the following link:

<a href="{instance.uri.without.scheme}/new-password/{password.reset.token}">Your new password</a>

Specify the password.reset.token value in the Password Reset Token field for the user who retrieved a password.

Use Thesimple.user.password_reset_token_expiry property allows defining to define the password reset expiration period in seconds. To set up the period, complete the following steps: 

  1. Navigate to System Properties → All Properties.
  2. Find the simple.user.password_reset_token_expiry property using the list search boxes and open it.
  3. Edit the Value field, specify the an expiration time of expiration.
  4. Click Save or Save and Exitexit.

Changing the letter prerequisites

The following messages appear on the widget in case the password retrieval failed:

  1. Access denied. This error occurs when attempting to retrieve a password on the /reset-password page with the simple.passwordreset.enabled system property disabled.  

  2. Wrong password reset token. This error occurs when attempting to reset a password after the expiration of the reset token. Set the life period of the token in the simple.user.password_reset_token_expiry property. 

Change email content

ETo change the password retrieval letter subject and/or body, you can edit the email.reset_password.subject and /or email.reset_password.email_body system property values to change the password retrieval email subject and body.

The Use the email.reset_password.unchanged_password property allows editing the to edit the body of the email about an unchanged password letter.

To change password retrieval and/or unchanged password letters, please system values, follow the steps below: 

  1. Navigate to System Properties → All Properties.
  2. Find the property you need to edit using the  list search boxes or the Condition Buildercondition builder and open it.
  3. Edit the Value field.
  4. Click Save or Save and Exitexit.
Changing

Change the link text

To change the Forgot Password link text, you need to edit relevant values in Source Messages and Messages dictionaries. To change this message, please translations of the relevant source message. To do this, complete the steps below:

  1. Navigate to System Localization → Source Message.
  2. Open the search bar by clicking on the magnifier icon Image Removed at the top of the title area.
  3. Enter the text you need in the search bar.
  4. Navigate to the Messages tab and click on the record related to this.

Image Removed

5. Click on the ID in the right column to open the record. If the column is not displayed, then put it on the list using the Personal List Layout functionality.

6. Edit the message for every language you need. You can also
  1. Find the necessary source message using the list search boxes.
  2. In the Related Lists are, select the Messages tab, open the message record or use the inline-edit functionality to edit messages.
For this:
    • If you open the message form, click Save or Save and exit.

Image Added

 

Warning

Do NOT change

  1. Double-click on the value in the Translation column.
  2. Enter a new value.
  3. Click on the check icon.

Image Removed

Warning

Please avoid changing the Source Message value when editing messages; this value is used to display the relevant Message value. Otherwise, it may lead to errors.


Customize the SimpleTag

To set up a custom authorization widget, perform the following steps:

  1. Open the custom login widget record.
  2. In the <authfull> tag, set isResetPassword = true to enable password retrieval. The default value of the parameter is false.

As a result, the widget form will contain a password reset link.

Table of Contents
absoluteUrltrue