1

  1. Navigate to Tenants & Users -> Configuration -> Email templates.
  2. Enter the name and SMTP settings for your custom server. The format should be smpt://username:password@emailservice:587, which would be provided by the email service
  3. Enter an app_name and sender. These values will be used by the Nile auth to send your emails.
Be sure that sender is a valid email address. Some email services will reject emails that do not have a valid sender address.
2

Verify configuration

Once your SMTP server is configured, you can test the connection to ensure that it is working correctly. Select a template and at the bottom, click the Test email sending button. It will send an email to the email address of your developer account.

Most services require you to configure a test email. Use the email address associated with the single sign on account you used when you logged in.

3

Configure variables

You can use variables in your email templates to personalize the content. The following variables are available automatically:

  • user.email - the email of the user
  • user.name - if set, the name of the user
  • api_url - the URL of your application. This is used to generate links in the email that come back to the server handling Nile auth requests. By default, this is obtained from the headers of the request, but it is possible to hardcode and/or overide it

Additional variables can be used and will be replaced in the HTML sent using the ${variable} syntax. For example

<div>
  <div>Dear ${user.email}</div>
  <a href="${api_url}">
    Reset Your Password
  </a>
<div>

Was this page helpful?