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.


Note: When you change the values for the app configuration of an app in the app catalog or in the managed app configuration profile, one or two device check-ins are necessary for the device to receive the new configuration values.

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.

Configuring  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 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.

Selecting  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.

Selecting  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.

Configuring AppTunnel traffic rules

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


  1. Click Apps.

  1. Click App Catalog.

  2. Click the app for which to create an AppTunnel configuration.

  1. Click App Configurations.

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



  1. Provide a helpful name for the configuration.

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

  3. Enter the domain wildcards for the traffic that should be tunneled and the service to which the traffic should be sent. Multiple wildcards are evaluated in the order in which they appear. Note that, optionally, you can specify a port number in the fields to the far right, for example, the fields that reflect 23 and 26 in the illustration above. You can also drag the domain wildcard fields up or down.

  4. Choose a distribution level for the configuration.

  5. Click Save.

Configuring 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.


Configuring 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.

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


  • 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.