This documentation is for WSO2 Identity Server 5.7.0 . View documentation for the latest release.

All docs This doc
||
Skip to end of metadata
Go to start of metadata

This section explains how to resend the account recovery confirmation mail in the following account recovery scenarios:

  • User creation through ask password option
  • Notification-based password recovery
  • Admin-initiated password reset through an email link
  • Admin-initiated password reset via OTP
  • Self-registration

Follow the steps below to configure WSO2 Identity Server to resend account recovery confirmation emails:

To use this feature, apply the 4808 WUM update for WSO2 Identity Server 5.7.0 using the WSO2 Update Manager (WUM). To deploy a WUM update into production, you need to have a paid subscription. If you do not have a paid subscription, you can use this feature with the next version of WSO2 Identity Server when it is released. For more information on updating WSO2 Identity Server using WUM, see Getting Started with WUM in the WSO2 Administration Guide.

Before you begin

Sign in to the WSO2 Identity Server Management Console.

  1. On the Main menu, click Manage > Email Template > Add. 
    Add Email Template menu-item
  2. Click Add Email Template
    Add Email Template option
  3. To create an email template for account registration through password request
    1. Enter resendAskPassword  as the Template Type Display Name and click Add.
      Add Email Template Type screen
      A success message about the email template creation and the Add a New Email Template screen appears.  
      Add a New Email Template screen
    2. Enter the following values:
      1. Email Template TyperesendAskPassword
      2. Email Template LocaleEnglish (United States)
      3. Email Content Typetext/html
      4. Email Template Subject: WSO2 - Resend Create Password for New Account
      5. Email Body:  

         Click to view
        <table align="center" cellpadding="0" cellspacing="0" border="0" width="100%"bgcolor="#f0f0f0">
                    <tr>
                    <td style="padding: 30px 30px 20px 30px;">
                        <table cellpadding="0" cellspacing="0" border="0" width="100%" bgcolor="#ffffff" style="max-width: 650px; margin: auto;">
                        <tr>
                            <td colspan="2" align="center" style="background-color: #333; padding: 40px;">
                                <a href="http://wso2.com/" target="_blank"><img src="http://cdn.wso2.com/wso2/newsletter/images/nl-2017/wso2-logo-transparent.png" border="0" /></a>
                            </td>
                        </tr>
                        <tr>
                            <td colspan="2" align="center" style="padding: 50px 50px 0px 50px;">
                                <h1 style="padding-right: 0em; margin: 0; line-height: 40px; font-weight:300; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 1em;">
                                    Resend Password Change for New Account
                                </h1>
                            </td>
                        </tr>
                        <tr>
                            <td style="text-align: left; padding: 0px 50px 20px 50px;" valign="top">
                                <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                    Hi {{user-name}},
                                </p>
                                <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                    Please create your password for the newly created account <b>{{user-name}}</b>. <br>
                                    Please click the button below to create the password.
                                </p>
                            </td>
                        </tr>
                        <tr>
                            <td style="padding: 0px 50px 0px 50px; text-align: left;">
                                <table align="left" cellpadding="0" cellspacing="0" border="0" style="border-radius: 4px; background-color: #ff5000;">
                                    <tr>
                                        <td style="border-radius: 6px;  padding: 14px 0px;">
                                            <a href="{{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}"
                                               target="_blank" style="width: 230px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif;  font-size: 18px; line-height: 21px; font-weight: 600; color: #fff; text-decoration: none; background-color: #ff5000; text-align: center; display: inline-block;cursor: pointer;">Create Password</a>
                                        </td>
                                    </tr>
                                </table>
                            </td>
                        </tr>
                        <tr>
                            <td style="text-align: left; padding: 40px 50px 0px 50px;" valign="top">
                                <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #505050; text-align: left;">
                                    If clicking the button doesn't seem to work, you can copy and paste the following link into your browser. <br/>
                                    <a style="word-break: break-all; color: #ff5000; font-size: 14px" target="_blank"
                                       href="{{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}">
                                        {{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}
                                    </a>
                                </p>
                            </td>
                        </tr>
                        <tr>
                            <td style="text-align: left; padding: 30px 50px 50px 50px;" valign="top">
                                <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #505050; text-align: left;">
                                    Thanks,<br/>WSO2 Identity Server Team
                                </p>
                            </td>
                        </tr>
                        <tr>
                            <td colspan="2" align="center" style="padding: 20px 40px 40px 40px;" bgcolor="#f0f0f0">
                                <p style="font-size: 12px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #777;">
                                    &copy; 2018
                                    <a href="http://wso2.com/" target="_blank" style="color: #777; text-decoration: none">WSO2</a>
                                    <br>
                                    787 Castro Street, Mountain View, CA 94041.
                                </p>
                            </td>
                        </tr>
                        </table>
                    </td>
                    </tr>
        </table>
        
      6. Email Footer-- 
    You have successfully created an email template to resend a confirmation mail. Similarly, you can create other templates with the values given below.
  4. To create an email template for notification-based password recovery, enter the following values:
    1. Email Template TyperesendPasswordReset
    2. Email Template LocaleEnglish (United States)
    3. Email Content Typetext/html
    4. Email Template SubjectWSO2 - Resend Password Reset
    5. Email Body

       Click to view
      <table align="center" cellpadding="0" cellspacing="0" border="0" width="100%"bgcolor="#f0f0f0">
                  <tr>
                  <td style="padding: 30px 30px 20px 30px;">
                      <table cellpadding="0" cellspacing="0" border="0" width="100%" bgcolor="#ffffff" style="max-width: 650px; margin: auto;">
                      <tr>
                          <td colspan="2" align="center" style="background-color: #333; padding: 40px;">
                              <a href="http://wso2.com/" target="_blank"><img src="http://cdn.wso2.com/wso2/newsletter/images/nl-2017/wso2-logo-transparent.png" border="0" /></a>
                          </td>
                      </tr>
                      <tr>
                          <td colspan="2" align="center" style="padding: 50px 50px 0px 50px;">
                              <h1 style="padding-right: 0em; margin: 0; line-height: 40px; font-weight:300; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 1em;">
                                  Resend Password Reset
                              </h1>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 0px 50px 20px 50px;" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                  Hi {{user.claim.givenname}},
                              </p>
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                  We received a request to reset the password for the <b>{{user-name}}</b> account that is associated with this email address.<br>
                                  If you made this request, please click the button below to securely reset your password.
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td style="padding: 0px 50px 0px 50px; text-align: left;">
                              <table align="left" cellpadding="0" cellspacing="0" border="0" style="border-radius: 4px; background-color: #ff5000;">
                                  <tr>
                                      <td style="border-radius: 6px;  padding: 14px 0px;">
                                          <a href="{{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}&amp;callback={{callback}}"
                                             target="_blank" style="width: 230px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif;  font-size: 18px; line-height: 21px; font-weight: 600; color: #fff; text-decoration: none; background-color: #ff5000; text-align: center; display: inline-block; cursor: pointer;">Reset Password</a>
                                      </td>
                                  </tr>
                              </table>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 40px 50px 0px 50px;" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #505050; text-align: left;">
                                  If clicking the button doesn't seem to work, you can copy and paste the following link into your browser. <br/>
                                  <a style="word-break: break-all; color: #ff5000;font-size: 14px;" target="_blank"
                                     href="{{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}&amp;callback={{callback}}">
                                      {{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}&amp;callback={{callback}}</a>
                              </p>
                              <br>
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                  If you did not request to have your {{user-name}} password reset, disregard this email and no changes to your account will be made.
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 30px 50px 50px 50px" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #505050; text-align: left;">
                                  Thanks,<br/>WSO2 Identity Server Team
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td colspan="2" align="center" style="padding: 20px 40px 40px 40px;" bgcolor="#f0f0f0">
                              <p style="font-size: 12px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #777;">
                                  &copy; 2018
                                  <a href="http://wso2.com/" target="_blank" style="color: #777; text-decoration: none">WSO2</a>
                                  <br>
                                  787 Castro Street, Mountain View, CA 94041.
                              </p>
                          </td>
                      </tr>
                      </table>
                  </td>
                  </tr>
      </table>
    6. Email Footer--
  5. To create an email template for an admin-initiated password reset through an email link, enter the following values:
    1. Email Template TyperesendAdminForcedPasswordReset
    2. Email Template LocaleEnglish (United States)
    3. Email Content Typetext/html
    4. Email Template SubjectWSO2 - Resend Admin Forced Password Reset
    5. Email Body

       Click to view
      <table align="center" cellpadding="0" cellspacing="0" border="0" width="100%"bgcolor="#f0f0f0">
                  <tr>
                  <td style="padding: 30px 30px 20px 30px;">
                      <table cellpadding="0" cellspacing="0" border="0" width="100%" bgcolor="#ffffff" style="max-width: 650px; margin: auto;">
                      <tr>
                          <td colspan="2" align="center" style="background-color: #333; padding: 40px;">
                              <a href="http://wso2.com/" target="_blank"><img src="http://cdn.wso2.com/wso2/newsletter/images/nl-2017/wso2-logo-transparent.png" border="0" /></a>
                          </td>
                      </tr>
                      <tr>
                          <td colspan="2" align="center" style="padding: 50px 50px 0px 50px;">
                              <h1 style="padding-right: 0em; margin: 0; line-height: 40px; font-weight:300; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 1em;">
                                  Resend Admin Forced Password Reset
                              </h1>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 0px 50px 20px 50px;" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                  Hi {{user.claim.givenname}},
                              </p>
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                  Please click the button below to reset your password for the account <b>{{user-name}}</b>.
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td style="padding: 0px 50px 0px 50px; text-align: left;">
                              <table align="left" cellpadding="0" cellspacing="0" border="0" style="border-radius: 4px; background-color: #ff5000;">
                                  <tr>
                                      <td style="border-radius: 6px;  padding: 14px 0px;">
                                          <a href="{{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}"
                                             target="_blank" style="width: 230px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif;  font-size: 18px; line-height: 21px; font-weight: 600; color: #fff; text-decoration: none; background-color: #ff5000; text-align: center; display: inline-block;cursor: pointer;">Reset Password</a>
                                      </td>
                                  </tr>
                              </table>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 40px 50px 0px 50px;" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #505050; text-align: left;">
                                  If clicking the button doesn't seem to work, you can copy and paste the following link into your browser. <br/>
                                  <a style="word-break: break-all; color: #ff5000; font-size: 14px" target="_blank"
                                     href="{{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}">
                                      {{carbon.product-url}}/accountrecoveryendpoint/confirmrecovery.do?confirmation={{confirmation-code}}&amp;userstoredomain={{userstore-domain}}&amp;username={{url:user-name}}&amp;tenantdomain={{tenant-domain}}
                                  </a>
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 30px 50px 50px 50px;" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #505050; text-align: left;">
                                  Thanks,<br/>WSO2 Identity Server Team
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td colspan="2" align="center" style="padding: 20px 40px 40px 40px;" bgcolor="#f0f0f0">
                              <p style="font-size: 12px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #777;">
                                  &copy; 2018
                                  <a href="http://wso2.com/" target="_blank" style="color: #777; text-decoration: none">WSO2</a>
                                  <br>
                                  787 Castro Street, Mountain View, CA 94041.
                              </p>
                          </td>
                      </tr>
                      </table>
                  </td>
                  </tr>
      </table>
    6. Email Footer--
  6. To create an email template for an admin-initiated password reset through an OTP, enter the following values:
    1. Email Template TyperesendAdminForcedPasswordResetWithOTP
    2. Email Template LocaleEnglish (United States)
    3. Email Content Typetext/html
    4. Email Template SubjectWSO2 - Resend Admin Forced Password Reset
    5. Email Body

       Click to view
      <table align="center" cellpadding="0" cellspacing="0" border="0" width="100%"bgcolor="#f0f0f0">
                  <tr>
                  <td style="padding: 30px 30px 20px 30px;">
                      <table cellpadding="0" cellspacing="0" border="0" width="100%" bgcolor="#ffffff" style="max-width: 650px; margin: auto;">
                      <tr>
                          <td colspan="2" align="center" style="background-color: #333; padding: 40px;">
                              <a href="http://wso2.com/" target="_blank"><img src="http://cdn.wso2.com/wso2/newsletter/images/nl-2017/wso2-logo-transparent.png" border="0" /></a>
                          </td>
                      </tr>
                      <tr>
                          <td colspan="2" align="center" style="padding: 50px 50px 0px 50px;">
                              <h1 style="padding-right: 0em; margin: 0; line-height: 40px; font-weight:300; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 1em;">
                                  Resend Admin Forced Password Reset
                              </h1>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 0px 50px;" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                  Hi {{user.claim.givenname}},
                              </p>
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #666; text-align: left; padding-bottom: 3%;">
                                  We received a request to reset the password for the <b>{{user-name}}</b> account that is associated with this email address.<br>
                                  Please use below OTP as the password at next login and then reset your password.<br>
                                  OTP : <b>{{confirmation-code}}</b>
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td style="text-align: left; padding: 30px 50px 50px 50px" valign="top">
                              <p style="font-size: 18px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #505050; text-align: left;">
                                  Thanks,<br/>WSO2 Identity Server Team
                              </p>
                          </td>
                      </tr>
                      <tr>
                          <td colspan="2" align="center" style="padding: 20px 40px 40px 40px;" bgcolor="#f0f0f0">
                              <p style="font-size: 12px; margin: 0; line-height: 24px; font-family: 'Nunito Sans', Arial, Verdana, Helvetica, sans-serif; color: #777;">
                                  &copy; 2018
                                  <a href="http://wso2.com/" target="_blank" style="color: #777; text-decoration: none">WSO2</a>
                                  <br>
                                  787 Castro Street, Mountain View, CA 94041.
                              </p>
                          </td>
                      </tr>
                      </table>
                  </td>
                  </tr>
      </table>
    6. Email Footer--


For information on the REST API for resending confirmation code, see Resend-Code Using REST API.

  • No labels