IAM Service for Applications

The IAM Service for Applications allows you to add authentication and authorization features to your applications. This module enables you to implement the following:

  • Registration as a Service - It provides the account management capability native to the Synerise Growth Cloud Ecosystem, where all the account data stays within Synerise. This means that all account management can be implemented through our REST APIs or Mobile SDKs for:
  • Authentication as a Service - It provides the possibility to authenticate users, giving access to the vast amounts of resources at the Synerise Growth Cloud Ecosystem, through an external Identity Provider.
    Users authenticated through external services have their permissions elevated and are able to use the same resources as the ones who use the RaaS capability mentioned earlier. At present, we support authentication through:
    • OAuth (which is any external Identity Provider)
    • Sign in with Apple
    • Facebook
    • (Google authentication is planned for Q2 2021)
Note:
All authenticated users receive permissions as defined for the Client API Key

In this article, you can find instructions on:

Prerequisites


  • You must have access granted to the Settings module and permissions that allow performing actions there.
  • You must have access granted to the Email section in the Communication module and permissions that allow you to create and edit templates.
  • You must configure an email account from which emails will be sent.
  • If you want to assign loyalty card numbers you must have access granted to the Vouchers section and a configured Voucher Pool

General settings


This section provides the option to configure the general IAM Service settings along with the Registration as a Service feature.

Configuration of settings for account registration
Settings for general authentication and Registration as a Service

Account registration mode

Whenever you want to use our Registration as a Service feature, you must define which registration mode suits you best. Registration mode defines what is supposed to happen when a user registers an account in your application.

You can choose from the following options:

Registration mode Account activation Email ownership confirmation Consents / Attributes
Automatic account activation Automatically activated during registration No, to be implemented as a separate process email consent set to false,
snrs_email_confirmed attribute set to false
Email confirmation required Automatically activated during registration Yes, through email action email consent set to false,
snrs_email_confirmed attribute set to false

After email action changed to true
Account activation required Activation required through email action Yes, as part of activation email consent set to false,
snrs_email_confirmed attribute set to false

After email action changed to true

In order to configure the registration mode for Registration as a Service you need to:

  1. Go to Settings icon Settings > IAM for applications > General > Show.
  2. In the registration mode section, select one of the options:
    • Automatic account activation
    • Email confirmation required
    • Account activation required
  3. Click Apply in order to save the selection
Important:


When you select the Email confirmation required or Account activation required registration mode, you must also remember to:

Note:
After the registration of an account, the client.register event is generated on the profile of the user (in the Profiles module).

The account confirmation redirect link is a link to the website of your choice that a user will automatically be redirected to after the completion of account activation/confirmation.

To configure the link:

  1. Go to Settings icon Settings > IAM for applications > General > Show.
  2. In the Account confirmation redirect link, enter the URL where a user is to be redirected to after clicking the confirmation link (works for both scenarios: Email confirmation required and Account activation required).
  3. Click Apply in order to save the configuration

Loyalty card assignment


Both our Registration as a Service and Authentication as a Service features enable you to automatically assign loyalty card numbers, where after every successful registration or the first authentication, users will automatically have a code assigned from the pool. The value will be visible as customID on a user’s Profile.

At this stage, you should already have a configured Voucher Pool, which is a prerequisite:

To configure the card number assignment:

  1. Go to Settings icon Settings > IAM for applications > General > Show.
  2. From the dropdown list, select a voucher pool containing the codes to be used.
  3. Click Apply in order to save the configuration
Note:
In case you had user profiles imported with any pre-existing customID attributes you may consider enabling the customID overwrite feature.

JWT token lifetime


JWT tokens issued by Synerise have a default lifetime (expiration) equal to 3600 seconds (1 hour).

Whenever you want to change that to a different value, you have to:

  1. Go to Settings icon Settings > IAM for applications > General > Show.
  2. In the JWT token lifetime field, define the exact time (in seconds) the token will be valid for.
  3. Once done, confirm by clicking Apply.
Important:
Remember that changing the JWT token lifetime value does not impact previously issued JWT tokens and will be effective with token renewal or new authentication.

Custom ID


Whenever you implement loyalty card assignment for your users, it does not overwrite any existing customID attributes on user profiles by default. So, whenever you have a user profile with an existing value under the customID attribute, the value will not get changed to the one of the loyalty card. It may be useful in case you have legacy loyalty users and you do not want to overwrite their card numbers.

In case you want to allow the system to overwrite these values:

  1. Go to Settings icon Settings > IAM for applications > General > Show.
  2. In the Custom ID section, set the toggle to true.
  3. Once done, confirm by clicking Apply.
Important:
Make sure you have a large pool of codes and monitor the pool utilisation as the lack of codes will cause the registration/authentication features to fail.

Email Templates


Some operations related to user accounts require sending email notifications either to inform a user about something or to confirm something as part of the process. There are four main email templates, which are sent to the users of your application in the following cases:

  • Activation/Confirmation of an account or email address: depending on the configuration it may be an automated email or one triggered manually via dedicated API or SDK methods,
  • Password reset process: triggered through dedicated API or SDK methods,
  • Email address change request process: triggered through dedicated API or SDK methods,
  • Confirmation of email address change: triggered through dedicated API or SDK methods
