iOS Managed App Configuration
The following fields define the Managed App Configuration that can be deployed by an MDM provider to control the behavior of the deviceTRUST iOS Client Extension.
| Name | Type | Description | Example |
|---|---|---|---|
| deviceName | string | Provides the user assigned device name. | $DEVICE_NAME$ |
| deviceSerialNumber | string | Provides the serial number of the device. This is used to populate the REMOTE_HARDWARE_BIOS_SERIAL property. | $DEVICE_SN$ |
| userName | string | Defines the user name that the device is assigned to. | |
| userDomain | string | Defines the user domain name of the user that the device is assigned to. | |
| userPrincipleName | string | Defines the user principle name (UPN) of the user that the device is assigned to. | |
| permitAddRegistration | boolean | Determines whether the Add Registration menu item is available once the device has been registered. | false |
| permitRemoveRegistration | boolean | Determines whether the Remove Registration menu item is available once the device has been registered. | false |
| registrationKey | string | Defines the App Registration’s key. When defines, the iOS Client Extension will automatically register instead of using the device camera to scan a QR code. | |
| customProperty0..15 | string | Defines up to 16 custom properties available to the MDM provider. Custom properties must be prefixed with REMOTE_CUSTOM_ followed by a name and value separated by an equals symbol. | REMOTE_CUSTOM_PHONE_NUMBER=$PHONE_NUMBER$ |
The userName and userDomain fields, or alternatively the userPrincipleName field, can be used to optionally identify the user that the iOS device belongs to. This can be used to generate a notification simplifying the entry of the passcode.
Note:
- Each MDM provider includes it's own format to push MDM attributes into the managed app configuration. The examples above are represented as an attribute name separated by `$` symbols. Check your MDM provider documentation for more information.
deviceTRUST Portal MDM Templates
An MDM Template plist file can be downloaded from the deviceTRUST Portal within the App Registration section. This file contains all of the fields above, and can be edited with values suitable for your environment before uploading to your MDM provider.
