Follow

Entering and Exiting SAM (Single App Mode)

SAM, or Single App Mode is a method of locking down the device to a single app available only on Supervised devices. More specifically it is a method of locking the device to the app that is running. This is available on devices that meet the following requirements:

  1. The device must be Supervised (can be done through DEP or Apple Configurator)
  2. The app must have the SAM code integrated (already integrated in MokiTouch 2, see SAM documentation if you aren't using MT2, particularly the section on UIAccessibilityRequestGuidedAccessSession)
  3. A Custom Action in the app or in Moki (your MDM provider) must exist to activate and deactivate SAM (MokiTouch 2 comes with this but if you are using your own app, see our SDK documentation for custom actions)
  4. A Restrictions profile must be installed on the device that approves the app to enter Autonomous Single App Mode

Step 1 - Create the Restrictions Profile

  1. Go to the iOS Profiles tab in the top navigation

    Screen_Shot_2016-06-17_at_2.24.39_PM.png
  2.  
  3. Click Restrictions then click New Profile

    Screen_Shot_2016-06-20_at_1.43.12_PM.png
  4.  
  5. Give the profile a name

    Screen_Shot_2016-06-20_at_2.07.37_PM.png
  6.  
  7. Click the text box under the label Autonomous App and select your app, or enter the app's BundleID if the app isn't in your Moki account 

    Screen_Shot_2016-06-20_at_2.10.59_PM.png
  8.  
  9. Configure the rest of the restrictions the way you want (see the Restrictions section of our iOS Profile Definitions article)
  10. Hit Save

Step 2 - Install the Restrictions Profile

After you have created your Restrictions Profile you can apply that to your devices. You can add this to your enroll code, apply it to your devices one by one or you can schedule when you want it to install. Refer to our article on scheduling actions if you want to apply it to all devices at once. 

  1. Go to the Devices tab in the top navigation

    Screen_Shot_2016-06-17_at_3.20.01_PM.png
  2.  
  3. Select the device(s) you want to apply the profile to

    Screen_Shot_2016-06-17_at_3.20.59_PM.png
  4.  
  5. Click the drop down that says Profiles and select your profile

    Screen_Shot_2016-06-20_at_2.27.39_PM.png
  6.  
  7. Confirm you want to send it to your devices

    Screen_Shot_2016-06-20_at_2.29.29_PM.png

Step 3 - Enter SAM (Single App Mode)

Entering SAM is an action that is applied through the app management section of Moki or can be done locally on the device, if the app is coded for this

Entering SAM from Moki

  1. Make sure the app is open (you can do this locally on the device or you can apply an App Lock profile to launch the app, then remove the profile so it can enter SAM)
  2. Click Change App in the top left and select your app

    Screen_Shot_2016-06-20_at_2.35.17_PM.png
  3.  
  4. Click the devices tab and select your device(s) you want to lock
  5. Click the drop down that says Actions and select Enter Single App Mode (You may need to scroll to the bottom of the options)

    Screen_Shot_2016-06-20_at_2.39.33_PM.png
  6.  
  7. Confirm you want to send it to the device

    Screen_Shot_2016-06-20_at_2.41.43_PM.png
  8.  
  9. Check that the device has completed the action and actually locked the app on the screen
    1. Click the Action History for the device

      Screen_Shot_2016-06-20_at_3.35.37_PM.png
    2.  
    3. Make sure the Enter Single App Mode says Completed

      Screen_Shot_2016-06-20_at_3.37.01_PM.png

You won't be able to exit the app by hitting the home button or restarting the device

Entering SAM from within MokiTouch 2 settings (MokiTouch 2 only unless you have coded your app to work similarly)

  1. With the app open, enter into MT2 settings by dragging your finger from the top left of the screen to the top right and down to the bottom right (basically making a 7)
  2. Click on Enrollment on the left

    Screen_Shot_2016-06-20_at_3.45.09_PM.png
  3.  
  4. Click the Enter Single App Mode button 

    Screen_Shot_2016-06-20_at_3.45.52_PM.png

Step 4 - Exit SAM (Single App Mode)

You will perform all the same steps as described above, but you will click Exit Single App Mode instead

 

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Article is closed for comments.