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:

  1. In Admin Portal, select Settings > Templates.
  2. Select Registration Templates.
  3. Select the View link for the template you want to view.

Editing registration messages

To edit registration messages:

  1. In Admin Portal, select Settings > Templates > Registration Templates.
  2. 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.

  3. Make changes to the displayed registration messages.

    Do not add the <head> html tag in the registration template fields.

    Editing your registration template dialog box

  4. 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.
  5. Select Save.

Next steps 

Customizing registration messages

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 

  1. If you want to restrict the templates displayed based on language, select the preferred language from the Language list.
  2. 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:

  1. In the Settings > Registration Templates page, select the template you want to restore.
  2. Select Restore to Factory Default.