Jump Desktop MDM Configuration
iOS 7 introduced a way for iOS Apps to receive configuration settings pushed down by a MDM server. Jump Desktop for iOS version 6.0 adds support for configuring Jump Desktop's global settings and pre-defining the user's server lists by pushing down a managed app configuration dictionary through an MDM server.
Jump Desktop for iOS - MDM setting keys and values
|reverseScrollDirection||boolean||set to true to reverse the scroll direction of the scroll gesture|
|rdpInitialNumLockState||boolean||set to true to enable NumLock on connect or false to disable NumLock on connect. This applies to RDP only.|
|idleTimerEnabled||boolean||set to true to disable sleep on the device when connected to a remote server|
|autoReconnectEnabled||boolean||set to true to make sure Jump tries to reconnect to computers if it's disconnect by network errors or because the application was terminated while in the background|
|disableVNC||boolean||set to true to disable VNC completely|
|mapHardwareKeyboardLeftAltToRightAltKey||boolean||set to true to map the left alt key on hardware keyboards to the right alt key|
|addHardwareKeyboardMappings||boolean||set to true to add Jump Desktop's Physical Keyboard Macros|
|servers||array of strings||an array where each element is an entire JSON document describing a pre-defined server. Pre defined servers are always present in the user's server list. See the section on Predefining servers via MDM for more information.|
Linea / Infinite Peripherals specific options
|lineaBarcodeScanMode||integer||0 - single scan mode, 1 - multiple scan mode, 2 motion detect mode|
|lineaBeepOnScan||boolean||set to true to make sure the unit beeps after each scan|
|lineaPostBarcodeKeyStrokes||string||a set of keystrokes to send after each successful barcode scan|
|lineaPostMagneticStripeKeyStrokes||string||a set of keystrokes to send after each successful magnetic stripe scan|
Jump Desktop iOS Bundle ID
The bundle id for the App Store version of Jump Desktop is: 4GU63N96WE.com.p5sys.jumpdesktop. You'll need this while configuring your MDM settings.
Predefining servers via MDM
Jump Desktop for iOS and Jump Desktop for Mac store computer lists in the JSON file format (it's a human readable text based file format). To predefine servers via MDM, push down the servers array through managed app configuration. The servers array is an array of strings where each string defines one computer. Each string in the array should contain a valid JSON document describing the connection. The servers array can contain computers, RD Gateway and SSH configuration JSON documents. For more information about file formats used by Jump Desktop click here: Jump Desktop File Formats.
The recommend way of creating Jump Desktop JSON files is to create the configuration using Jump Desktop's UI on iOS or Mac and then transfer the configuration information to the MDM server. Here's how you would do that:
- Create your connections using Jump Desktop's on iOS or Mac. Once your connections are created move to step 2.
- Export the connection list by tapping the settings button on iOS and then tap Export Servers button. On a Mac click File -> Export...). This will export your server configuration as a jdz file.
Next we'll extract the jdz file and copy/paste the contents to MDM's app configuration
- A jdz file is just a simple zip file. Copy the jdz file to a Mac or PC (email it to yourself if you're on iOS).
- Rename the file extension to zip and uncompress the contents to a folder on your computer.
- Browse inside the servers directory. Here you'll see one .jump file per computer, SSH Server or RD Gateway you created.
- Open up each .jump file inside a text editor like TextEdit or Notepad and copy paste the contents of the file into a string value inside the servers array in your MDM configuration tool and push it down to the device.
Tip: If you want your users not to be able to edit computer configuration add the the following line in the JSON document:
"DisableServerEdit" : true,
Step-by-Step MDM Configuration using Apple OS X MDM Server
Apple's OS X MDM Server lets you upload a configuration dictionary for each app you configure. The configuration dictionary must be a Property List file. To get started we're going to create a property list file in XCode:
- Open up XCode and create a new Property List file: File -> New -> Resources -> Property List.
- To add predefined servers into the list make sure you've already created your .jump files by following the steps in "Predefined servers via MDM" and then do the following:
- Add a new array to the Root node called servers. Make sure it's type is set to Array.
- Add a new element to the servers array by clicking the + button right next to element. This should add a new item underneath servers. Make sure the item's type is set to String
- Open up each .jump file inside a text editor like TextEdit or Notepad and copy paste the contents of the file into the string value.
- Repeat steps 2 & 3 for all your servers.
- To add regular configuration create the corresponding key value types defined above.
- Save your file.
- Open up Apple's MDM Configurator and add a new "App Configuration" payload. Set the Bundle ID to: 4GU63N96WE.com.p5sys.jumpdesktop and upload the configuration file you just created in XCode. A sample configuration file is attached to this ticket that you can open up in XCode and edit.