MobileIron Cloud Help

App Configuration

App configuration enables you to customize the installation, promotion, and distribution of each app you deploy to your users' devices. The apps can be your own in-house apps, apps from a public store, or MobileIron apps. You have the flexibility to deploy the apps to many different  users and groups with unique names and configurations specifically tailored to each recipient.

 

Licensing for app features

The following features require additional licensing:

  • Silent app install/uninstall: Silver license
  • Per-app configuration: Gold license
  • AppConnect custom configuration: Gold license

 

Configuration steps common to multiple apps

Do these steps first and then proceed with configuration steps for each app you want to deploy.  You can design multiple configurations of the same app and give each configuration a  unique name. Each configuration can have its own distribution and  promotion levels to fit your deployment strategy.

 

Select an app to add to the App catalog:

 

  1. Go to Apps > Apps Catalog and click +Add.  

  2. Use the pull-down menu to select either the App Store, Google Play or your In-House app store and choose an app to add to the catalog.
    Depending on your licensing agreement, you  might also have MobileIron apps available to add to your catalog.

  3. Optionally, edit the Category of the app.

  4. Optionally, add a brief description of the app in the Description field.

  5. Click Next.

  6. Choose a distribution level for this configuration of the app:

      • To everyone - The app is added to all the user compatible devices.

      • To no one - The app is staged for distribution at a later date.

      • Custom Distribution - The app is distributed to only the users or user groups you choose.

  7. Click Next.

Configure  installation options

To select the installation configuration options:

 

  1. Click Install Application configuration settings or click the + icon to add another configuration to view the Configuration Setup page.

  2. Enter a  name for the configuration in the Name field.

  3. Optionally, enter a brief description of the installation configuration in the Description field.

  4. Optionally, select Install on Device. This prompts and requires the app to be installed on the device and allows you to select these options:

      • Silently install on Samsung SAFE devices

      • Silently install on Samsung KNOX workspace and Zebra devices

      • Do not show app in end user App Catalog.

      • Install as a Managed App.
        If already installed, it converts the app and its data to a managed app. Converting already installed apps on supervised devices is done silently. The user will be prompted to allow conversion if the device is unsupervised.

  5. You may encounter additional configuration options, depending on the chosen app. These options may include the ability to add multiple Key and Value pairs. In such cases, click + Add to enter Key and Value pairs.

 

Select  iOS App Management settings

To select iOS App Management settings:

 

  1. Click iOS Managed Apps Application configuration settings or click the + icon  to add another configuration to view the Configuration Setup page.

  2. Enter a  name for  the configuration in the Name field.

  3. Enter a brief description of the configuration in the Description field.

  4. Select to prevent backup to iCloud and iTunes.

  5. Select to remove apps when the device is unenrolled.

 

Select  App Promotion levels

To set the level of promotion for the app:

 

  1. Click Promotion distribution configuration settings or click the + icon to add another configuration to view the  Promotion configuration page.

  2. Enter a  name for  promotion distribution configuration settings in the Name field.

  3. Optionally, enter a brief description of the configuration in the Description field.

  4. Select the level of promotion you want the app to receive, Not Featured, Featured List, or use  Feature Banner. If Not Featured is selected the app will not be listed.

  5. Click + Add Description to enter a brief description of the configuration.

  6. Optionally, change the distribution of the configuration.

  7. Click Done to save the app configuration.

Enter values for an AppConnect Custom configuration

 To enter values for an AppConnect Custom configuration:

 

  1. Click the + icon to open the configuration page.

  2. Click + Add Description to enter a brief description of the configuration.

  3. Click + Add to enter  Key and Value pairs.

  4. Choose a  distribution level for the configuration.

  5. Click Next.

 

Configure the  AppTunnel

Use the  AppTunnel to define traffic rules to allow access services using Sentry:

 

  1. Click the + icon to open the configuration page.

  2. Choose a Sentry Profile from the pull-down menu.

  3. Choose a distribution level for the configuration .

  4. Click Next.

