Senso Support | Cloud Classroom and Network Management Solution

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.

Please also review your licensing configuration by referring to the following knowledge base article: Device Licensing

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:

config.json file	Plist file	Description	Default Value
LicenseKey	senso:license_key	The License Key	N/A
AssignmentKey	senso:assignment_key	The Assignment Key	N/A
Environment	senso:environment	“2”: Live	N/A
RemainSignedIn	senso:remain_signed_in	Microsoft login credential will be saved.	False
EnableCustomSignIn	senso:enabled_custom_sign_in	Enable login using a name	False
EnableMicrosoftSignIn	senso:enabled_microsoft_sign_in	Enable login using a Microsoft account	True
EnableGoogleSignIn	senso:enabled_google_sign_in	Enable login using a Google account	True
DefaultHomePage	senso:default_home_page	Default home page of browser or set "about:blank" to show a blank page in browser.	https://www.google.com
DebugMode	N/A	Enable logging on connection for debugging purposes only.	False
SharedDevice	senso:shared_device	Enable to clear browser cookies and site data when logout/restart app.	False
MaxBrowserTab	senso:max_browser_tab	Maximum number of browser tab	5
N/A	senso:shared_bookmark	Predefined list of URL distribute to device	N/A

Warning: Google or Microsoft logins are the only reliable methods to accurately identify who is using a device. If you choose to enable the 'First Name - Last Name' option by setting senso:enabled_custom_sign_in to TRUE, please note that this method does not include any validation (e.g., checking against a predefined list). This allows users to input any value, including another person’s name or random characters. Use this option only as a last resort and ensure staff can physically verify that pupils are entering their correct names.

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:Environment</key>

<string>2</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>

<key> senso:shared_device</key>

<string>false</string>

<key> senso: max_browser_tab </key>

<string>5</string>

<key>senso:shared_bookmark</key>
<array>
<string>MDM Bookmark1|https://senso.cloud|Senso.Cloud</string>
<string>MDM Bookmark2|https://www.google.com</string>

</array>

</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.

Setting the app as iOS default browser

Go to “Settings” --> “Apps”--> “Default Apps” --> Change “Browser App”