Customizing registration messages
The registration process is a critical part of deployment. You can customize the registration messages involved in this process by editing the registration templates. Registration templates enable you to specify content and basic formatting using HTML markup.
Ivanti EPMM sends multiple messages related to registration:
- Registration SMS
- Registration email and reminder email
- Post registration email
These messages may vary by:
- Platform
- Language
In addition, messages may vary by device type:
- Phones
- PDAs
To accommodate this range of messages:
- Separate registration templates are provided for each language/platform combination.
- Each registration template contains separate text for each registration message type.
- Each registration template contains separate text for phones and PDAs.
- For when Ivanti EPMM discovers device users that have not downloaded the MDM profile, reminder email scheduling capabilities are provided
Viewing registration templates
To view Ivanti EPMM message templates:
- In Admin Portal, select Settings > Templates.
- Select Registration Templates.
- Select the View link for the template you want to view.
Editing registration messages
To edit registration messages:
- In Admin Portal, select Settings > Templates > Registration Templates.
- Select the template you want to edit and select the Edit pencil icon. Registration messages are displayed with the HTML markup that provides the basic formatting for the content.
- Make changes to the displayed registration messages.
Do not add the <head> html tag in the registration template fields.
- Select the Variables Supported link in the right corner of the dialog box to display a guide to the supported variables. See Using variables in registration messages for additional details.
- Select Save.
Next steps
Using variables in registration messages
Each field in a registration template has a set of supported variables, most of which are required. Supported and required variables also differ by OS. Use the following variables to guide your customization. You can also select the Variables Supported link to display this information. All variables except $BRANDING_COMPANY_NAME$ are also required in the specified field.
Registration message variables
The following table gives the of variables used in types of registration messages.
Table 12. Variables used in different types of registration messages
Type | Supported Variables |
|---|---|
Registration SMS, Phone | $REG_LINK$ |
Registration Email | |
Registration Email, Subject (Phone) | $ENT_NAME$, $USER, $PHONE$ |
Registration Email, Subject (PDA) | $ENT_NAME$, $USER, $PHONE$ |
Registration Email, Body(Phone) | $ENT_NAME$, $BRAND_COMPANY_NAME$, $PHONE$, $INAPP_REG_STEPS$, $REG_LINK$ |
Registration Email, Body(PDA) | $ENT_NAME$, $BRAND_COMPANY_NAME$, $REG_LINK$, $INAPP_REG_STEPS$ |
Registration Email, Reminder Subject (Phone) | $ENT_NAME$, $USER$, $PHONE$ |
Registration Email, Reminder Subject (PDA) | $ENT_NAME$, $USER$, $PHONE$ |
Registration Email, Reminder Body(Phone) | $ENT_NAME$, $BRAND_COMPANY_NAME$, $PHONE$, $INAPP_REG_STEPS$, $REG_LINK$ |
Registration Email, Reminder Body(PDA) | $ENT_NAME$, $BRAND_COMPANY_NAME$, $REG_LINK$, $INAPP_REG_STEPS$ |
Values for $INAPP_REG_STEPS$ | |
Server | $SERVER_URL$ |
Username | $USER_ID$ |
PIN | $PASSCODE$, $PASSCODE_TTL$ |
Post-Registration Email | |
Post Registration Email, Subject (Phone) | $BRAND_COMPANY_NAME$, $USER$, $PHONE$ |
Post Registration Email, Subject (PDA) | $BRAND_COMPANY_NAME$, $USER$, $PHONE$ |
Post Registration Email, Body (Phones) | $PHONES$, $BRAND_COMPANY_NAME$ |
Variables used inside registration messages
The following table gives the description of variables used inside registration messages.
Table 13. Description of Variables used inside Registration Messages
Variable | Description |
|---|---|
$BRAND_COMPANY_NAME$ | An internal variable. |
$ENT_NAME$ | The name of the organization using Ivanti EPMM to secure the device. See the field Enterprise Name in Settings > System Settings > General > Enterprise. |
$INAPP_REG_STEPS$ | Combines $SERVER_URL$, the user’s LDAP password, $PASSCODE$, and $USER_ID$. |
$PASSCODE$ | The registration PIN generated for the device by Ivanti EPMM. |
$PASSCODE_TTL$ | The number of hours that the registration PIN remains valid. See the field Passcode Expiry in Settings > System Settings > Users & Devices > Registration. |
$PHONE$ | The phone number associated with the device. |
$REG_LINK$ | The URL that users access to complete the registration process (i.e., https://server name:port/a/ for Android). |
$SERVER_URL$ | The Ivanti EPMM server address used for registration. |
$USER$ | The name of the user associated with the device, as displayed in Ivanti EPMM. |
$USER_ID$ | The user ID for the user associated with the device, as defined in the user account on Ivanti EPMM. |
Filtering registration messages
In the Registration Templates page, you can filter registration messages by:
- Language
- Platform
Procedure
- If you want to restrict the templates displayed based on language, select the preferred language from the Language list.
- If you want to restrict the templates displayed based on device platform, select the preferred platform from the Platform list.
Restoring registration messages to default content
To restore a registration message to the default content provided by Ivanti, Inc:
- In the Settings > Registration Templates page, select the template you want to restore.
- Select Restore to Factory Default.