This article explains how to enrol your school’s managed iPads into your classroom.cloud environment using Mosyle to deploy the required Student app and configuration to the devices. It is assumed that your classroom.cloud account has been created and the basic site administration tasks have been completed.
Downloading the classroom.cloud configuration
The first step we cover is how to download the configuration settings that ensure your iPads are enrolled into the correct site within your classroom.cloud environment. When your classroom.cloud account was created, three items of information were provided that identify your organisation and the individual school sites within it:
- Your classroom.cloud account ID.
- The unique site ID for each site created in your organisation.
- The ‘cloud’ region where your classroom.cloud account is hosted.
It is this information that needs to be included in the Mosyle deployment. If you are a multi-site academy, the site ID is particularly crucial as it ensures each iPad is enrolled into the correct location.
- Sign in to your classroom.cloud account.
- Navigate to the site where you want the iPads to be enrolled into (for multi-sites, repeat this process for each one).
- Select the Installers option.
- From the list of available platforms, select iOS.
- The page displays the required site configuration details, but to help ensure the information is correctly added to your Mosyle deployment, a ready-made file can be downloaded in plist format. Click the Download (.plist) button.
The file contains the three required keys for site ID, account ID and region, followed by the configuration details. Optional commands can also be added to the plist. A table detailing these follows.
Creating the deployment package within Mosyle
With the classroom.cloud configuration saved for later, we can now focus on the steps required within Mosyle to create the application.
- Sign in to your Mosyle account.
- Select Management and under Management Profiles, select Install App.
- Click Add new profile, give this profile a name and in Installation source, select App Store.
- Select Add application and search for the classroom.cloud Student app.
- The app is added to your profile in Mosyle. You now need to configure the app with your site information. To do this, click the C icon on the classroom.cloud Student app.
- The App Configuration window opens. Select the option Prepare and Apply an AppConfig PLIST.
- Paste in the contents of the .plist file you downloaded earlier. Ensure you remove the XML headers at the start and end of the document and start and end the configuration with the dict tags as shown below.
- Select Confirm. This takes you back to your profile. In the Profile Assignment section, select the Add Assignment option and choose the devices you want this profile to be applied to.
- Once you are happy, click Save. The app will be deployed to your iPad devices.
If you are a multi-site academy, you need to repeat the steps above to create an app configuration policy for each site you are deploying the app configuration to. The devices will initially appear in the classroom.cloud web portal as unassigned devices within the selected site.
To become a fully licensed device that can be connected to by teachers in a class or by a school technician, the device(s) now need to be assigned to the appropriate device group. Our accompanying Organisation Administrator’s user guide provides full details.
Although, as a minimum requirement, your deployment package needs the classroom.cloud site configuration details mentioned previously, the following optional settings can also be included:
Setting | Key | Value type | Example value | Description |
Device Name | com.nsl.device.name | String | %DeviceName% | The device name of the iPad. |
Serial Number | com.nsl.device.serialnumber | String | %SERIALNUMBER% | The serial number of the iPad. |
Default URL | com.nsl.browser.defaulturl | String | Valid URL address | Set the default web page for the browser. |
Auto Sign-Out | com.nsl.session.timeout | Number |
0 = Never 2 = 2 minutes 5 = 5 minutes 10 = 10 minutes 15 = 15 minutes 30 = 30 minutes 60 = 60 minutes |
Other number values will be rounded to the nearest highest value. |
Remember Login Username | com.nsl.login.user.remember | Boolean | True/False | Set the app to remember the login credentials. |
Use Anonymous Sign-In | com.nsl.login.user.anonymous | Boolean | True/False | Allow users to sign in without needing to enter a username. |
Asset Tag | com.nsl.cloud.assettag | String | %AssetTag% | Set an asset tag for the device. |
Clear Internet History On Sign-Out |
com.nsl.browser. clearinternethistoryonsignout |
Boolean | True/False | Any web searches will be cleared when the student signs out of the app. |