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:

Setting Name	Config.json Key	Plist Key	Description	Default Value
License Key	LicenseKey	senso:license_key	The License Key	N/A
Assignment Key	AssignmentKey	senso:assignment_key	The Assignment Key	N/A
Environment	Environment	senso:environment	Environment setting	"2" (Live)
Remain Signed In	RemainSignedIn	senso:remain_signed_in	Microsoft login credentials will be saved	N/A
Enable Custom Sign-In	EnableCustomSignIn	senso:enabled_custom_sign_in	Enable login using a name	false
Default QR Code Sign-In	DefaultQRCodeSignIn	senso:default_qr_code_sign_in	Enable QR code login by default	false
Enable Microsoft Sign-In	EnableMicrosoftSignIn	senso:enabled_microsoft_sign_in	Enable login using a Microsoft account	false
Enable Google Sign-In	EnableGoogleSignIn	senso:enabled_google_sign_in	Enable login using a Google account	true
Default Home Page	DefaultHomePage	senso:default_home_page	Default browser home page or use "about:blank" for a blank page	https://www.google.com
Debug Mode	DebugMode	N/A	Enable logging on connection (for debugging only)	false
Shared Device	SharedDevice	senso:shared_device	Clear browser cookies and site data on logout/restart	false
Max Browser Tab	MaxBrowserTab	senso:max_browser_tab	Maximum number of browser tabs	5
Browsing History Retain	BrowsingHistoryRetainDay	senso:browser_hist_retain_day	Retention days for browser history (autocomplete suggestions)	0
Shared Bookmark	N/A	senso:shared_bookmark	Predefined list of URLs distributed 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>

<key>senso:assignment_key</key>

<key>senso:Environment</key>

<key>senso:remain_signed_in</key>

<key>senso:enabled_custom_sign_in</key>

<string>false</string>

<key>senso:default qr code sign in</key>

<string>false</string>

<key>senso:enabled_microsoft_sign_in</key>

<key>senso:enabled_google_sign_in</key>

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

<key>senso:browser hist retain day</key>

<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”