Important:
If you do not create and select your templates, the system will use the default Synerise templates.
Selecting system email templates
Selecting system email templates
Note:
You can find example email templates in Communication > Email > Templates > Featured.
You can reuse them or make your own by modifying the examples.

In order to configure the templates that you want to use:

  1. Create an email template or import it to Synerise and save it.
  2. Go to Settings icon Settings > IAM for applications > Templates > Show.
  3. For a system email template, from the dropdown list, select a previously prepared email template.
  4. Above the dropdown list, in the Email subject enter the subject of the email that will be displayed in the inbox.
  5. Confirm the settings by clicking Apply.

Example account confirmation template

Account confirmation template
Account confirmation template
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <style type="text/css"> /* Outlines the grid, remove when sending */ table td { /* border: 1px solid cyan; */ } /* CLIENT-SPECIFIC STYLES */ body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } table, td { mso-table-lspace: 0pt; mso-table-rspace: 0pt; } img { -ms-interpolation-mode: bicubic; } /* RESET STYLES */ img { border: 0; outline: none; text-decoration: none; } table { border-collapse: collapse !important; } body { margin: 0 !important; padding: 0 !important; width: 100% !important; } /* iOS BLUE LINKS */ a[x-apple-data-detectors] { color: inherit !important; text-decoration: none !important; font-size: inherit !important; font-family: Arial, sans-serif !important; font-weight: inherit !important; line-height: inherit !important; } /* ANDROID CENTER FIX */ div[style*="margin: 16px 0;"] { margin: 0 !important; } </style>
   </head>
   <body style="margin:0; padding:0; background-color:#fff;">
      <center>
         <div style="background-color:#fff; max-width: 600px; margin: auto;">
            <!--[if mso]>
            <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" align="center">
               <tr>
                  <td>
                     <![endif]-->
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="200" align="left" valign="middle" style="padding:10px;"> <img alt="Synerise" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/030d47ff7f497bf302d3248641a216ad.png" style="width: 140px;"> </td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                   <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 28px; font-family: Arial, sans-serif; color:#384350"> Hi, {% user firstname %}  </td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"> <img width="91" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/38937e17f860105ccfea3df81558734b.png" alt="" /> </td>
                                 </tr>
                                 <tr>
                                   <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 22px; font-family: Arial, sans-serif; color:#384350"> Please confirm your account to start working with Synerise </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="400" align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Thank you for choosing Synerise. Before you can start your adventure with us, you need to confirm your account. </td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px"> <a style="background-color: #0c68ff;border-color: #0c68ff;color: #ffffff;cursor: pointer;display: inline-block;font-size: 14px;font-weight: 500;margin: 0;padding: 12px 25px;text-decoration: none;text-transform: capitalize; border: solid 1px #0c68ff;border-radius: 3px;box-sizing: border-box;font-family: Arial, sans-serif;" href="{{ client_confirmation_link }}" target="_blank">Confirm account</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Once you confirm your account, you will be able to sign-in to <a href="#" style="color: #0c68ff; font-weight: bold;">app.synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Have a good day,<br /> The Synerise Team </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;">
                                       <hr style="border: 1px solid #e5e5e5;" />
                                    </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 22px;"> Have questions? The Synerise Team is here to help.<br /> Please contact <a href="support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.facebook.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/778ed84375be209b05f2fb333f7bbb16.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.youtube.com/c/Synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/eadde6165d2421eb5f98d9654006d9ee.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.linkedin.com/company/synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/42126cc8dfb468a79dc4b37c45082b78.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://twitter.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/f2512acc01435e5cd10edfc0e419908b.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="500" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                 <td align="left" valign="middle" style="padding:10px; font-size: 10px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 16px;">The administrator of your personal data is SYNERISE S.A. with its registered office at ul. Lubostroń 1, 30-383 Kraków,entered into the Register of Entrepreneurs of the National Court Register by the District Court for Kraków-Śródmieście in Kraków, 11th Commercial Division of the National Court Register under the number: 0000468034. You can contact the Administrator regarding the protection of personal data by email at the followingaddress: <a target="_blank" href="mailto:iod@synerise.com">iod@synerise.com</a>, or by traditional mail sent to the address of the Administrator's seat, i.e. SYNERISE S.A. ul. Lubostroń 1.30-383 Kraków.
                                 </td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <!--[if mso]>
                  </td>
               </tr>
            </table>
            <![endif]-->
         </div>
      </center>
   </body>
</html>

Example email change request template

