Customize emails to notify password expiration

This page describes how to customize the emails to remind users to change their passwords before they expire

Abiquo will customize emails using template and properties files with the following priority:

  1. Localized files, with a language code extension, such as passwordNotificationTemplate_en_US.mustache and passwordNotification_en_US.properties

  2. Main files with no language code extension, such as passwordNotificationTemplate.mustache and passwordNotification.properties

  3. System defaults. We use the contents of the system default files in the examples below

 

To customize the emails to remind users to change their Abiquo passwords:

  1. Log in to the Abiquo API Server as an administrator

  2. In the config folder, if there is no mail folder, create a mail folder and set the owner as the tomcat user

    /opt/abiquo/config/mail

     

  3. In the mail folder, create the custom files as required. You can create localized files and main files.
    The content of the default files is shown here.

    1. Email file:
      for example, as a localized file for US English, passwordNotificationTemplate_en_US.mustache

      <p>Dear {{username}},</p> <p>Your password will expire in {{days}} days. Please change your password as soon as possible. </p> <p>Thank you,</p> <p>The Abiquo Team</p>

       

    2. Properties file:
      for example, as a localized file for US English, passwordNotification_en_US.properties

      subject=Password Expiration Notification

       If you change the subject property, you must restart the Tomcat server to apply your changes

       

  4. Optionally, add custom variables and content.

    1. In the email body, to add a custom variable, use double curly braces (also called double mustaches). For example

      Then in your properties file, set a value for your custom variable

       

    2. To create a template property that will return unescaped HTML enter the triple mustache of {{{ and }}} around the property name. For example:

      Then set a variable in your property files

    3.  

  5. If your users have a different locale, such as when they use a language other than English, use the language code for the user locale 

    • For example, for Spanish - Spain change en_US to es_ES.

    • You can set a locale when you create an Abiquo user

  6. Change the owner of the files to the tomcat user

  7. If you changed the subject property, restart the Tomcat server

 

Copyright © 2006-2024, Abiquo Holdings SL. All rights reserved