Main steps for Configuring Email+ for iOS (Core)

This section explains the steps to configure Email+ for iOS Core.

You do not configure a separate Exchange setting for the device as you do for other email apps. The AppConnect app configuration provides the necessary information.

Adding Email+ for iOS to Core as a recommended app

Device users can download Email+ for iOS directly from the Apple App Store. You can also distribute Email+ for iOS as a recommended app through [email protected]

Procedure 

  1. In the Admin Portal, go to Apps > App Catalog.
  2. From the Quick Import drop-down list, select iOS.
  3. Enter Email+ in the Application Name text box.
  4. Click Search.
  5. Select the app from the list that is displayed.
  6. For Email+, click Import.
  7. Click OK on the pop-up message, and close the Quick Import dialog.
  8. Email+ is now listed in the App Catalog. Information included in the app, such as the name, is automatically configured. All other settings, such as the App Category and whether the app is a free app, are set to default settings.

    To view and edit the settings for the app, click on the app name in the App Catalog.

  9. Select the app to apply the app to a label:
    1. Click Actions > Apply to Label.
    2. Select the label that represents the iOS devices for which you want the selected app to be displayed.
    3. Click Apply.

Next steps 

Continue to Enabling third-party AppConnect apps.

  • For more information on adding iOS apps to the app distribution library, see “Working with apps for iOS devices” in the [email protected] Guide. See also, “Setting per app VPN priority” in the Core [email protected] Guide.
  • For information on creating a VPN setting, see the Tunnel for iOS Guide.

Enabling third-party AppConnect apps

Email+ for iOS requires you to enable the licensing option for third-party and in-house AppConnect apps.

Procedure 

  1. In the Admin Portal, go to Settings > System Settings.
  2. Click Additional Products > Licensed Products.
  3. Select AppConnect For Third-party And In-house Apps.
  4. Click Save.

Next steps 

Continue to Configuring the AppConnect global policy.

Configuring the AppConnect global policy

Because Email+ for iOS is an AppConnect app, AppConnect must be enabled in the AppConnect global policy if it has not yet been configured. The AppConnect global policy specifies AppConnect app settings such as AppConnect passcode and data loss prevention requirements. You can use the Default AppConnect Global Policy.

Most fields are set to suitable default values.

Procedure 

  1. In the Admin Portal, go to Policies & Configs > Policies.
  2. Select the Default AppConnect Global Policy and click Edit.
  3. Enable AppConnect in the AppConnect global policy

  4. For AppConnect, select Enabled.
  5. (Optional) Scroll down to the Data Loss Prevention Policies section.
  6. (Optional) For Apps without an AppConnect container policy, select Authorize.

    If you do not select this option, then you must create an AppConnect container policy for Email+.

  7. (Optional) If you select Authorize for Apps without an AppConnect container policy, also select the data loss preventions options you want to enable.
  8. Click Save.

    If you create a new AppConnect Global Policy, you must apply it to the appropriate labels. You do not need to apply the Default AppConnect Global Policy to a label.

Procedure: Applying to a label

  1. Select the AppConnect global policy.
  2. Click More Actions > Apply To Label.
  3. Select the appropriate labels to which you want to apply the policy.
  4. Click Apply.

Next steps 

Continue on Configuring the AppConnect container policy.

For more information about the AppConnect Global policy, see the “Configuring the AppConnect global policy” section in the AppConnect Guide for Core and Tunnel for iOS Guide for detailed description of each field.

Configuring the AppConnect container policy

This task is only required:

  • If you did not select Authorize for Apps without an AppConnect container policy, in the AppConnect Global Policy.
  • If you want to configure a different set of data loss prevention policies for Email+.

The AppConnect container policy authorizes an AppConnect app and specifies the data loss prevention settings. The container policy overrides the corresponding settings in the AppConnect Global Policy.

Make sure to apply only one AppConnect container policy for Email+ for iOS.

Procedure 

  1. In the Admin Portal, select Policy & Configs > Configurations.
  2. Select Add New > AppConnect > Container Policy.
  3. Enter a name for the policy.
  4. Enter a description for the policy.
  5. In the Application field, enter the bundle ID for the app:
    com.mobileiron.ios.emailplus
  6. Configure the iOS data loss prevention policies according to your requirements.
  7. Click Save.
  8. Select the container policy.
  9. Select More Actions > Apply To Label.
  10. Select the labels to which you want to apply the policy.
  11. Click Apply.

Next steps 

Continue on to Creating an AppConnect app configuration for Email+.

Creating an AppConnect app configuration for Email+

Email+ for iOS requires an AppConnect app configuration in Core. The AppConnect app configuration provides the type of information that is usually configured in an Exchange setting, such as the fully qualified domain name and user ID for the ActiveSync server, and certificate information. As such, Email+ for iOS does not require an Exchange setting.