Email change request template
Email change request template
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <style type="text/css"> /* Outlines the grid, remove when sending */ table td { /* border: 1px solid cyan; */ } /* CLIENT-SPECIFIC STYLES */ body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } table, td { mso-table-lspace: 0pt; mso-table-rspace: 0pt; } img { -ms-interpolation-mode: bicubic; } /* RESET STYLES */ img { border: 0; outline: none; text-decoration: none; } table { border-collapse: collapse !important; } body { margin: 0 !important; padding: 0 !important; width: 100% !important; } /* iOS BLUE LINKS */ a[x-apple-data-detectors] { color: inherit !important; text-decoration: none !important; font-size: inherit !important; font-family: Arial, sans-serif !important; font-weight: inherit !important; line-height: inherit !important; } /* ANDROID CENTER FIX */ div[style*="margin: 16px 0;"] { margin: 0 !important; } </style>
   </head>
   <body style="margin:0; padding:0; background-color:#fff;">
      <center>
         <div style="background-color:#fff; max-width: 600px; margin: auto;">
            <!--[if mso]>
            <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" align="center">
               <tr>
                  <td>
                     <![endif]-->
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="200" align="left" valign="middle" style="padding:10px;"> <img alt="Synerise" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/030d47ff7f497bf302d3248641a216ad.png" style="width: 140px;"> </td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                  <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 28px; font-family: Arial, sans-serif; color:#384350"> Hi, {% user firstname %}  </td>
                                   <td width="200" align="center" valign="middle" style="padding:10px;"> <img width="91" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/38937e17f860105ccfea3df81558734b.png" alt="" /> </td>
                                </tr>
                                <tr>
                                 <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 22px; font-family: Arial, sans-serif; color:#384350"> We heard you need to change e-mail address of your account</td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px"> <a style="background-color: #0c68ff;border-color: #0c68ff;color: #ffffff;cursor: pointer;display: inline-block;font-size: 14px;font-weight: 500;margin: 0;padding: 12px 25px;text-decoration: none;text-transform: capitalize; border: solid 1px #0c68ff;border-radius: 3px;box-sizing: border-box;font-family: Arial, sans-serif;" href="{{client_email_change_url}}" target="_blank">Confirm e-mail change</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Once you confirm e-mail change you may sign-in with your updated credentials. </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If you haven't initiated e-mail change please do not confirm that process and contact with our Support Team immediately through e-mail: <a href="mailto:support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Have a good day,<br /> The Synerise Team </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;">
                                       <hr style="border: 1px solid #e5e5e5;" />
                                    </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 22px;"> Have questions? The Synerise Team is here to help.<br /> Please contact <a href="support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.facebook.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/778ed84375be209b05f2fb333f7bbb16.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.youtube.com/c/Synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/eadde6165d2421eb5f98d9654006d9ee.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.linkedin.com/company/synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/42126cc8dfb468a79dc4b37c45082b78.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://twitter.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/f2512acc01435e5cd10edfc0e419908b.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="500" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                 <td align="left" valign="middle" style="padding:10px; font-size: 10px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 16px;">The administrator of your personal data is SYNERISE S.A. with its registered office at ul. Lubostroń 1, 30-383 Kraków,entered into the Register of Entrepreneurs of the National Court Register by the District Court for Kraków-Śródmieście in Kraków, 11th Commercial Division of the National Court Register under the number: 0000468034. You can contact the Administrator regarding the protection of personal data by email at the followingaddress: <a target="_blank" href="mailto:iod@synerise.com">iod@synerise.com</a>, or by traditional mail sent to the address of the Administrator's seat, i.e. SYNERISE S.A. ul. Lubostroń 1.30-383 Kraków.
                                 </td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <!--[if mso]>
                  </td>
               </tr>
            </table>
            <![endif]-->
         </div>
      </center>
   </body>
</html>

Example email change confirmation template

Selecting system email templates
Email change confirmation template
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <style type="text/css"> /* Outlines the grid, remove when sending */ table td { /* border: 1px solid cyan; */ } /* CLIENT-SPECIFIC STYLES */ body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } table, td { mso-table-lspace: 0pt; mso-table-rspace: 0pt; } img { -ms-interpolation-mode: bicubic; } /* RESET STYLES */ img { border: 0; outline: none; text-decoration: none; } table { border-collapse: collapse !important; } body { margin: 0 !important; padding: 0 !important; width: 100% !important; } /* iOS BLUE LINKS */ a[x-apple-data-detectors] { color: inherit !important; text-decoration: none !important; font-size: inherit !important; font-family: Arial, sans-serif !important; font-weight: inherit !important; line-height: inherit !important; } /* ANDROID CENTER FIX */ div[style*="margin: 16px 0;"] { margin: 0 !important; } </style>
   </head>
   <body style="margin:0; padding:0; background-color:#fff;">
      <center>
         <div style="background-color:#fff; max-width: 600px; margin: auto;">
            <!--[if mso]>
            <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" align="center">
               <tr>
                  <td>
                     <![endif]-->
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="200" align="left" valign="middle" style="padding:10px;"> <img alt="Synerise" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/030d47ff7f497bf302d3248641a216ad.png" style="width: 140px;"> </td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                  <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 28px; font-family: Arial, sans-serif; color:#384350"> Hi, {% user firstname %}  </td>
                                   <td width="200" align="center" valign="middle" style="padding:10px;"> <img width="91" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/38937e17f860105ccfea3df81558734b.png" alt="" /> </td>
                                </tr>
                                <tr>
                                 <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 22px; font-family: Arial, sans-serif; color:#384350"> We have changed your e-mail address</td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> E-mail address associated with your account has been successfully changed per your request. Your new e-mail address: {{new_email}}</td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If you haven't initiated e-mail change please contact with our Support Team immediately through e-mail: <a href="mailto:support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Have a good day,<br /> The Synerise Team </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;">
                                       <hr style="border: 1px solid #e5e5e5;" />
                                    </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 22px;"> Have questions? The Synerise Team is here to help.<br /> Please contact <a href="support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.facebook.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/778ed84375be209b05f2fb333f7bbb16.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.youtube.com/c/Synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/eadde6165d2421eb5f98d9654006d9ee.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.linkedin.com/company/synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/42126cc8dfb468a79dc4b37c45082b78.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://twitter.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/f2512acc01435e5cd10edfc0e419908b.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="500" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                 <td align="left" valign="middle" style="padding:10px; font-size: 10px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 16px;">The administrator of your personal data is SYNERISE S.A. with its registered office at ul. Lubostroń 1, 30-383 Kraków,entered into the Register of Entrepreneurs of the National Court Register by the District Court for Kraków-Śródmieście in Kraków, 11th Commercial Division of the National Court Register under the number: 0000468034. You can contact the Administrator regarding the protection of personal data by email at the followingaddress: <a target="_blank" href="mailto:iod@synerise.com">iod@synerise.com</a>, or by traditional mail sent to the address of the Administrator's seat, i.e. SYNERISE S.A. ul. Lubostroń 1.30-383 Kraków.
                                 </td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <!--[if mso]>
                  </td>
               </tr>
            </table>
            <![endif]-->
         </div>
      </center>
   </body>
