Skip to main content
Matrix42 Self-Service Help Center

Matrix42 Documents App

Manual Installation

Install the App for iOS from Apple App Store here.

Install the App for Android from Google Play Store here.

On unmanaged device

Supported Content Provider

If your device is unmanaged you can use Documents App for setting up Sharepoint. Documents App supports following Sharepoints:

  • Sharepoint 2013 with Basic Authentication
  • Sharepoint 2016 with Basic Authentication
  • Sharepoint with Office 365 Authentication

Supported Operations

  • Open folder
  • Viewing files (png, jpg, pdf, pptx, docx, xlsx, mov, mp4, mp3 and many more)
  • Operations on folder
    • Rename
    • Delete
  • Operations on files
    • Move
    • Duplicate
    • Rename
    • Delete
    • Information
  • Information of a file
    • Name
    • File Size
    • Create Date
    • Modified Date
    • Encryption information
  • Add and Create
    • Add files from different other applications from iOS Files App / Android File System Browser
    • Add Image from Gallery or from Camera
    • Adding new folder

Managed Installation

Install the App for iOS from Apple App Store here.

Install the App for Android from Google Play Store here.

On managed device

Supported Content Provider

If your device is managed you can use Documents App for setting up Silversync and Sharepoint. Documents App supports following Content Provider:

  • Silversync
  • Sharepoint 2013 with Basic Authentication
  • Sharepoint 2016 with Basic Authentication
  • Sharepoint with Office 365 Authentication

Supported Operations

  • Open folder*
  • Viewing files* (png, jpg, pdf, pptx, docx, xlsx, mov, mp4, mp3 and many more)
  • Operations on folder
    • Rename
    • Delete
  • Operations on files
    • Move
    • Duplicate
    • Rename
    • Delete
    • Information*
  • Information of a file
    • Name*
    • File Size*
    • Create Date*
    • Modified Date
    • Encryption information*
  • Add and Create
    • Add files from different other applications from iOS Files App / Android File System Browser*
    • Add image from Gallery or from Camera*
    • Adding new folder

*Available for Silversync 

Silverback, Silversync and Documents App

Silversync is only available in combination with Silverback. Here you can read how to enable Silversync in Documents App unsing Silverback.

Setup Silversync to use Documents application for iOS

To setup Silversync to use it in Documents application for iOS please follow this guide.

Setup Silverback to configure Documents application for iOS

To add the Document application for iOS into Silverback please follow this guide

Then just add newly created application to your tag (more information about tag’s you can find by following link)

With Silverback you are able to configure following Documents application features:

  • Branding
  • Security settings
  • Restrictions of executable actions
  • Encryption

Branding

These settings allow you to customize the colors or the presented websites for this application. Enter your settings under the section “Common”:

  • TintColor: Setup color of buttons. Use the RGB code colors in decimal format separated by comma. If this key isn’t set, then the yellow color will be used.
  • HelpUrl: Setup help URL. This link is visible in the settings screen
  • HomepageUrl: Setup homepage URL. This link is visible in the settings screen

<key>Common</key>
<dict>
    <key>TintColor</key>
    <string>252,191,34</string>
    <key>HelpUrl</key>
    <string>https://help.matrix42.com</string>
    <key>HomepageUrl</key>
    <string>https://www.matrix42.com</string>
</dict>

Security Settings

These settings allow you to setup the security settings for the user. Enter your settings under the section “Security”:

  • Password: Force or forbid the user to setup the application password. After that the user must enter it each time when the application is started or is moved to the foreground
  • TouchID/FaceID: Enforces or forbids the user to authorize via Touch ID or Face ID instead of an application password
  • PrivacyScreen: All sensitive information will be blurred when switching out the app or when switching between the applications in the iOS task bar

<key>Security</key>
<dict>
    <key>Password</key>
    <string>true</string>
    <key>TouchID/FaceID</key>
    <string>false</string>
    <key>PrivacyScreen</key>
    <string>true</string>
