Silversync Guide VI: M42Mobile for iOS

Import Application into Silverback

• Navigate to App Portal
• Choose iPhone or iPad
• Click New Application
• Select as Type App Store
• Paste the following URL into the URL field and click populate: https://itunes.apple.com/de/app/m42mobile/id703369512?mt=8
• Enable Automatically push to managed devices 
• Enable Take management if the app is already installed
• Click the Orange Edit Button next to iOS 7+ App Config
• Proceed with Add Silverback Server Connection

Add Silverback Server Connection

Now we need to ensure that the M42Mobile finds by default your Silverback Server and the device identifier. 

• Enable Push on install
• Copy the following XML configuration in your Clipboard
• Change the string to your Silverback URL and keep /epic at the end, e.g  https://silverback.imagoverum.com/epic

<key>UDID</key>
<string>{DeviceUDID}</string>
<key>EpicUrl</key>
<string>https://silverback.imagoverum.com/epic</string>

• That is all we need for now but we can extend some settings
• Click OK
• Save

Add Application to a Tag

• Navigate to Tags
• Edit our in previous chapter created Tag or create a new one
• Navigate to Apps
• Click Assign More Apps
• Select M42Mobile
• Click Add Selected Apps
• Configure Tag Deployment options under Definition or
• Assign the Tag manually with Associated Devices button
• Click Save
• Click Push to devices

Download and start Application

• After a successful Tag configuration the application should be distributed to a end user device after enrollment
• After successful download and installation open M42Mobile on the iOS device
• Allow Notifications
• Tab the Hamburg Menu on the upper left side
• Tab Documents
• Tab Silversync
• Wait until refresh process is finished

Next Steps

• Browse through your folder structure 
  • Open any file and get familiar with M42Mobile App
• Add a branding or configure additional settings with an more flexible XML file
  • Proceed with Extend your XML (optional)
• Learn how to achieve the same result on Android: Silversync Guide V: M42Mobile for Android
• Lean how to integration with Apples Volume Purchase Program: Apple Deployment Programs Integration Guide
• Read our Administrator Guide

Branding (optional)

You can change color of certain fields and texts where by default the Matrix42 orange color is used. This is also called the 'tint color'. Additionally you can exchange the Matrix42 logo with your logo.

• LogoURL: Refer to a URL that is accessible for M42Mobile App. The logo will be download during M42Mobile Setup process
• TintColor: Use the RGB code colors in decimal format separated by comma

<key>LogoURL</key>
<string>http://silverback.imagoverum.com/m42mobile.png</string>
<key>TintColor</key>
<string>255,150,0</string>

Passcode (optional)

• Passcode settings are configured in the passcode dictionary
• Enable: Enforces the user to authorize via passcode when opening the application. 
• Length: Defines the complexity level of the required passcode. Currently the values 4 or 6 are supported
• TouchID: Enforces the user to authorize via TouchID instead of a traditional passcode

<key>Passcode</key>
<dict>
    <key>Enabled</key>
    <true/>
    <key>Length</key>
    <integer>6</integer>
    <key>TouchID</key>
    <true/>
</dict>

Privacy Settings (optional)

Enabling the privacy setting ensures that all sensitive information will be blurred when switching out the app or when switching between the applications in the iOS task bar. In combination with the Passcode settings it prevents not permitted users from getting sensitive data via screenshots:

• Set the following key to activate Privacy Mode

<key>EnablePrivacy</key>
<true/>  

Notifications (optional)

Notifications can be used to define the timeframe end users should be notified regarding pending tasks in the M42Mobile app. The Local Notification configuration is encapsulated in the LocalNotifications dictionary:

Add these values for Notification configuration:

• Set the following key to activate Privacy Mode
• Days: Time frame in days to be reminded in. Currently 0 - 7 is supported, 0 means notifications are disabled
• Time: Specific time of day to be reminded in 24 hour date format.

<key>LocalNotifications</key>
<dict>
    <key>Days</key>
    <integer>7</integer>
    <key>Time</key>
    <string>13:30</string>
</dict>

Restrictions (optional)

The M42Mobile application offers several actions which can be enabled or disabled from the Silverback Server. As soon an action is disabled it can't be used from the end user anymore. 

• DisableUserAccount: Allows to disable the add account action in the application settings
• DisableDocumentSource: Allows to disable the add datasource action in the mobile content management viewer

<key>DisableUserAccounts</key>
<true/>
<key>DisableDocumentSource</key>
<true/>

Start Tab (optional)

• This configuration defines which section from the left menu should be used as the initial page when the application will be started from the end user.

<key>StartTabURL</key>
<string>m42mobile://documents</string>

• The following Start Tabs are available
  • Dashboard: m42mobile://dashboard
  • News: m42mobile://news
  • Applications: m42mobile://applications
  • Documents: m42mobile://documents
  • Contacts: m42mobile://contact
  • Service Catalog: m42mobile://catalog
  • Service Desk: m42mobile://servicedesk
  • Knowledge Base: m42mobile://kb
  • Settings: m42mobile://settings

Connect to Service Store (optional)

Add these values for pre configure Authentication to Service Store:

• Type: Defines the type of the account and must be set to "ServiceStore"
• ServerURL: The external DNS name of the Service Store server  
• Domain: This is the LDAP / Active Directory domain the Service Store Server user belongs to
• Username: Configure the Service Store username. You can use Silverback lookup value to pre-populate
• Password: You should use this field only for demo purposes

<key>Type</key>
<string>ServiceStore</string>
<key>Server</key>
<string>servicestore.imagoverum.com</string>
<key>Domain</key>
<string>imagoverun.com</string>
<key>Port</key>
<string>443</string>
<key>Username</key>
<string>{UserName}</string>
<key>Password</key>
<string>{UserPassword}</string>