Configure an iOS Managed app

To configure an iOS Managed app:

:

  1. Click the + icon to open the configuration page.

  2. Click + Add Description to enter a brief description of the configuration.

  3. Click + Add to enter  a Key and Value.

  4. Choose a distribution level.

  5. Click Next.

 

Configure a VPN for each app using Per App VPN

  1. Click the + icon to open the configuration page.

  2. Enter a  name for  the VPN  for this app  in the Name field.

  3. Click + Add Description to enter a brief description of the configuration.

  4. Click the  Enable Per-App VPN for this app checkbox and select a Per-App VPN Config from the pull-down menu.

  5. Choose how to Distribute this App Config.

  6. Click Next.

 

Configuring MobileIron  apps

As you configure MobileIron apps, you have the opportunity to name and design unique configurations to assign to different users or groups. Access and use of MobileIron apps and other software  requires a licensing agreement. Please verify that you have the proper licensing to use MobileIron software.

 

Important: Each configuration has a priority indicated by their order in the list displayed for the app. This priority can be changed by dragging and dropping the configuration. The higher on the list the higher the priority.

 

Configure the MobileIron Docs@Work app

 

  1. Go to Apps > Apps Catalog and click +Add.

  2. Select MobileIron Docs@Work to add to the Apps catalog.

  3. Edit the Category if needed.

  4. Optionally enter a brief description of the configuration.

  5. Select a distribution level.

  6. Click Next.

  7. AppConnect Custom Configuration.

    • Click +Add to add Key and Value pairs.

  8. Select a Distribution level.  Click Next.

  9. Create  app configurations using these options:

    1. Click Install Application configuration settings to configure the installation or Click the + icon to add another configuration.

      • Select Install on Device  to prompt the user and require installation.
        This setting uses a silent installation on supervised iOS devices.

      • Select Install as a Managed App.
        If already installed, it converts the app and its data to a managed app. Converting already installed apps on supervised devices is done silently. The user will be prompted to allow conversion if the device is unsupervised.

    2. Click iOS Application Management configuration settings to configure iOS App Settings or click the + icon to add another configuration.

      • Enter a name for the configuration.

      • Optionally add a description for the configuration.

      • Select Prevent backup to iCloud and iTunes.

      • Select Remove app on unenrollment.

    3. Click Promotion distribution configuration settings to configure Promotion settings  or click the + icon to add another promotion configuration.

      • Enter a name for the configuration.

      • Optionally add a description for the configuration.

      • Choose a promotion  level for this configuration.

    4. Docs@Work configuration:

      • Enter a name for the configuration.

      • Optionally, click +Add Description to enter a description of the configuration.

      • Click +Add in the Content Sites section to enter site details:

        • Name

        •  URL

        • Domain

        • Subdomain  

        • Authentication

        • Published

        • Web View

        • Actions

Use the Publish site options pulldown menus to set these site options:

      • Update Mode.

      • Update Interval.

      • Max Auto download size.

      • Max documents per update.

    •  Select the distribution level for this configuration.

 e. Click the + icon to set App Tunnel options.

      • Enter a name for the configuration.

      • Optionally add a description for this configuration.

      • Enter the domain wildcards for the App Tunnel.

      • Choose a distribution level for this configuration.

            f. Click the + icon to add iOS Managed App Configuration settings.

      • Name this configuration.

      •  Enter the key and value pairs for iOS 7+Managed App settings.

      • Choose a distribution level.

            g. Choose whether to enable Per App VPN.

      • Name this configuration.

      • Choose a distribution level.