</dict>

Restrictions of executable actions

These settings allow you to setup multiple content providers restrictions for them. In this case the strongest by priority will be used. Enter your settings under the section “ContentProvider”:

  • Type: Setup type of content provider. Currently Documents application supports following types:
    • SharePoint
    • Silversync
  • ServerUrl: Setup a server URL. Changes will be applied for this server.
  • AllowUnmanaged: Setup this key in case you want to allow unmanaged content providers which match the ‘Type’ or the ‘ServerUrl‘
  • ForbiddenActions: Setup a list of actions which should be disabled. Currently Documents supports following actions
    • DeleteFile
    • RenameFile
    • MoveFile
    • DuplicateFile
    • UploadFile
    • UploadImage
    • CreateDocument
    • CreateFolder
    • DeleteFolder
    • RenameFolder

Example: Configure restrictions only for example: https://cmmsp.imagoverum.com.
Result: The user can not delete, rename or move files in this content provider:

<!-- Setup a list of content providers with their restrictions -->
<key>ContentProvider</key>
<array>
    <dict>
        <key>ServerUrl</key>
        <string>https://cmmsp.imagoverum.com</string>
        <key>AllowUnmanaged</key>
        <string>true</string>
    <key>ForbiddenActions</key>
    <array>
        <string>DeleteFile</string>
        <string>RenameFile</string>
        <string>MoveFile</string>
    </array>
</dict>
</array>

 

Example: Configure restrictions for all SharePoints.

Result: The user can not delete, rename or move files in all SharePoints in this application

<!-- Setup a list of content providers with their restrictions -->
<key>ContentProvider</key>
<array>
    <dict>
        <key>Type</key>
        <string>SharePoint</string>
        <!--<key>ServerUrl</key> -->
        <!--<string>https://cmmsp.imagoverum.com</string> -->
        <key>AllowUnmanaged</key>
        <string>true</string>
    <!-- Setup a list of actions on content which should be disabled -->
    <key>ForbiddenActions</key>
    <array>
        <string>DeleteFile</string>
        <string>RenameFile</string>
        <!-- <string>MoveFile</string> -->
        <string>DeleteFile</string>
        <string>CreateFolder</string>
        <!--  <string>CreateDocument</string> -->
    </array>
    </dict>
</array>

 

Encryption

These settings allow you to setup the encryption feature in Documents application. Enter your settings under the section “Encryption”:

  • EncryptionEnabled: Enable or disable the encryption in the application choosing true or false value.
  • EncryptionType: Choose the encryption type. Currently Documents application supports following types of encryption:
    • MobileEncryption
    • PermanentEncryption
    • Common Key Encryption (Only availble if CPKFile and CPKPassword are available)
  • EncryptionStrength: Setup the encryption strength by choosing one of following sizes 1024, 2048 or 4096
  • EncryptBeforeUpload: Setup if files should be encrypted before uploading to the server by choosing true or false value.
  • CPKFile: The base64 encoded xml content .cpk file which contains the information about the used common key encryption. The encode the xml content and the password you can use an online tool like https://www.base64encode.org.
  • CPKPassword: The base64 encoded password which is needed to encrypt the cpk file content

<key>Encryption</key>
<dict>
    <key>EncryptionEnabled</key>
    <string>true</string>
    <key>EncryptionType</key>
    <string>PermanentEncryption</string>
    <key>EncryptionStrength</key>
    <string>2048</string>
    <key>EncryptionBeforeUpload</key>
    <string>true</string>
    <key>CPKFile</key>
    <string>PD94bWwdmVyc2lvb..vha1Adj</string>
    <key>CPKPassword</key>
    <string>MTeXMQ==</string>
</dict>

Example XML for iOS

Download here

