Skip to content
Michael Allen edited this page Apr 29, 2022 · 10 revisions

MDM

The Rock Checkin iPad supports configuration via Mobile Device Management systems. This allows you to remotely configure your iPads with the settings they need to perform check-in. Knowing what configuration keys are available is vital so this page includes a list of all these keys and how to use them.

Configuration Keys

Key Value Type Default Description
checkin_address String None The URL to use to connect to the check-in page, this must be a secure (https) URL.
enable_caching Boolean True If enabled, then the application will use local caching of labels.
cache_duration String 1440 How long in seconds to cache labels if caching is enabled.
enable_label_cutting Boolean False If enabled, then the application will control the cutter automatically on the printer.
printer_override String None When a value is provided and the kiosk is configured for client-side printing this will override the value provided by the server. May contain an IP address or host name for IP based printing or the Bluetooth device name for BLE printing.
printer_timeout String 2 The number of seconds to wait for the printer to respond when printing labels.
bluetooth_printing Boolean False If enabled, then the printer name is assumed to be a Bluetooth device name.
in_app_settings Boolean True If enabled, the user will be able to press 5 fingers against the display to activate the in-app settings screen.
in_app_settings_delay String 2 The number of seconds all 5 fingers must be pressed against the display to activate the settings screen.
ui_background_color String #636363 The background color used for certain screens, such as the camera screen.
ui_foreground_color String #ffffff The foreground color used for certain screens, such as the camera screen.
camera_position String front Which camera to use for scanning barcodes, must contain the value front or the value rear.
camera_exposure Real 0.5 Can be set to a value between 0.0 and 1.0 to adjust the exposure of the camera when scanning barcodes.

AppConfig Generator

The AppConfig generator is an easy way to create your managed plist files using a GUI instead of writing the XML by hand. While this tool is provided by JAMF, it creates standard plist files that should work with most MDM providers.

Using the generator is simple:

  1. Download and unzip this specfile, you can also see the contents and copy/paste from MDM Spec File.
  2. Upload it to the AppConfig generator
  3. Select "Configure"
  4. Change settings to match your needs.
    Note: When specifying the camera_exposure value, do not include a leading 0.
  5. Submit the form and download/copy your plist.

Note: This tool will generate a plist that includes values for all checkin options. If you want to allow some options to be user-configurable, you will need to open the generated plist file in a text editor and delete values you don't want to set.

Provider-Specific Notes

Mosyle

The AppConfig generator will create a full plist file, but Mosyle only wants the configuration dictionary. You will need to either use the button for "Copy Dictionary" or manually copy the correct part of the file. You only want this part:

<dict>
    ...
</dict>
Clone this wiki locally