An OTP token's QR code can be sent to the user by email. This process is called "push token" to users.
A token can be pushed to the user by the server automatically or pushed to the user manually by the administrator in the admin console. Either way, a message template called "Push Token" will be used to create the email message. Therefore, you must customize the Push Token message temple first if you want users to receive their token's QR code by email.
Customize Push Token Message Template
You must customize the message template according to your requirements.
SMTP Template
If you want the server to push OTP tokens to users by email, then you need to customize the SMTP Template
Navigate to Customization | Message Templates | Push Token | SMTP Templates
Typically, you would need to change the Sender, Subject, and Text field which is the body of the message.
There are 3 wildcards that you can use in the message body depending on your requirements
| Wildcard | Remarks | Examples |
|---|---|---|
[[LINK]] | This wildcard represents the download link of the user's MobileID token. Use this wildcard if you want to send the token's download link to the user. |
|
[[QRCODE]] | This wildcard represents the QR code image of the user's OTP token. Use this wildcard if you want to send the token's QR code to the user. |
|
[[AUTHZCODE]] | Depending on the token's policy, installing an OTP token might require an authorization code. This wildcard represents the authorization code of the user's token if it is required. |
You must select "HTML Format" if include the wirldcard [[QRCODE]] in the message text.
SMS Template
If you want the server to push OTP tokens to users by SMS message, then you need to customize the SMS Template
Navigate to Customization | Message Templates | Push Token | SMS Templates
Below is an example of the Push Token SMTP message template
Push Token Manually
The following procedure demonstrates how the system administrator can send the QR code to users by emails
Navigate to "Directory | Users", select the domain for your external directory, then for a selected user left click on the context menu and select "Tokens";
The token details for the selected user will now be show, left click on the context menu of the token to be pushed to the user then select the message channel to send the token (normally "By Email");
The QR code for the selected token will now be sent to the user by email.
End User Experience
Once the token has been sent to the user an email will arrive that includes the required QR code (example below);