</html>

Example password reset template

Password reset template
Password reset template
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <style type="text/css"> /* Outlines the grid, remove when sending */ table td { /* border: 1px solid cyan; */ } /* CLIENT-SPECIFIC STYLES */ body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } table, td { mso-table-lspace: 0pt; mso-table-rspace: 0pt; } img { -ms-interpolation-mode: bicubic; } /* RESET STYLES */ img { border: 0; outline: none; text-decoration: none; } table { border-collapse: collapse !important; } body { margin: 0 !important; padding: 0 !important; width: 100% !important; } /* iOS BLUE LINKS */ a[x-apple-data-detectors] { color: inherit !important; text-decoration: none !important; font-size: inherit !important; font-family: Arial, sans-serif !important; font-weight: inherit !important; line-height: inherit !important; } /* ANDROID CENTER FIX */ div[style*="margin: 16px 0;"] { margin: 0 !important; } </style>
   </head>
   <body style="margin:0; padding:0; background-color:#fff;">
      <center>
         <div style="background-color:#fff; max-width: 600px; margin: auto;">
            <!--[if mso]>
            <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" align="center">
               <tr>
                  <td>
                     <![endif]-->
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="200" align="left" valign="middle" style="padding:10px;"> <img alt="Synerise" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/030d47ff7f497bf302d3248641a216ad.png" style="width: 140px;"> </td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                  <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 28px; font-family: Arial, sans-serif; color:#384350"> Hi, {% user firstname %}  </td>
                                   <td width="200" align="center" valign="middle" style="padding:10px;"> <img width="91" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/38937e17f860105ccfea3df81558734b.png" alt="" /> </td>
                                </tr>
                                <tr>
                                 <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 22px; font-family: Arial, sans-serif; color:#384350"> We heard you need a password reset for your account:</td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 18px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;font-weight: bold;"> {% customer email %} </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> You have two optons to choose:</td>
                                 </tr>
                                 <tr>
                                    <td align="left" valign="middle" style="padding:0px 10px 10px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;">
                                       <ul>
                                          <li>If you don't want to reset your password, just ignore this email and your current password will still be in use.</li>
                                          <li>If you still want to reset the password, click the button below.</li>
                                       </ul>
                                    </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px"> <a style="background-color: #0c68ff;border-color: #0c68ff;color: #ffffff;cursor: pointer;display: inline-block;font-size: 14px;font-weight: 500;margin: 0;padding: 12px 25px;text-decoration: none;text-transform: capitalize; border: solid 1px #0c68ff;border-radius: 3px;box-sizing: border-box;font-family: Arial, sans-serif;" href="{{password_reset_url}}" target="_blank">Reset password</a> </td>
                                 </tr>
                                 <tr>
                                   <td align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If you don't see link above please copy the following url into your web browser:<br><br>{{password_reset_url}}</td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Have a good day,<br /> The Synerise Team </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;">
                                       <hr style="border: 1px solid #e5e5e5;" />
                                    </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 22px;"> Have questions? The Synerise Team is here to help.<br /> Please contact <a href="support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.facebook.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/778ed84375be209b05f2fb333f7bbb16.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.youtube.com/c/Synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/eadde6165d2421eb5f98d9654006d9ee.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.linkedin.com/company/synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/42126cc8dfb468a79dc4b37c45082b78.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://twitter.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/f2512acc01435e5cd10edfc0e419908b.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="500" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                 <td align="left" valign="middle" style="padding:10px; font-size: 10px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 16px;">The administrator of your personal data is SYNERISE S.A. with its registered office at ul. Lubostroń 1, 30-383 Kraków,entered into the Register of Entrepreneurs of the National Court Register by the District Court for Kraków-Śródmieście in Kraków, 11th Commercial Division of the National Court Register under the number: 0000468034. You can contact the Administrator regarding the protection of personal data by email at the followingaddress: <a target="_blank" href="mailto:iod@synerise.com">iod@synerise.com</a>, or by traditional mail sent to the address of the Administrator's seat, i.e. SYNERISE S.A. ul. Lubostroń 1.30-383 Kraków.
                                 </td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <!--[if mso]>
                  </td>
               </tr>
            </table>
            <![endif]-->
         </div>
      </center>
   </body>