The AppConnect app configuration for Email+ for iOS also includes the bundle ID for the app and key-value pairs used to configure app settings.

Make sure to apply only one AppConnect app configuration for Email+ for iOS to each device.

If you make a mistake in the configuration, the app shows a message to the device user indicating an error in configuration.

Procedure 

  1. In the Core Admin Portal, go to Policy & Configs > Configurations.
  2. Click Add New > AppConnect > Configuration to create a new AppConnect configuration.
  3. In the Name field, enter brief text that identifies this AppConnect app configuration.
  4. Example: Email+ for iOS
  5. In the Description field, enter additional text that clarifies the purpose of this AppConnect app configuration.
  6. In the Application field, enter the bundle ID for the app: com.mobileiron.ios.emailplus
  7. In the App-specific Configurations section enter the following required key-value pairs:

    Key

    Value

    email_exchange_host

    Fully qualified domain name of your ActiveSync server or Sentry.

    email_ssl_required

    Enter true to secure communication using https to the server that you specified in email_exchange_host. Otherwise, enter false.

    Typically, set this field to true unless you are working in a test environment.

  8. Click Save.
  9. When you save an app configuration with the bundle ID com.mobileiron.ios.emailplus, Core automatically applies the following key-value pairs to the app configuration:
    1. email_exchange_username with value $USERID$
    2. email_device_id with value $DEVICE_UUID_NO_DASHES$
    3. email_address with value $EMAIL$

  10. Select the new AppConnect app configuration.
  11. Click More Actions > Apply To Label.
  12. Select the labels to which you want to apply the AppConnect app configuration.
  13. Click Apply.

ActiveSync server synchronization due to app configuration changes

Email+ for iOS synchronizes all emails, contacts, calendar, and task items with the ActiveSync server when the device user first launches Email+ for iOS. It also does a full synchronization if you change the values of the following keys in the app configuration:

  • email_address
  • email_exchange_host
  • email_exchange_username

After you have changed one of these values, the full synchronization occurs the next time Email+ for iOS receives the updated app configuration. Email+ for iOS receives the update the next time it runs after the AppConnect app checkin interval has expired.

The first Email+ for iOS synchronization with the ActiveSync server may require considerable time and bandwidth, as does changing the values of the keys mentioned here.

Customize Email+ app behavior with key-value pairs

Administrators can customize Email+ app behavior by configuring key-value pairs in the App-specific Configurations section of AppConnect app configuration for Email+ for iOS. These key-value pairs define app behavior such as providing detailed notifications to device users and export contacts from Email+. See Additional configurations using key-value pairs for the complete list of custom key-value pairs.

Configuring email attachment control with Standalone Sentry

With Email+ for iOS, you can configure Standalone Sentry to deliver emails with attachments to the secure app. The attachments can then only be shared with other apps according to your data loss prevention policies.

Therefore, when using secure email apps, you typically configure Standalone Sentry to use the email attachment control setting called Open With Secure Email App.

Procedure 

  1. Go to Settings > Sentry in the Core Admin Portal.
  2. Select the Standalone Sentry that handles email for the devices.
  3. Click the edit icon.
  4. In the section Attachment Control Configuration, select Enable Attachment Control.
  5. For iOS And Android Using Secure Email Apps, select Open With Secure Email App.
  6. Click Save.
  • For more information about email attachment control, see the Sentry Guide for Core.

Informing users to install Email+ for iOS

You can inform device users by sending an APNS (Apple Push Notification Service) notification that directs device users to the new or updated Email+ for iOS app in [email protected] Or, you can send an installation request directly to all devices in the labels applied to Email+ for iOS, bypassing [email protected] entirely.

As with badge notifications, updates are determined by comparing the version number of the installed app with that of the update.

The notification feature applies only to apps designated as Featured apps.

Procedure

  1. In the Admin Portal, go to Apps > App Distribution Library.
  2. Select iOS from the Select Platform list.
  3. Select the featured app you want to work with.
  4. Click Message.Send app installation request.

  5. Use the following guidelines to select the app installation option:

    Item

    Description

    Send request for new installations

    Prompts the device user to install the app if it is not already installed.

    Send request for updates

    Prompts the device user to update the app if it is not already updated.

    Send request for both new installations and updates

    Prompts the device user to install or update the app.

    Use iOS managed app install/update action

    Ignore the [email protected] display and immediately install or update the app.

  6. To check the content of the message prior to sending:
    1. a. Select the Push Notification template from the list.
    2. b. Click View Messages.
    3. Click Send.
  7. The message is sent only for apps configured as featured apps in the app distribution library.