Skip to main content
Matrix42 Self-Service Help Center

Application Guide Part III: Add iOS Application

Add iOS Application

Due to a split of iPhone, iPad and iPod devices in Silverback, it is required to configure your applications for each device type separately., but the process for all is  the same. 

  • Navigate to App Portal
  • Click iPhone, iPad or iPod
  • Click New Application

From here Administrators have the ability to choose the application type and configure the corresponding details:

Add Enterprise App

Setting Configuration Description
Name e.g. Imagoverum Travel The display name of the application being added.
Description e.g. Imagoverum Travel will provide you information about your upcoming travels and helps to you create your travel expense.   The description of the application to display. Will be displayed in App Portal in Silverback and on end users App Portal (Enterprise and Market). 
URL Scheme *deprecated Has been used prior iOS7
iOS 7+ App Config Edit Shows the iOS 7 App Config Prompt
IPA File Choose File Upload your IPA File
PLIST File Choose File Upload your mandatory corresponding PLIST file.
Icon Choose File

The icon to display in the app portal. It must meet the following specifications:

  • Dimensions: 175x175
  • Format: PNG

If no icon is specified, a default, blank icon will be used.

Visible in App Portal Enabled or Disabled Makes the App Visible to users in the Silverback App Portal.
iOS App Management
Automatically push to managed devices Enabled or Disabled Prompts for the app installation on the device when enrolled into Silverback, or when upgrades are made.
Remove App when MDM Profile is removed Enabled or Disabled Removes the App from the device when MDM Profile is removed from Silverback. (Same as deleting from Silverback Console)
Prevent Backup of App Data Enabled or Disabled Prevents iTunes from backing up any information from this client to a computer when tethered
Take management if the app is already installed Enabled or Disabled

If your company uses an application and want to manage this, but the user already has this installed before they enrolled the device you can convert this to a managed application. For a supervised device, this process is totally silent, and if the application is set to automatically push it will happen as soon as Silverback detects the app. For non-supervised devices, the user will be prompted if they want the server to take management. They can confirm or deny this.

To take management manually, open the device info page and where possible, the action button will be Manage.

  • Click Save

Add App Store Application

To add an App Store Application perform the following steps: 

  • Change the Type to App Store 
  • Search for the application in Google (e.g. Matrix42 Secure Container iTunes) 
  • Open the shown link to iTunes
  • Ensure you change the Country Code at the end of the URL to be your native country code. For example: http://itunes.apple.com/us/ or http://itunes.apple.com/de/
  • Copy the link from the browser into the Clipboard
  • Paste the link in the URL field and type populate
  • All recommended fields were filled automatically. 
Settings Configuration Description
URL e.g. https://itunes.apple.com/us/app/matr...437368721?mt=8 The URL of the App in iTunes 
Bundle ID e.g. com.syncdog.matrix42.securecontainer The Unique Bundle ID of the App
Version e.g. 45 Version of the iOS Application
Name e.g. Matrix42 Secure Container The display name of the application being uploaded.
Description e.g. A containerized workspace provides a secure data platform that protects your data between your enterprise’s backend.

The description of the application to display.

The App Description returned may be longer than the Silverback Maximum (500 Characters). Please be sure to make any adjustments necessary to ensure that it is still human-readable.

URL Scheme *deprecated Has been used prior iOS7
iOS 7+ App Config Edit Shows the iOS 7 App Config Prompt.
Icon Choose File

The icon to display in the app portal. It must meet the following specifications:

  • Dimensions: 144x144
  • Format: PNG

If no icon is specified, a default, blank icon will be used.

Visible in App Portal Enabled or Disabled Makes the App Visible to users in the Silverback App Portal.
iOS App Management
This Application is free Enabled or Disabled  
Automatically push to managed devices Enabled or Disabled Prompts for the app installation on the device when enrolled into Silverback, or when upgrades are made.
Remove App when MDM Profile is removed Enabled or Disabled Removes the App from the device when MDM Profile is removed from Silverback. (Same as deleting from Silverback Console)
Prevent Backup of App Data Enabled or Disabled Prevents iTunes from backing up any information from this client to a computer when tethered
Take management if the app is already installed Enabled or Disabled

If your company uses an application and want to manage this, but the user already has this installed before they enrolled the device you can convert this to a managed application. For a supervised device, this process is totally silent, and if the application is set to automatically push it will happen as soon as Silverback detects the app. For non-supervised devices, the user will be prompted if they want the server to take management. They can confirm or deny this.

To take management manually, open the device info page and where possible, the action button will be Manage.

  • Click Save

PLIST File 

The information property list is a file named Info.plist that is included with every iPhone application project. It is a property list whose key-value pairs specify essential runtime-configuration information for the application.  In general the application developer needs to provide the *.plist file to Administrator.