Configure the MobileIron Web@Work app

  1. Go to Apps > Apps Catalog and click +Add.

  2. Select MobileIron Web@Work to add to the Apps catalog.

  3. Edit the Category if needed.

  4. Enter a brief description of the configuration if needed.

  5. Click Next.

  6. Select a distribution level.

  7. Click Next.

  8. Create app configurations using these options:

    1. Click Install Application configuration settings to configure the installation or Click the + icon to add another configuration.

      • Select Install on Device  to prompt the user and require installation.
        This setting uses a silent installation on supervised iOS devices.

      • Select Install as a Managed App.
        If already installed, it converts the app and its data to a managed app. Converting already installed apps on supervised devices is done silently. The user will be prompted to allow conversion if the device is unsupervised.

    2. Click iOS Application Management configuration settings to configure iOS App Settings or click the + icon to add another configuration.

      • Enter a name for the configuration.

      • Optionally add a description for the configuration.

      • Select Prevent backup to iCloud and iTunes.

      • Select Remove app on unenrollment.

    3. Click Promotion distribution configuration settings to configure Promotion settings  or click the + icon to add another promotion configuration.

      • Enter a name for the configuration.

      • Optionally add a description for the configuration.

      • Choose a promotion  level for this configuration.

    4. Web@Work configuration.

      • Add Bookmarks.

      • AppConnect Custom Configuration.

        • Click +Add to enter Key and Value pairs.

    5. Click the + icon to set App Tunnel options.

      • Enter a name for the configuration.

      • Optionally add a description for this configuration.

      • Enter the domain wildcards for the App Tunnel.

      • Choose a distribution level for this configuration.

    6. Click the + icon to add iOS Managed App Configuration settings.

      • Name this configuration.

      •  Enter the key and value pairs for iOS 7+Managed App settings.

      • Choose a distribution level.

    7. Choose whether to enable Per App VPN.

      • Name this configuration.

      • Choose a distribution level.

Configure the MobileIron Tunnel app

  1. Go to Apps > Apps Catalog and click +Add.

  2. Select MobileIron Tunnel to add to the Apps catalog.

  3. Edit the Category if needed.

  4. Click +Add Description to add a brief description of the configuration .

  5. Click Next.

  6. Select a distribution level.

  7. Click Next.

  8. Create  app configurations using these options:

    1. Click Install Application configuration settings to configure the installation or click the + icon to add another configuration.

      • Select Install on Device  to prompt the user and require installation.
        This setting uses a silent installation on supervised iOS devices.

      • Select Install as a Managed App.
        If already installed, it converts the app and its data to a managed app. Converting already installed apps on supervised devices is done silently. The user will be prompted to allow conversion if the device is unsupervised.

    2. Click iOS Application Management configuration settings to configure iOS App Settings or click the + icon to add another configuration.

      • Enter a name for the configuration.

      • Optionally add a description for the configuration.

      • Select Prevent backup to iCloud and iTunes.

      • Select Remove app on unenrollment.

    3. Select a level of distribution.

    4. Click the + icon to add AppConnect Custom Configuration settings.

      • Name this configuration.

      •  Enter the key and value pairs for AppConnect Custom Configuration settings.

      • Choose a distribution level.

    5. AppConnection Custom configuration.

      • Click +Add to enter Key and Value pairs.

    6. Choose a Sentry profile for the App Tunnel.

    7. Enter the domain wildcards for the tunnel traffic.  Multiple wildcards will be evaluated in the order in which they are listed.

    8. Click the + icon to add iOS Managed App Configuration settings.

      • Name this configuration.

      •  Enter the key and value pairs for iOS 7+Managed App settings.

      • Choose a distribution level.

   