<key>UDID</key>
<string>{DeviceID}</string>
<key>DocumentsAppConfiguration</key>
<dict>
<!-- Configure your branding -->
<key>Common</key>
<dict>
    <!-- Setup button color. Default is yellow -->
    <key>TintColor</key>
    <string>153,131,202</string>
    <!-- Setup help url -->
    <key>HelpUrl</key>
    <string>https://www.google.de</string>
    <!-- Setup homepage url -->
    <key>HomepageUrl</key>
    <string>https://www.google.de</string>
</dict>

<!-- Configure security settings -->
<key>Security</key>
<dict>
    <key>Password</key>
    <string>false</string>
    <key>PrivacyScreen</key>
    <string>false</string>
</dict>

<!-- Setup the encryption functionality in the application -->
<key>Encryption</key>
<dict>
    <key>EncryptionEnabled</key>
    <string>true</string>
    <key>EncryptionType</key>
    <string>MobileEncryption</string>
    <key>EncryptionStrength</key>
    <string>2048</string>
    <key>EncryptBeforeUpload</key>
    <string>OnDemand</string>
</dict>

<!-- Setup a list of content providers with their restrictions -->
<key>ContentProvider</key>
<array>
    <dict>
        <key>Type</key>
        <string>SharePoint</string>
        <!--<key>ServerUrl</key> -->
        <!--<string>https://cmmsp.imagoverum.com</string> -->
        <key>AllowUnmanaged</key>
        <string>true</string>
    <!-- Setup a list of actions on content which should be disabled -->
    <key>ForbiddenActions</key>
    <array>
        <string>DeleteFile</string>
        <string>RenameFile</string>
        <!-- <string>MoveFile</string> -->
        <string>DeleteFile</string>
        <string>CreateFolder</string>
        <!--  <string>CreateDocument</string> -->
    </array>
</dict>
</array>
</dict>

 

Setup Silversync to use Documents application for Android

To setup Silversync to use it in Documents application for Android please follow this guide.

Setup Silverback to configure Documents application for Android

To add the Document application for Android into Silverback please follow this guide. Use com.matrix42.m42content to find Documents App in the Managed Play Store.

Then just add newly created application to your tag (more information about tag’s you can find by following link)

With Silverback you are able to configure following Documents application features:

  • Branding
    • Tint Color
    • Help Url
    • Homepage Url
  • Security settings
    • Setting Password
    • Setting biometric Authentication

Documents_App_Android_App_Portal_Managed_Silverback.png

If you have troubles seeing some extension add the missing extension like ".espe" in Silverback Admin Console under Silversync/ System Settings/ Allowed Extensions

How to use Common Key Encryption

Preparation Silverback

Install Silverback and Silversync. Please check the help for, available here.

Preparation EgoSecure

Install EgoSecure and Setup Common Key Encryption. Please check release documentation of EgoSecure available here.

Combine Silversync and EgoSecure

After Silverback, Silversync and EgoSecure are installed and configured, a EgoSecure Client Agent needs to be installed on the same machine as Silversync running on.

Define in EgoSecure Console the Silversync root path as a location on system that needs to be encrypted by Common Key Encryption. EgoSecure Agent will encrypt files.

Documents_App_Common_Key_Encryption_Setup_001.png

Add the Local Folder to be encrypted. The Local Folder is in this case the Silversync Root Folder.

Documents_App_Common_Key_Encryption_Setup_002.png

Export Common Key Encryption

To use the Common Key Encryption in Documents App, you need to export the Common Key from EgoSecure Console.

Documents_App_Common_Key_Encryption_Setup_003.png

In Key Management, you can export the Common key. After that you will be prompt to enter a passwort to protect the common key. This feature is available from EgoSecure 14.2.

Documents_App_Common_Key_Encryption_Setup_004.png

Remember the password.

After the successfull export you can open up the CPK file with an Editor like Notepad++.

At this point you can now got to section Encryption to configure the XML for the App. 

  • Was this article helpful?