Before using the iPad app it must first be enrolled with your risr/assess back-end instance. This allows the app to download your exam data and apply any required customisations.

There are 3 ways in which enrolment may be done:

• Manually

• Via Apple Configurator 2

• Using an MDM

In each case two pieces of information are required: the back-end domain name and a secret key. These will be provided to you by your risr/assess representative.

To view or create your secret, sign in to your risr/assess server, then:

• Click on Setting from the top menu

• Click on Devices

• View Secret (or click Generate New Secret)

Automatic Updates

On the iPad

• Click Settings

• Click General

• Click Software Update

• Ensure Automatic Updates is set to OFF

Also

• Click Settings

• Click iTunes & App Store

• Click Automatic Downloads

• Ensure Updates or App Updates is set to OFF

Enrolment Options

Manual

Where the app is being installed directly from the App Store on to a device we provide a manual enrolment process

Apple Configurator 2

1. Before starting: Apple Configurator 2 needs to be obtained from the App Store and added to the control device in the usual way.

   1. You must first be logged in to the App Store within Configurator 2

   2. The Practique app is downloaded from the App Store to the Configurator 2 using menu options Actions > Add > Apps, and choosing to search for apps.

   3. You may find when searching for Practique that there are no results returned.
      In this case you should directly install it from the App Store on to one iPad and sync that iPad to the control device running Configurator 2.
      It will then be available to you when you search so it can be added to other devices, or a blueprint.

2. Before launching, the app enrolment details must be added to the app via a plist file called OrganisationEnrollment.plist.
   A sample file is available here, please edit and add the correct details for your risr/assess instance.
   note:
   For apps before 6.1.0 you must not alter or change the file name in any way (that includes a number on the end ie if you download it 3 times it may have (3) at the end of the file name).
   Since 6.1.0 this restriction has been lifted and any filename can be used, however the details must still be in plist format.

<key>domain</key>
<string>client-a.practique.net</string>

<key>secret</key>
<string>a-secret-key</string>

1. To enrol the iPads: Add the plist to the application using the Configurator 2 menu options follow - Actions > Add > Documents.
   When asked to chose an application, select risr/assess. You will need to select the iPads that you would like to apply the configuration to, before adding the documents.

2. On launching, the app enrolment and configuration will occur automatically without needing to manually enter the details. The iPads will need an internet connection to complete the enrolment 

3. The launch continues as from the "Enrolling ... please wait" progress screen in the Manual process

MDM

1. The app needs to be obtained from the App Store and added to your MDM in the usual way.

2. Before publishing to devices the app enrolment details, "domain" and "secret", must be added to the MDM as Managed App Settings.
   This image shows the settings used for these tests on our Meraki MDM.

3. On launching, the app enrolment and configuration will occur automatically without needing to manually enter the details.

4. The launch continues as from the "Enrolling ... please wait" progress screen in the Manual process

Unenrolment Options

Once enrolled, the application will remain enrolled until

1. it is removed from the device, or

2. you chose to reset the enrolment using the Administrator Settings section in Application Information, or

3. (only since 6.1.0) you add new enrollment details using an MDM or Configurator 2.

You can change enrollment details on an MDM by adding new managed app data for the domain and secret, or on Configurator 2 by adding a new OrganisationEnrollment.plist to risr/assess.

Note for releases before 6.1.0: If you have used an MDM or Configurator 2 for enrolment, the details should be changed before resetting the enrolment on the app. This way the new values will be detected immediately when the enrolment is reset.

Access to the Administrator settings requires an Administrator password. This will be provided to you along with your domain and enrolment secret.

To reset the app enrolment (only required for manual enrolment, or for apps before 6.1.0)

• select the application information button in the bottom right corner of the exam list screen

• scroll down to the Advanced selection

• select Administrator settings

• you will be asked to login

• once authenticated you can chose to Reset enrolment

• after confirming, the app will reset to the enrolment screen and you can enrol again (unless using MDM / Configurator 2 as mentioned above)