Use the following text template below to create your individual PLIST file for your Enterprise app. You need to change the following XML tags for your Enterprise app:

  • <key>url</key>: Replace this value with the external Silverback server URL. Make sure you keep the ‘/epic’ at the end of the value
  • <key>bundle-identifier</key>: You will get the bundle ID from your developer or by inspecting the info.plist file within the IPA your developer provides.
  • <key>bundle-version</key>: You will get the version number from your developer.
  • <key>title</key>: This is a descriptive text for the name of the app that appears on the iOS device once the app is deployed.

Please save this file as a pure text file and upload it into the applicable App Portal entry.

Download the Example.plist file. 

If the app get frequently updated on the iOS device you need to recheck the exact version number, apply it to the PLIST file, and upload it again in the App Portal. Once the app is deployed on the device you can easily cross check by checking the app list in the Silverback console. The correct version number – that should be in the PLIST file – is the ‘short version’ or ‘version’ number in the device details.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>items</key>
    <array>
        <dict>
            <key>assets</key>
            <array>
                <dict>
                    <key>kind</key>
                    <string>software-package</string>
                    <key>url</key>
                    <string>https://mdm.imagoverum.com/epic</string>
                </dict>
            </array>
            <key>metadata</key>
            <dict>
                <key>bundle-identifier</key>
                <string>com.syncdog.matrix42.securecontainer</string>
                <key>bundle-version</key>
                <string>2.3.0</string>
                <key>kind</key>
                <string>software</string>
                <key>title</key>
                <string>Matrix42 Secure Container</string>
            </dict>
        </dict>
    </array>
</dict>
</plist>

iOS 7+ App Config

With clicking on Edit a new windows will open which gives the ability to perform configurations for your application.  Here you can enable the Collect Feedback function or Allow Apps to Enter the Single App Mode or create a unique XML Configuration. 

Collect Feedback

By enabling the “Collect Feedback” option, Silverback will request Managed Application Feedback from devices. This information will be visible in the Device Information window for a particular device

Single App Mode

For devices running iOS 7 and above, it is possible to configure some advanced options for applications. It is possible for administrators to define a list of applications that are allowed to enter Single App Mode on the device.  By checking the “Allow App to Enter Single App Mode” checkbox, Silverback will allow this application to enter Single App Mode autonomously. This feature needs to be programmed into the selected application.

App Configuration XML

By populating the “App Configuration XML” text area, you can define information that Silverback will push the application silently. Data should be defined in XML Key-Value pairs. Administrators can also elect whether this information should be sent with the Install command, or sent afterwards by changing the “Push on install” checkbox.

Applications will be able to access this data from the keychain if they require it. System variables are accepted, so information can be dynamic per user.

In Tags you have the ability to overwrite the general XML Config with a Tag based one. 

Example M42Mobile

<key>UDID</key>
<string>{DeviceUDID}</string>
<key>EpicUrl</key>
<string>https://mdm.imagoverum.com/epic</string>
<key>Username</key>
<string>{UserName}</string>
<key>Passw0rd</key>
<string>{UserPassword}</string>
<key>Domain</key>
<string>imagoverum</string>
<key>ServerURL</key>
<string>https://service.imagoverum.com</string>

Example SAP

<key>com.sap.mobile.emr.isTouchIdAllowed</key>
<true/>
<key>com.sap.mobile.emr.isOnDeviceImagesAllowed</key>
<false/>
<key>com.sap.mobile.emr.isDemoModeEnabled</key>
<false/>
<key>com.sap.mobile.emr.serverUrl</key>
<string>https://imagoverum.com:18000/sap/opu...EMR/MOBILE_EMR</string>
<key>com.sap.mobile.emr.clientId</key>
<string>001</string>
<key>com.sap.mobile.emr.ssoURL</key>
<string>https://imagoverum.com:18130/z_mobil...sap-client=050</string>

VPP Applications

When integrating with Apple’s VPP Program, VPP applications will automatically show in the App Portal. These cannot be added manually and will be imported by the system.

By editing VPP Applications the VPP Operation Mode can be defined.  

iOS App Management Setting Description
VPP Operation Mode
  • User Preferred
  • Device Preferred
  • Device Only (recommended)
  • User Only

For VPP apps, allows you to specify how licenses should be assigned to users and devices, and in what order of preference.

User Preferred will attempt to assign licenses to Users first, by failing it switches Devices.

Device Preferred will attempt assign licenses to Devices first and failing that, use Users

User/Device Only will only allow this app to be assigned to Users/Devices respectively.

These settings can be set to a default value in the Volume Purchase Program section in the Admin Tab.

 

  • Was this article helpful?