Configure the MobileIron Email+ for iOS app

  1. Go to Apps > Apps Catalog and click +Add.

  2. Select MobileIron Email+ to add the app to the Apps catalog.

  3. Edit the Category if needed.

  4. Enter a description of the app if needed.

  5. Click Next.

  6. Select a distribution level.

  7. Click Next.

  8. Create app configurations using these options:

    1. Click Install Application configuration settings to configure the installation or Click the + icon to add another configuration.

      • Select Install on Device  to prompt the user and require installation.
        This setting uses a silent installation on supervised iOS devices.

      • Select Install as a Managed App.
        If already installed, it converts the app and its data to a managed app. Converting already installed apps on supervised devices is done silently. The user will be prompted to allow conversion if the device is unsupervised.

    2. Click iOS Application Management configuration settings to configure iOS App Settings or click the + icon to add another configuration.

      • Enter a name for the configuration.

      • Enter a description for the configuration.

      • Select Prevent backup to iCloud and iTunes.

      • Select Remove app on unenrollment.

    3. Click Promotion distribution configuration settings to configure Promotion settings  or click the + icon to add another promotion configuration.

      • Enter a name for the configuration.

      • Optionally add a description for the configuration.

      • Choose a promotion  level for this configuration.

    4. Click the + icon to add an Email+ for iOS Configuration.

      • Enter a name for the configuration.

      • Optionally add a description for the configuration.

    5. Enter the email address of the device user.

    6. Email password - Enter the user’s password for the ActiveSync server.

    7. Exchange Host - Enter the fully qualified domain name of the ActiveSync server.

    8. Exchange Username Check to require SSL.

    9. Minimum Characters for Global Address List (GAL) Search.

    10. Choose a certificate to use for Email+ App Identity Certificate and select from these options:

      • Trust All Certificates.

      • Prompt for Password Before Connecting to Server.

      • IBM Lotus Notes Traveler.

      • Allow Safari Browser.

      •  Allow Detailed Notifications.

      • Show Pictures by Default.

      • Allow Exporting Contacts.

      • Allow Logging.

      • Default Email Signature.

      • Allow Send Feedback.

      • Set AppConnect Custom Configuration settings.

      • Click +Add to enter Key and Value pairs.

      • Select a distribution level for this configuration.

   

     k.   Click the + icon to add App Tunnel options.

      • Enter a name for the configuration.

      • Optionally add a description for this configuration.

      • Enter the domain wildcards for the App Tunnel.

      • Choose a distribution level for this configuration.

     l. Click the + icon to add iOS Managed App Configuration settings.

      • Name this configuration.

      • Enter the key and value pairs for iOS 7+ Managed App settings.

      • Choose a distribution level.

     m.  Choose whether to enable Per App VPN.

  • Name this configuration.

  • Choose a distribution level.

Configure the MobileIron Email+ for Android app

The license you purchased determines whether or not you have access to the Email+ for Android app. The Email+ for Android app will already be added to your App catalog.

 

To configure Email+ for Android:

 

  1. Click the  Email+ link in the catalog to view the Details tab.

  2. Use the Actions pulldown menu button to  add a new version of the app or delete the app from your catalog.

  3. Click  Edit to begin making changes to the details.

    • Edit the Category if needed.

    • Enter a description if needed.

    • Add screenshots if needed.

  4. Click Save.

  5. Click the Distribution tab and click Edit to begin making changes to the distribution level.

  6. Click Save.

  7. Click the App Configurations tab to view a summary of the current configuration.

  8. Enter a description of the app if needed.

  9. Click Install on Device in the left navigation pane then click Install Application configuration settings.

    • Click Edit to begin making changes to the installation configuration settings.

    • Enter a name for the configuration.

    • Enter a description for the configuration.

    • Select Install on Device  to prompt the user and require installation.

    • Select Install as a Managed App.
      If already installed, it converts the app and its data to a managed app.  Converting already installed apps on supervised devices is done silently. The user will be prompted to allow conversion if the device is unsupervised.

    • Click Update to save your changes.

  10. Click Promotion in the left navigation pane then click Promotion distribution configuration settings to change the promotion level.

    • Click Edit to begin making changes to the promotion level settings.

    • Enter a name for the configuration.

    • Enter a description for the configuration.

    • Select a promotion level.

    • Click Update to save your changes.

  11. Click the Reviews tab to view information on reviews.
    Export the review data to a spreadsheet if needed.

