8.4 Configuring Email Notification Settings

Self Service Password Reset lets you specify the email server and customize the templates for email notifications. You can configure Self Service Password Reset to send an automated email to users when required.

Self Service Password Reset supports both plain text and HTML formats. For each configured setting and locale, you should configure both plain text and HTML email bodies. Self Service Password Reset sends email in both formats and the email client can choose the display format. You can configure macros for the body (plain text or HTML), subject, and from values of email. Email templates offer language support. For more information about macros, see Configuring Macros for Messages and Actions.

8.4.1 Configuring Email Settings

You must have an SMTP server installed and configured for the email notifications in Self Service Password Reset to work. It is best to use a local SMTP server to your Self Service Password Reset system. The email settings allow you to configure Self Service Password Reset to communicate with your SMTP server.

To configure the email settings:

  1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

  2. In the toolbar, click your name.

  3. Click Configuration Editor.

  4. Click Settings > Email > Email Settings.

  5. Configure the following settings:

    SMTP Email Server Address

    Specify the SMTP server address for sending emails. This is a mandatory setting. Ensure that the server you specify here allows relaying. For best results, use a local SMTP server.

    SMTP Email Server Password

    Specify the password that Self Service Password Reset uses to access the SMTP server.

    SMTP Email Server Port

    Specify the port number of the SMTP server.

    Default From Address

    Specify the email address that is the default from email address for all emails.

    SMTP Email Server User Name

    Specify the user name for the SMTP server. Only this user can log into the SMTP server to send an email. If you do not specify any user here, the system sends SMTP messages without authentication.

    Maximum Email Queue Age

    Specify the maximum time (in seconds) an email can wait in the send queue. If an email is in the send queue longer than this time, the system discards it. An email persists in the send queue if there is any input error, output error, or network error to the SMTP server while sending the email.

    SMTP Email Advanced Settings

    Specify the name/value settings to control the behavior of the mail agent. You define the available settings as part of the JavaMail API. The settings must be in the name=value format, where name is the key value of a valid JavaMail API setting.

  6. In the toolbar, click Save changes.

8.4.2 Configuring Email Templates

Self Service Password Reset contains many different email templates for you to configure. The system does not send out any emails until you configure the templates. You must decide which templates you want to configure to have the emails automatically sent to your users.

For example, when the system creates new users, you can configure Self Service Password Reset to automatically send them emails with their login credentials by configuring the New User Email template.

To configure the email templates:

  1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

  2. In the toolbar, click your name.

  3. Click Configuration Editor.

  4. Click Settings > Email > Email Templates.

  5. Configure the appropriate templates to automatically send emails to users:

    NOTE:You can also configure all of the email template setting in a different language. Click Add Locale, then select the required language from the list.

    Change Password Email

    Configure the email format that they system sends to users when they change their passwords. For example, the sender’s address, subject, format, and text of the email body.

    Help Desk Change Password Email

    Configure the email format that the system sends to users when the help desk changes their passwords. For example, the sender’s address, subject, format, and text of the email body.

    Update Profile Email

    Configure the email format that the system sends to users when they update their profiles. For example, the sender’s address, subject, format, and text of the email body.

    Update Profile Email Verification

    Configure the email format that the system sends to users during profile email validation. For example, the sender’s address, subject, format, and text of the email body.

    New User Email

    Configure the email format that they system sends to new users. For example, the sender’s address, subject, format, and text of the email body.

    New User Verification Email

    Configure the email format that the system sends to new users after they register with links to verify the registration. For example, the sender’s address, subject, format, and text of the email body.

    Use %TOKEN% to insert the token value into the email.

    Activation Email

    Configure the email format that the system sends to new users after they successfully activate their account. For example, the sender’s address, subject, and format and text of the email body.

    Activation Verification Email

    Configure the email format that the system sends to new users during the activation verification process. For example, the sender’s address, subject, and text of the email body including the verification link.

    Use %TOKEN% to insert the token value into the email.

    Forgotten Password Verification Email

    When users request for the password reset, they receive a verification email. Users must click the link available in the email to authenticate the request.

    Configure the email format and other details such as sender’s address, subject, and text of the email body including the verification link.

    Use %TOKEN% to insert the token value into the email.

    Help Desk Verification Email

    Configure the email format that the system sends to users for verification of the help desk changes. For example, the sender’s address, subject, and text of the email body including the verification link.

    Use %TOKEN% to insert the token value into the email.

    Send Password Email

    The system sends an email to the user with the new password during forgotten password reset process. This setting is valid if you enabled the send password functionality.

    Configure the email format and other details such a sender’s address, subject, and text of the email body.

    Send User Name Email

    The system sends an email to the user with the new user name during forgotten password reset process.

    Configure the email format and other details such a sender’s address, subject, and text of the email body.

    Intruder Notice Email

    When a user or any intruder attempts to reset the password with incorrect responses that locks the user account, the user receives an email to notify them that the system disabled the account due to the lockout.

    Configure the email format and other details such a sender’s address, subject, and text of the email body.

    Delete Account Email

    The system sends an email to the user after the Account Delete action.

    Configure the email format and other details such a sender’s address, subject, and text of the email body.

    Help Desk Unlock Account Email

    The system sends an email to the user when the account is unlocked by the help desk.

    Configure the email format and other details such a sender’s address, subject, and text of the email body.

    Unlock Account Email

    The system sends an email to the users who unlock their own accounts.

    Configure the email format and other details such a sender’s address, subject, and text of the email body.

  6. In the toolbar, click Save changes.