</html>

Explanation of Jinjava tags used in the email templates

Name Description Template
{% customer firstname %} This is a standard Jinjava tag to insert a user's first name.
You can use other Jinjava tags related to {% customer … %}
All templates
{{client_confirmation_link}} This Jinjava tag provides a generic
Synerise link to confirm an account/email.
https://api.synerise.com/sauth/client/confirmation/_profile_hash_/{{client_confirmation_token}}
Account or
email confirmation
templates
{{client_confirmation_token}} This Jinjava tag provides a confirmation token and can be used
in case you want to pass the confirmation token through
your website and Universal Links to be captured by a Mobile Application, for example:
https://example.org/account/confirmation?=client_confirmation_token
Account or
email confirmation
templates
{% customer email %} This Jinjava tag inserts the email address of the user's account that requires a password reset. Password
reset
{{password_reset_url}} This Jinjava tag provides a generic
Synerise link to a password reset form, for example:
https://api.synerise.com/sauth/clients/password-reset/form/_profile_hash_/{{password_reset_token}}
Password
reset
{{password_reset_token}} This Jinjava tag provides a password reset token
used in case you want to pass the reset token through
your website and Universal Links to be captured by a Mobile Application, for example:
https://example.org/account/password-reset?=password_reset_token
Password
reset
{{client_email_change_url}} This Jinjava tag provides a generic Synerise link
for an email change process, for example:
https://api.synerise.com/sauth/clients/email-change/form/_profile_hash_/{{client_email_change_token}}
Email change
{{client_email_change_token}} This Jinjava tag provides an email change token
and can be used in case you want to pass the email change token through
your website and Universal Links to be captured by a Mobile Application, for example:
https://example.org/account/email-change?=client_email_change_token
Email change
{{new_email}} This Jinjava tag holds the value of the new email address that was provided during the email change process. Email change

Password policy


This section provides the possibility to define a password policy suitable to your application. When a user creates an account, the password must meet the password policy requirements.

Password policy
Example of a password policy
  1. Go to Settings icon Settings > Access Control.
  2. In the Password settings section, click Show.
  3. In the Length section, use the slider to define the minimum and maximum number of characters in a password.
  4. In the Characters section:
    1. To require uppercase characters in a password, switch the Uppercases (A-Z) toggle on and enter the number.
    2. To require lowercase characters in a password, switch the Lowercases (a-z) toggle on and enter the number.
    3. To require numbers in a password, switch the Numbers (0-9) toggle on and enter the number.
    4. To require special characters in a password, switch the Symbols (0-9) toggle on and enter the number. The allowed special characters are: !"#$%&'()*+,-./:;<=>?@[\]^_{|}~
  5. Confirm by clicking Apply.

Third party authentication


You can have users authorize into your application through third party solutions. Synerise offers authorization through:

  • Apple
  • Facebook
  • OAuth
Important:
Integration with Google is coming in Q2 2021.

Sign in with Apple


WARNING:
Before configuring the Sign in with Apple authentication, you must implement Sign in with Apple in your application.
Settings for authorizing through Apple
Settings for authorizing through Apple
  1. Go to Settings icon Settings > IAM for applications.
  2. In the Third-party authentication section, click Show.
  3. Switch the Sign-in with Apple toggle on.
  4. In the App bundle identifier field, enter the bundle identifier (it is in a reverse domain name notation).
    Important:
    This is NOT the AppleID.
  5. Confirm by clicking Apply.

Facebook


Important:
Before you configure Facebook authentication in Synerise, you must implement it in your application.

Currently, there are no dedicated settings related to Facebook authentication on the interface. You have to implement RESTful API or SDK methods to authenticate through Facebook.

OAuth


OAuth is not the actual OAuth as may be understood per RFC6749: The OAuth 2.0 Authorization Framework. This feature allows you to configure authentication through your existing IT systems that have RESTful APIs, where we are able to authenticate a person through an HTTP GET call to an endpoint (checking if the provided token is valid and returning a response with the user’s data).

Configuring OAuth authorization
Configuring OAuth authorization
  1. Go to Settings icon Settings > IAM for applications.
  2. In the OAuth section, click Show.
  3. In the Endpoint Configuration, in the Endpoint name field, enter the name (it can be anything).
  4. Enter the URL of the endpoint (GET method).
  5. In the Headers section, enter all headers which are required by the endpoint you entered in the previous step.
  6. In the Identification based on OAuth response data section, you can:
    • Leave the settings to default (True) - customID from the OAuth backend is used to authorize a user
    • Set the toggle to False - customID from the application is applied
Important:
Define all the headers that are required by your OAuth endpoint

Result: According to the example presented in the image, when a customer is authorized, an account is either created or updated and the values from the customID, email, first name and last name fields are assigned to the corresponding attributes of this account.

Access Control


In this section, you can configure the behavior of the system related to suspicious or unknown traffic in regard to the authentication of your user accounts. This section applies to Synerise’s native Registration as a Service feature and its logic is based on the following factors:

  • IP address
  • deviceID
  • UUID

