This knowledge base article is for version 2.0 of our client. For settings related to version 1.0, Click here


Purchase & Deploy iOS 


This article explains how the iOS app can be purchased from the App Store and deployed to your managed iOS devices. 


Register With Senso 


The app is available privately in the app store through the Apple Business / School Manager program. Follow the guide LINK for instructions on how your organization can gain access to the app. 


Purchase Licenses From Apple 


Once you have gained access to the app, it can be purchased as a custom app through Apple Business / School Manager.  

 

You should purchase as many licenses as you have physical devices. The licenses purchased through Apple have no relation to your Senso device license count. These licenses relate to the amount of licenses you can distribute via your MDM solution only. The number of licenses can be altered at any time through the Apple web console. 

 

To purchase licenses, perform the following steps: 


1. Login to Apple Business / School Manager 

2. Go to Custom Apps 

3. Select Senso Mobile v2 (if you do not see this option, ensure your organization has been enrolled and you have custom apps enabled, LINK) 

4. Under Buy Licenses select the following options

License Type 

Managed 

Assign To 

Select an appropriate location 

Quantity 

Select an appropriate quantity 


5. Once you have filled in the details click Get 

6. You should receive a confirmation email from Apple, confirming that the number of licenses requested have been acquired successfully. 

 

You are now ready to deploy the app via your MDM. Since there are many MDM solutions that could be used to deploy the app, please refer to the documentation for your specific vendor to deploy the app.

Graphical user interface, application 
Description automatically generated

 

Enrol Devices

If your MDM requires a Bundle ID please use com.renatosoftware.SensoMobile2


The following keys can be set in the app and can be configured via a MDM solution:


Key

Value

Data Type

senso:license_key

Your Organisations license key.

String

senso:assignment_key

The specific site ID to assign the devices to

String

senso:remain_signed_in

Saves a users credentials so they do not have to enter these every time they sign in

 (Only applicable to Microsoft SSO)

String

senso:enabled_custom_sign_in

Allow the user to sign in with just first name and last name

String

senso:enabled_microsoft_sign_in

Enable / disable Microsoft SSO option

String

senso:enabled_google_sign_in

Enable / disable Google SSO option

String


 senso:default_home_page

Users can set the default page the application opens up to

String


If your vendor presents configuration through a GUI, you will have to enter the key value pairs and set the datatypes accordingly. If your vendor does not provide a GUI and instead requires a property list (plist) file, copy the following template:


<plist>
<dict>
<key>senso:license_key</key>
<string>XXX-XXX-XXX</string>
<key>senso:assignment_key</key>
<string>YYY</string>
<key>senso:remain_signed_in</key>
<string>true</string>
<key>senso:enabled_custom_sign_in</key>
<string>false</string>
<key>senso:enabled_microsoft_sign_in</key>
<string>true</string>
<key>senso:enabled_google_sign_in</key>
<string>true</string>
<key>senso:default_home_page</key>
<string>https://www.google.com</string>
</dict>
 </plist>

 
Replace the X with your license key and Y with your assignment key (You license key can be located here and assignment key can be located here)

You can either paste the xml above into your MDM or alternatively you can save the document as configuration.plist file (using Notepad or other text editor). 


Once the app has been deployed to a new device, open the app if it presents the login screen and is visible from the Senso console, the auto enrolment process has completed. 


This process currently does not support changes to configuration, to change where a device is enrolled to you should delete and reinstall the app on the device.


Common third Party MDM Guides on Deploying the App Configuration

 

Microsoft Intune

https://docs.microsoft.com/en-us/mem/intune/apps/app-configuration-policies-use-ios


Cisco Meraki MDM
https://documentation.meraki.com/SM/Profiles_and_Settings/Using_the_Managed_App_Settings_Payload


Lightspeed MDM

https://help.lightspeedsystems.com/s/article/policies-app-configuration?language=en_US


JAMF MDM

https://docs.jamf.com/jamf-school/deploy-guide-docs/Creating_Managed_Configurations_for_Apps.html