Skip to main content
Matrix42 Self-Service Help Center

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

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>

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

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>

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>

  • Was this article helpful?