Email Invitations and Password Reset

Required Permission: Settings management (Read more about Permissions)

Table of Contents

The default (out of the box) functionality of Graphlytic comes with User Management features that don't involve the user's input in the process.

Password management via emails allows to send:

  • User invitations: users created directly in the app can be invited to log into the app for the first time with the Invitation email that has an URL link to set up the password and log in.

  • Forgot password: users that forgot their password can use the "Forgot password" link on the Login page to get an email with a password reset link.

  • Forced password reset: admin can block the user and an email with a password change link is sent to the user.

Configuration

SMTP Email Server Connection needs to be configured in order to send email. See SMTP Email Server Connection for more details.

In order to turn on the password reset via email please fill out all the necessary information in the "Password Reset via Email" panel on the Settings page (screenshot below) and hit "Apply".

The main parts of the panel are:

  • Email subject texts: these texts will be used as the email subjects. Texts in the body of the email can be changed in the email templates (see chapter below).

  • Password reset link validity (in hours): validity duration for the URL links for password change sent in the email.

images/download/attachments/44508927/password_reset.png

Default Configuration

The default configuration can be overridden in the graphlytic.conf file (application needs to be restarted after any change in this conf file).

More information can be found on the Configuration page.

Email templates

Examples of email templates are in the attachment of this page (see below).

The location of email templates is configured in the graphlytic.conf file. For more information refer to Configuration.

These dynamic fields can be used in emails:

Field

Data type

Description

${username}

String

User's username (login name).

${link}

String

Generated URL link for password change.

${validTill}

Date

Time validity of the generated URL link. Can be formated with FTL date formating: https://freemarker.apache.org/docs/ref_builtins_date.html

Examples:

${validTill?date} - only date part

${validTill?time} - only time part

${validTill ?iso_utc } - e.g. 2011-05-16T21:32:13Z

${validTill ?string["dd.MM.yyyy, HH:mm"] } - e.g. 08.04.2003 21:24

${validTill?string.long} - e.g. April 20, 2007

${firstName}

OPTIONAL

String

User's first name. This is an optional value field and can be empty.

${lastName}

OPTIONAL

String

User's last name. This is an optional value field and can be empty.

Example

<h1>Resetting email test</h1>
Dear ${username}
<br/>
Link to change the password is <a href="${link}">here</a>. The link will be valid till ${validTill}.
<br/>
First name: ${firstName}
Last name: ${lastName}

Graphlytic's default templates