Configure the  MobileIron Dataview app

  1. Go to Apps > Apps Catalog and click +Add.

  2. Select MobileIron Dataview to add to the Apps catalog.

  3. Edit the Category if needed.

  4. Enter a description of the app if needed.

  5. Click Next.

  6. Select a distribution level.

  7. Click Next.

  8. Create app configurations using these options:

      1. Click Install Application configuration settings to configure the installation or Click the + icon to add another configuration.

        • Select Install on Device  to prompt the user and require installation.
          This setting uses a silent installation on supervised iOS devices.

        • Select Install as a Managed App.
          If already installed, it converts the app and its data to a managed app. Converting already installed apps on supervised devices is done silently. The user will be prompted to allow conversion if the device is unsupervised.

      2. Click iOS Application Management configuration settings to configure iOS App Settings or click the + icon to add another configuration.

        • Enter a name for the configuration.

        • Optionally add a description for the configuration.

        • Select Prevent backup to iCloud and iTunes.

        • Select Remove app on unenrollment.

      3. Click Promotion distribution configuration settings to configure Promotion settings  or click the + icon to add another promotion configuration.

        • Enter a name for the configuration.

        • Optionally add a description for the configuration.

        • Choose a promotion level for this configuration.

      4. Click the + icon to set AppConnect Custom Configuration settings.

        • Click +Add to enter Key and Value pairs.

      5. Click the + icon to set App Tunnel options.

        • Enter a name for the configuration.

        • Optionally add a description for this configuration.

        • Enter the domain wildcards for the App Tunnel.

        • Choose a distribution level for this configuration.

      6. Click the + icon to set more Dataview Configuration options.

        • Enter a Billing date. This is the day of month billing cycle starts.

        • Choose how you want to cap data usage.

        • Set a regular usage monthly cap or set as unlimited data plan and just use roaming cap and alerts.

        • Set a Daily data usage cap and set an alert.

        • Set a Roaming usage cap and set an alert.

      7. Click the + icon to add iOS Managed App Configuration settings.

        • Name this configuration.

        •  Enter the key and value pairs for iOS 7+Managed App settings.

        • Choose a distribution level.

      8. Choose whether to enable Per App VPN.

        • Name this configuration.

        • Choose a distribution level.

 

Using iOS Managed App Configuration


An application might have some configuration parameters implemented or restricted by the developer. For applications with such restrictions your configuration options might be limited.

 

  1. Go to Apps > App Catalog.

  2. Select a configuration.

  3. Click the App Configurations tab.

  4. Click iOS Managed App Configuration  or click the + button.
    In the iOS Managed App Configuration there are some default configuration settings in  place.

  5. Click Add to add another configuration, if needed.

  6. Optionally, click the name of the configuration to edit the current configuration.
    The  configuration setup details and options are displayed.

  7. Click Edit.
    The configuration options present may vary depending the app developer chooses to provide initially.  You still have the option to enter key value pairs.

  8. Click Update to save your entries.


Choosing Windows 10 apps for your in-house catalog

Choose the apps to add to your in-house app catalog. Only in-house apps are supported for Windows10. Windows 10 enforces compliance directly on the device based on the apps you choose to allow or disallow.

 

Note: The Windows 10 check-in interval is once every 60 minutes by default. You may want to perform a  forced device check-in to get an update of the device and app status.

 

These actions are supported:

 

  • Uploading new apps

  • Silent installation

  • Adding a new version of the app

  • Deleting an app

 

These formats are supported:

  • APPX

  • APPXBUNDLE

  • MSI wrapped Win32 -  pre-bundled Win32 app

 