So whenever unknown factors are at work, they may trigger control mechanisms or even ban an account, in case of a brute force attack.

Unknown device control

Unknown device control is a feature that determines the behavior for the authentication of previously unknown devices, and contains three modes of operation:

Turned off

  • Authentication is allowed regardless of it being from an unknown device
  • Lack of notifications when users authenticate from an unknown device

Approve logging-in from unknown devices through links in notifications

  • Authentication is not allowed until you confirm it by clicking the link in the notification email
  • Notifications are sent when users authenticate from an unknown device

Receive notifications without the need to approve logging-in from unknown devices

  • Authentication is allowed regardless of it being from an unknown device
  • Notifications are sent with information about logging-in from an unknown device
Control access based on devices
Settings for unknown device access
Note:
You can find example email templates in Communication > Email > Templates > Featured.
You can reuse them or make your own by modifying the examples.

In order to configure the desired behavior for your users, you have to:

  1. Go to Settings icon Settings > IAM for applications.

  2. In the Unknown device control section, click Show.

  3. From the Unknown device mode dropdown list, select one of the following options:

    • Turned off - You won’t receive notifications if a user logs in from an unknown device.
    • Approve logging from unknown devices through links in notifications - You will receive emails with links to click to let a user in to your application from an unknown device.
    • Receive notifications without the need to approve logging from unknown devices - you will only receive emails with information that a user logged in to your application from an unknown device
    Select the template of the notification
    Selecting the template of the notification
  4. From the Notification template dropdown list, select a template. You can make use of the default templates and edit them according to your preferences. You can find them in the Featured folder in Templates.

  5. Confirm by clicking Apply.

Example confirmation of a sign in from an unknown device template

Confirmation of a sign in from an unknown device template
Confirmation of a sign in from an unknown device template
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <style type="text/css"> /* Outlines the grid, remove when sending */ table td { /* border: 1px solid cyan; */ } /* CLIENT-SPECIFIC STYLES */ body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } table, td { mso-table-lspace: 0pt; mso-table-rspace: 0pt; } img { -ms-interpolation-mode: bicubic; } /* RESET STYLES */ img { border: 0; outline: none; text-decoration: none; } table { border-collapse: collapse !important; } body { margin: 0 !important; padding: 0 !important; width: 100% !important; } /* iOS BLUE LINKS */ a[x-apple-data-detectors] { color: inherit !important; text-decoration: none !important; font-size: inherit !important; font-family: Arial, sans-serif !important; font-weight: inherit !important; line-height: inherit !important; } /* ANDROID CENTER FIX */ div[style*="margin: 16px 0;"] { margin: 0 !important; } </style>
   </head>
   <body style="margin:0; padding:0; background-color:#fff;">
      <center>
         <div style="background-color:#fff; max-width: 600px; margin: auto;">
            <!--[if mso]>
            <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" align="center">
               <tr>
                  <td>
                     <![endif]-->
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="200" align="left" valign="middle" style="padding:10px;"> <img alt="Synerise" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/030d47ff7f497bf302d3248641a216ad.png" style="width: 140px;"> </td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                  <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 28px; font-family: Arial, sans-serif; color:#384350"> Hi, {% user firstname %}  </td>
                                   <td width="200" align="center" valign="middle" style="padding:10px;"> <img width="91" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/38937e17f860105ccfea3df81558734b.png" alt="" /> </td>
                                </tr>
                                <tr>
                                 <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 22px; font-family: Arial, sans-serif; color:#384350"> There was a new sign-in attempt to your account. Was it you? </td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td width="400" align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> We have spotted a new sign in to your account <strong>{% customer email %}</strong>. We want to make sure that it was you. Have a look at the details: <br><br></td>
                                    <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                   <td width="50" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <strong>Country:</strong> </td>
                                   <td width="550" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> {{ country }}</td>
                                </tr>
                                <tr>
                                   <td width="50" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <strong>IP address:</strong> </td>
                                   <td width="550" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> {{ ip }}</td>
                                </tr>
                                <tr>
                                   <td width="50" align="left" valign="middle" style="padding:0px 10px 10px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <strong>Time: </strong> </td>
                                   <td width="550" align="left" valign="middle" style="padding:0px 10px 10px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> {{ login_time }}</td>
                                </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If it was you and you recognize this sign-in attempt, please click the link below to confirm that device (this will enable it for sign-in to your account) </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <a href="{{ device_control_url }}" style="color: #0c68ff; font-weight: bold;">Yes, it's me!</a>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If you find results related to you on either of these sites, we strongly recommend to review your passwords across all online services you use. </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <a href="#" style="color: #0c68ff; font-weight: bold;">haveibeenpwned.com</a><br /> <a href="#" style="color: #0c68ff; font-weight: bold;">monitor.firefox.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If you do not recognize this sign-in attempt, we recommend you to change your password directly in the app and also check if your email account is not a part of any known password leaks. You can do that at: </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Have a good day,<br /> The Synerise Team </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;">
                                       <hr style="border: 1px solid #e5e5e5;" />
                                    </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 22px;"> Have questions? The Synerise Team is here to help.<br /> Please contact <a href="support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.facebook.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/778ed84375be209b05f2fb333f7bbb16.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.youtube.com/c/Synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/eadde6165d2421eb5f98d9654006d9ee.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.linkedin.com/company/synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/42126cc8dfb468a79dc4b37c45082b78.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://twitter.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/f2512acc01435e5cd10edfc0e419908b.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                   <td width="500" align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                <tr>
                                 <td align="left" valign="middle" style="padding:10px; font-size: 10px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 16px;">The administrator of your personal data is SYNERISE S.A. with its registered office at ul. Lubostroń 1, 30-383 Kraków,entered into the Register of Entrepreneurs of the National Court Register by the District Court for Kraków-Śródmieście in Kraków, 11th Commercial Division of the National Court Register under the number: 0000468034. You can contact the Administrator regarding the protection of personal data by email at the followingaddress: <a target="_blank" href="mailto:iod@synerise.com">iod@synerise.com</a>, or by traditional mail sent to the address of the Administrator's seat, i.e. SYNERISE S.A. ul. Lubostroń 1.30-383 Kraków.
                                 </td>
                              </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                        <tr>
                           <td align="center" valign="middle" style="padding:5px 10px;">
                              <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="center" valign="middle" style="padding:10px;"></td>
                                 </tr>
                              </table>
                           </td>
                        </tr>
                     </table>
                     <!--[if mso]>
                  </td>
               </tr>
            </table>
            <![endif]-->
         </div>
      </center>
   </body>
