Contents x
    Customize The Mobile Enrollment Message
    • 19 Dec 2022
    • 1 Minute to read
    • Contributors
    • Print
    • Dark
      Light
    Contents

    Customize The Mobile Enrollment Message

    • Updated on 19 Dec 2022
    • 1 Minute to read
    • Contributors
    • Print
    • Dark
      Light
    Article summary

    It's possible to customize the enrollment email that is sent to your users when hitting the "Send SMS" or "Email QR Code". In the following steps, we will only need direct access to your external server and a text editor of your choice. We will be using Notepad in this example.


    Check Your Version

    The file paths used are under the assumption that your MFA server is on 4.9.5.1 or later. If it is not, it is strongly recommended to upgrade. Please see our server upgrade information page for more information.


    1. In your File Explorer, navigate to the following path:
      C:\Program Files\Identity Automation\RapidIdentity MFA\WebSite\support_files

    2. Locate the file "SMSRegister.txt" (towards the bottom of the folder).

    3. Click to open this file. If you do not already have a customized message, this file will be completely empty. When the file is empty, the default format is sent:
      example enrollment message.png

    4. Anything that you write in the SMSRegister file will be what is sent in all future enrollment texts and emails. To format the message with the appropriate links and information, the %shortcodes% and an example can be found below:

    Shortcode VariableReference
    %Domain%Domain of the user the message will be sent
    %Username%The MFA username of the user the message will be sent
    %Email%E-mail address of the user to whom the message will be sent
    %AuthCode%A unique auth code generated for the user at the time of sending message. This auth code can be used to enroll in the app but is also valid as a One Time Password for logon
    %DownloadUrl%Download URL as seen in the settings tab of admin portal
    %ProvisionUrl%Provisioning URL stem as seen in settings tab of admin portal
    %ProductShortName%RapidIdentity
    %ProductLongName%RapidIdentity Server
    %ProvisionUrl%?id=%Username%&%Domain%Auto-launches the user's app and fills in username and domain automatically

    Note: The shortcode variables are case sensitive.

    Example

    Hello %Username%,

If you don't have the RI mobile app yet, you can click the link below to download it:
%DownloadUrl%

This is your MFA Username: %Domain%\%Username%
This is your Auth Code: %AuthCode%

Once you have the app downloaded, click the Provision URL below to begin your mobile enrollment:
%ProvisionUrl%?id=%Username%&%Domain%

If you have any questions please reach out to example@email.com.


    example enrollment message.png

    *The user is domainless in this example.

    Was this article helpful?
    What's Next