To configure Windows 10 apps:

 

  1. Click Devices on the main navigation bar.

  2.  Select a Windows 10 device that you have enrolled in  MobileIron Cloud.

  3. Click Apps > App Catalog.

  4. Select an app.

  5. Use the Actions pulldown menu to  add  the app or delete the app from your catalog.
    Optionally add a new version of the app.

    • Click the Actions pulldown menu.

    • Select Add New Version.

    • Go to the catalog and select a new version of the app.

    • Click Update and Save to view the App information screen.

  6. Use the Version pulldown menu to choose which version to use.

  7. Click  Edit to begin making changes to the details.

    • Edit the Category if needed.

    • Enter a Description if needed.

    • Add screenshots if needed.

  8. Click Save.

  9. Click the Distribution tab and click Edit to begin making changes to the distribution level.

  10. Click Save.

  11. Click the App Configurations tab to view a summary of the current configuration.

  12. Enter a description of the app if needed.

  13. Click Install on Device in the App Configurations summary page.
    Silent installation is the default and cannot be changed.

  14. Click Promotion in the left navigation pane then click Promotion distribution configuration settings to change the promotion level.

    • Click Edit to make changes to the promotion level settings.

    • Enter a name for the configuration.

    • Enter a description for the configuration.

    • Select a promotion level.

    • Click Update to save your changes.

  15. Click the Reviews tab to view information on reviews.
    Export the review data to a spreadsheet if needed.

 

Editing  Windows 10 app configuration settings

To edit an app configuration:

 

  1. Click Policies > Configuration.

  2. Click +Add.

  3. Select Windows App Control to view the Create Windows App Control Configuration screen.

  4. Enter a Name and Description for the configuration.

  5. Define the app type as:

    • Allowed (Whitelisted) - Only these apps are allowed. These apps are installed silently if not already present on the device.

    • Disallowed (Blacklisted) - If present on the device,these apps will be blocked if launched.

  6. Specify the Rule definitions for the App Type and App Identifier.

  7. Click Lookup Apps to view the Search Windows 10 Apps screen.

  8. Enter the name of the app to search the Windows Store.

  9. Select the app from the choices displayed to add it to the App Identifier.

  10. Optionally use the App Type pulldown menu to set a path define in the App Identifier to  allow or disallow apps using the specified path or block all apps installed in  that path.
    App Type Publisher/PFN Equals applies to Windows 10 Mobile and Windows 10 Desktop supports PFN.  EXE/Win32 Equals applies to Windows desktop only.

  11. Click Next.

  12. Select a distribution level.

    • All Devices.

    • No Devices.

    • Custom - to enter the users or groups to receive the app.

  13. Click Done.

  14. You can edit the Rule definitions  to select an App Type and specify an App Identifier.

    • Click the Actions pulldown menu.

    • Select Add New Version.

    • Select a new version of the app.

    • Click Update and Save to view the App information screen.

 

Using Apps@Work

 

Apps@Work enables use of Windows public and in-house apps on Windows 10 devices in MobileIron Cloud  Apps@Work is installed silently on supported Windows 10  mobile devices.

 

To configure an app for Apps@Work:

 

  1. Select a Windows app.

  2. Click the App Configuration tab.

  3. Click Install on Device.
    Windows In-house app configuration  can be set to the silent install flag or install using Apps@Work. Public apps cannot be set to silent install.

  4. Optionally, choose to display or hide apps  in Apps@work catalog.
    This option applies to in-house apps only.

  5. Click the Promotion tab.Apps@Work currently does not support the  banner promotion so the available options are Featured and Not Featured.
    Note: Only the Promotion option is displayed for public apps.

 

To install an app using Apps@Work:

 

  1. Click the Apps@Work app.
    Your administrator email address and server URL are pre-filled in the Apps@Work login dialog.

  2. Enter your password and click Sign In  to display the apps page.
    There are three tabs:

    • featured apps

    • in-house apps

    • store apps

  3. Select the in-house apps tab.

  4. Select an app to install.
    A message is displayed stating that a request has been sent to the server to install the app. Click Close.

  5. Optionally, select an app from the store apps tab to display the Windows app store.

  6. If prompted, enter your username and password for the Windows app store.

  7. Click Update and Save to view the App information screen.