</html>

Example information about a sign in from an unknown device template

Template for an email with information about a sign in from an unknown device
Template for an email with information about a sign in from an unknown device
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   <html lang="en">
      <head>
         <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
         <meta name="viewport" content="width=device-width, initial-scale=1">
         <meta http-equiv="X-UA-Compatible" content="IE=edge">
         <style type="text/css"> /* Outlines the grid, remove when sending */ table td { /* border: 1px solid cyan; */ } /* CLIENT-SPECIFIC STYLES */ body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; } table, td { mso-table-lspace: 0pt; mso-table-rspace: 0pt; } img { -ms-interpolation-mode: bicubic; } /* RESET STYLES */ img { border: 0; outline: none; text-decoration: none; } table { border-collapse: collapse !important; } body { margin: 0 !important; padding: 0 !important; width: 100% !important; } /* iOS BLUE LINKS */ a[x-apple-data-detectors] { color: inherit !important; text-decoration: none !important; font-size: inherit !important; font-family: Arial, sans-serif !important; font-weight: inherit !important; line-height: inherit !important; } /* ANDROID CENTER FIX */ div[style*="margin: 16px 0;"] { margin: 0 !important; } </style>
      </head>
      <body style="margin:0; padding:0; background-color:#fff;">
         <center>
            <div style="background-color:#fff; max-width: 600px; margin: auto;">
               <!--[if mso]>
               <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" align="center">
                  <tr>
                     <td>
                        <![endif]-->
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="center" valign="middle" style="padding:10px;"></td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td width="200" align="left" valign="middle" style="padding:10px;"> <img alt="Synerise" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/030d47ff7f497bf302d3248641a216ad.png" style="width: 140px;"> </td>
                                       <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                       <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 28px; font-family: Arial, sans-serif; color:#384350"> Hi, {% user firstname %}  </td>
                                       <td width="200" align="center" valign="middle" style="padding:10px;"> <img width="91" src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/38937e17f860105ccfea3df81558734b.png" alt="" /> </td>
                                    </tr>
                                    <tr>
                                       <td width="400" align="left" valign="middle" style="padding:10px; font-weight: bold; font-size: 22px; font-family: Arial, sans-serif; color:#384350"> There was a new sign-in to your account. Was it you? </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td width="400" align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> We have spotted a new sign in to your account <strong>{% customer email %}</strong>. We want to make sure that it was you. <br><br>Have a look at the details: </td>
                                       <td width="200" align="center" valign="middle" style="padding:10px;"></td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td width="50" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <strong>Country:</strong> </td>
                                       <td width="550" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> {{ country }}</td>
                                    </tr>
                                    <tr>
                                       <td width="50" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <strong>IP address:</strong> </td>
                                       <td width="550" align="left" valign="middle" style="padding:10px 10px 0px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> {{ ip }}</td>
                                    </tr>
                                    <tr>
                                       <td width="50" align="left" valign="middle" style="padding:0px 10px 10px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <strong>Time: </strong> </td>
                                       <td width="550" align="left" valign="middle" style="padding:0px 10px 10px 10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> {{ login_time }}</td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If you do not recognize this sign-in attempt, we recommend you to change your password directly in the app and also check if your email account is not a part of any known password leaks. You can do that at: </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> <a href="#" style="color: #0c68ff; font-weight: bold;">haveibeenpwned.com</a><br /> <a href="#" style="color: #0c68ff; font-weight: bold;">monitor.firefox.com</a> </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> If you find results related to you on either of these sites, we strongly recommend to review your passwords across all online services you use. </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="center" valign="middle" style="padding:10px;"></td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#384350;line-height: 22px;"> Have a good day,<br /> The Synerise Team </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="center" valign="middle" style="padding:10px;">
                                          <hr style="border: 1px solid #e5e5e5;" />
                                       </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="left" valign="middle" style="padding:10px; font-size: 14px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 22px;"> Have questions? The Synerise Team is here to help.<br /> Please contact <a href="support@synerise.com" style="color: #0c68ff; font-weight: bold;">support@synerise.com</a> </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.facebook.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/778ed84375be209b05f2fb333f7bbb16.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.youtube.com/c/Synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/eadde6165d2421eb5f98d9654006d9ee.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://www.linkedin.com/company/synerise/"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/42126cc8dfb468a79dc4b37c45082b78.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="25" align="center" valign="middle" style="padding:10px;"> <a href="https://twitter.com/synerise"><img src="https://upload.snrcdn.net/9bbb7035ecf3565cceed63d321d7d9b31236850d/default/origin/f2512acc01435e5cd10edfc0e419908b.png" width="20" style="margin:0; padding:0; border:none; display:block;" border="0" class="img" alt=""></a> </td>
                                    <td width="500" align="center" valign="middle" style="padding:10px;"></td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                 <tr>
                                    <td align="left" valign="middle" style="padding:10px; font-size: 10px;font-family: Arial, sans-serif; color:#b6bdc4;line-height: 16px;">The administrator of your personal data is SYNERISE S.A. with its registered office at ul. Lubostroń 1, 30-383 Kraków,entered into the Register of Entrepreneurs of the National Court Register by the District Court for Kraków-Śródmieście in Kraków, 11th Commercial Division of the National Court Register under the number: 0000468034. You can contact the Administrator regarding the protection of personal data by email at the followingaddress: <a target="_blank" href="mailto:iod@synerise.com">iod@synerise.com</a>, or by traditional mail sent to the address of the Administrator's seat, i.e. SYNERISE S.A. ul. Lubostroń 1.30-383 Kraków.
                                    </td>
                                 </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;" bgcolor="#FFFFFF">
                           <tr>
                              <td align="center" valign="middle" style="padding:5px 10px;">
                                 <table width="600" cellspacing="0" cellpadding="0" border="0" align="center" style="max-width:600px; width:100%;">
                                    <tr>
                                       <td align="center" valign="middle" style="padding:10px;"></td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                        <!--[if mso]>
                     </td>
                  </tr>
               </table>
               <![endif]-->
            </div>
         </center>
      </body>
   </html>
   

