Silversync Guide VI: M42Mobile for iOS
The M42Mobile application brings everything together and one part is the Mobile Content Management functionality which we will now configure. All you need to do is to import the application first into Silverback and then configure some basic connection configurations to the App. You have also additionally the choice to customize the application, but for Silversync it is only mandatory to define the connection string to the M42Mobile App, so that the application on end user devices knows to which Silverback they belong.
Additionally you can configure:
- Branding (recommended)
- Passcode
- Privacy Setting
- Notifications
- Restrictions
- Start Tab (recommended)
- Service Store Account
Mobile Content with M42Mobile
To use the Mobile Content Management functionality in Silverback you need full fill the following tasks:
- M42Mobile needs to be imported to the App Portal
- via Apple App Store
- via Volume Purchase Program
- Configuration for the app is done via App Portal iOS 7+ App Config (XML File)
- The application needs to be added to a Tag which needs to be assigned to devices
- The application will then be distributed in a configured way with Silverback to end user devices.
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
When you plan to distribute the M42Mobile Application via Volume Purchase Program, the application will be listed automatically after a successful Volume Purchase Program integration.
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
Documents site can be defined as default starting page. Please check corresponding Extend your XML chapter
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
Extend your XML
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 is currently not supported
- 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>
Example XML
Download your example XML: Example.txt
<key>UDID</key>
<string>{DeviceUDID}</string>
<key>EpicUrl</key>
<string>https://silverback.imagoverum.com/epic</string>
<key>TintColor</key>
<string>255,0,0</string>
<key>LogoURL</key>
<string>http://silverback.imagoverum.com/m42mobile.png</string>
<key>EnablePrivacy</key>
<true/>
<key>LocalNotifications</key>
<dict>
<key>Days</key>
<integer>7</integer>
<key>Time</key>
<string>12:00</string>
</dict>
<key>DisableUserAccounts</key>
<true/>
<key>DisableDocumentSource</key>
<true/>
<key>StartTabURL</key>
<string>m42mobile://documents</string>
<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>