Customize email templates

You can customize the email messages sent from your Identity as a Service account from the Email Templates page. Identity as a Service processes the email body a as Mustache template, which allows you to use variables in your emails. For more information about template syntax options, see the Mustache documentation.

Email template descriptions

The following is a list of Identity as a Service email templates. Note that some templates are only available to Managed Service Provider Accounts.

       Account Expiring—Email that is sent to Tenant accounts that are about to expire. The emails are sent 14, 28, and 56 days before the account expiry date. This email is available only for Managed Service Provider Accounts.

       Entrust Token Activation—Email that is sent to users when an Entrust Soft Token has been assigned to them. It contains instructions on how to activate the token.

       Face Biometric Activation—Email that is sent to users when a face biometric has been assigned to them. It contains instructions on how to activate the face biometric.

       Google Token Activation—Email that is sent to users when a Google Token has been assigned to them. It contains instructions on how to activate the token.

       Grid Export—Email that is sent to users that contains their grid card.

       Grid Export Password—Email that is sent to users that contains their grid card password if the grid card has been encrypted.

       Magic Link Registration—Email that is sent to a user when they need to complete registration.

       Mobile Flash Pass Activation—Email that is sent to users when a Mobile Flash Pass has been assigned to a them. It contains instructions on how to activate the Mobile Flash Pass.

       One Time Password Email—Email that is sent that contains a user's One Time Password (OTP) to authenticate to Identity as a Service.

       Password Email—Email that is sent to a user containing their new password.

       Password Expired—Email that is sent to a user when their password has expired.

       Password Expiring—Email that is sent to a user when their password is soon to expire.

       Password Status Email—Email that is sent to a user when their password is locked, unlocked, or an unlock attempt occurred.

       Schedule Usage Report—Email that is sent when your Scheduled Usage Report is ready and your account has been configured to send Usage Reports. A Usage Report provides an update on entitlement usage. For example, if a Tenant account has an entitlement of 100 users and uses 50 users, an email is delivered to provide an update on the entitlement usage. This email is available only for Managed Service Provider Accounts. For more information, see Manage Usage Reports in the Service Provider Help.

       Smart Credential Activation—Email that is sent to users when a Mobile Smart Credential has been assigned to them. It contains instructions on how to activate the smart credential.

       SMS/Voice Entitlement—Email that is sent to Tenant accounts when their account SMS/Voice entitlements are nearing expiration or have expired. The emails are sent 14, 28, and 56 days before the entitlement end date and on the end date of the entitlement. This email is available only for Managed Service Provider Accounts.

        Trial Account Locked—Email that is sent to Tenant accounts when the trial period has completed without their account being converted to a Production account. The emails are sent 1, 3, and 7 days before the account is locked and on the day account has been locked. This email is available only for Managed Service Provider Accounts.

       User Authenticator Notification—Email that is sent to users when their authenticator has been changed.

       User Contact Notification—Email that is sent to users when their account contact information has been changed.

       User Verification—Email that is sent to users when they are required to verify.

       Welcome Subscriber—Email that is sent when a new Tenant account is created. It contains the detail of the new account and how to access it. This email is available only for Managed Service Provider Accounts.

Customizing emails

If you have a role with the Email Templates permission, you can modify the email templates to customize emails sent from Identity as a Service. The type of mail server you use allows you to customize templates as follows:

       Identity as a Service Mail Server—If you use the Identity as a Service mail server you can:

  Update the Subject of the email

  Change the Service Name

  Change the Date/Time syntax

  Update the Support Text

  Update the Authenticator Name  and Authentication App Links for Entrust Soft Token, Google Authenticator, and Entrust Smart Credential

       Custom Mail Server—If you use a custom mail server you can:

  Do all of the action listed for Identity as a Service mail server (above)

  Fully customize the email template HTML by editing the Body of the email. The email templates are parsed with the Mustache template engine to allow you to personalize the emails with context-specific variables.

Modify email templates

Attention: Steps 1 to 3 in this procedure apply to both templates that use the Identity as a Service mail server and a custom mail server. Step 4 applies only if you are using your own mail server. For more information on setting up a custom email server, see Manage mail servers.

1.      Click  > Customization > Email Templates. The Email Templates page appears.

2.      To change the Subject and Language of the email:

a.      Click the Email Templates tab.

b.      Select the email template from Template drop-down list.

c.      From the Language drop-down list, select the language of the template you want to edit.

d.      Edit the text in the Subject field.

e.      Click Save.

3.      To change the Variables, do the following:

a.      Click the Variables tab.

b.      Edit the following fields, as required:

  Service Name—This is the name of your Service. By default it is Entrust Identity as a Service.

  Sender Name—This is the name of the sender of the email. If not set, your company name is used.

  Date/Time Syntax—This is the date and time format used in emails. (See https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html for more information on Date and Time patterns.)

  Support Text—This is support contact information for your users.

  Change the Authenticator Name (Entrust Soft Token, Google Authenticator, and Smart Credential only)

Note: If you change the Google Authenticator name, the name is changed throughout with the exception of the Audit files. If you want the change to be applied to multiple languages, you need to apply the change to email template for the language.

  Change the Authenticator App Links (Entrust Soft Token, Google Authenticator, and Smart Credential only)

c.      Click Save.

Note: When making changes to email templates, make sure to update the templates for each language.

4.      If you are using a custom email server, you can fully customize your email. The email templates that you can edit depend of the type of account you have. For example, only Service Providers can modify Service Provider email templates. Customize the email templates as follows:

a.      Click the Email Templates tab.

b.      Select the template from Template drop-down list.

c.      In the Body field, edit the contents as required. Click Legend at the bottom of the page to see a description of each variable.

d.      Click Preview to review your email template customizations.

  In the Preview dialog box, use the Toggle button () to switch between the preview and the source.

  Click Close to close the Preview dialog box.

 Note: To revert to the default settings, click Reset.

e.      Click Save.