Explanation of the Jinjava tags used in the templates

Data Insert Descritpion
{% customer firstname %} This is a standard Jinjava tag to insert a user’s first name. You can use other Jinjava tags related to {% customer … %}
{{email}} This Jinjava tag inserts the user’s email to indicate the account used in the sign-in attempt.
{{device_control_url}} This Jinjava tag will insert a link to approve a sign-in attempt. Only used when you want unknown device sign-ins to be approved by a user.
{{country}} This Jinjava tag inserts the name of the country where the sign-in attempt was made from (based on IP geolocation).
{{ip}} This Jinjava tag inserts the IP address of the device used in a sign-in attempt.
{{login_time}} This Jinjava tag inserts the time of a sign-in attempt.

Fail to ban settings


The fail to ban feature will ban any device, UUID or IP address that is having too many failed login attempts. Fail to ban applies to Registration as a Service.

Important: There are three ban levels. The first two ban the customer’s UUID and device ID, the third one bans the IP.
Ban settings
Ban settings

As a security measure, you can set the three-stage ban on accounts to which a user failed to log in to X times within a defined time range.

  1. Go to Settings icon Settings > IAM for applications.
  2. In the Fail 2 ban settings section, click Show.
  3. Define the settings for each stage of the ban process:
    1. In the Failed attempts collection period, enter the time during which the login attempts are tracked. It is counted from the first attempt of logging in.
    2. In the Ban duration, enter the time during which a user is not able to log in to the application.
    3. In the Max failed auth. attempts, enter the number of failed attempts allowed. Example:
    Configuration of the settings for banning accounts on failed authorization
    Example
    In this configuration, if a user exceeds 10 failed login attempts within 120 seconds, they are banned for 5 minutes.
  4. Confirm by clicking Apply.

Untrusted traffic


There is a global mechanism implemented that keeps your user accounts safe, the untrusted traffic filtering, which rejects traffic from hosts that are known to be used in hacking attacks around the world. This covers all of the TOR network traffic, public proxies and more.

FAQ


List of Frequently Asked Questions

What's triggering Unknown device control feature?

Unknown device control is triggered in case there’s an sign-in attempt from previously unknown device (deviceId parameter in sign-in request). DeviceId is an identifier generated by:

  • Mobile apps: Operating System for each application install and transparent to you as our Mobile SDK utilises that
  • Web / Apps: it depends on implementation as you’re in control of how deviceId is generated

Troubleshooting


The list below presents the most common problems:

I receive a Template does not contain one of required data insert error message

Whenever you receive this error, it indicates that the selected email template does not contain one of the required data inserts (Jinjava tag) that were mentioned in this article.

I have configured an OAuth endpoint but my users receive an HTTP 400 error

An HTTP 400 error message in case of the Oauth type authentication is mostly the result of an incorrect data mapping. In case that is the problem, there will be information such as "Key email not found in oauth data" under the message key, and this usually means that the response from the endpoint you have configured did not contain the key that is mentioned.

In all other cases, the problem lies in the input data coming from your application.

😕

We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

😉

Awesome!

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.