AppConfig Reference
The following table should be used as a reference for the Mobile Device Management (MDM) AppConfig key/value pairs used by Imprivata MDA.
Depending on your MDM's interface, some AppConfig keys are displayed with specific UI labels.
See the Notes column in the table below for specifics.
| AppConfig Configuration Key | AppConfig Value Type |
AppConfig Value |
Description | Notes |
|---|---|---|---|---|
| ConfigFlags | String | lockOnLogoutFail | Locks the device if any app logout action fails. |
Supported by Imprivata MDA 10.0 and later For more information, see Lock on App Logout Failure |
| ConfigFlags | String | browserLogoutLast |
Sets the order of MDA logout operations to log the browser out last. This AppConfig allows backwards compatibility to support the order of logout operations used in earlier releases of MDA. |
Imprivata MDA 8.2 makes changes to the order of logout operations. For more information, see MDAOrder of Logout Operations. |
| ConfigFlags | String | bootLockDelay=60 |
When bootLockDelay is in effect, the device cannot be unlocked. The delay timer only starts when the device has finished rebooting.
|
Supported by Imprivata MDA 8.2 and later. |
| ConfigFlags | String | fidoEnrollmentOn |
Allows users to enroll their unenrolled FIDO security keys from the Imprivata MDA app. If treatNfcTapAsProx is set, Imprivata MDA will ignore fidoEnrollmentOn. |
Supported by Imprivata MDA 8.2 and later. |
| ConfigFlags | String | dexControlOn |
Use Samsung DeX functionality. The device prompts for the required Device Administrator permissions and activates required Knox SDK license. Enables the Samsung DeX session to stop when MDA is signed out. |
Supported by Imprivata MDA 8.1 and later. See Samsung DeX. |
| ConfigFlags | String | treatNfcTapAsProx |
For customers with proximity cards that communicate with the same protocol as FIDO security keys, treatNfcTapAsProx enables proximity card-only mode.
|
Supported by Imprivata MDA 8.1 and later.
|
| ConfigFlags | String |
emergencyCalls emergencyCalls:<phone number> emergencyCalls:<phone number>|skipConfirmation |
Allows the user access to the phone dial pad so they can make phone calls from the Imprivata MDA lock screen, without the user needing to authenticate to the device. To define a preconfigured phone number, set the <phone number> value to the phone number needed. Supports US and International phone number formats. skipConfirmation removes the confirmation dialog box that pops up before a call. |
Supported by Imprivata MDA 8.1 and later. See Emergency Calls |
| ConfigFlags | String | forbidForegroundServiceNotificationCanceling |
Sets the Imprivata MDA foreground service notification to be non-cancellable.
|
|
| ConfigFlags | String | verboseLogsOn | Collect Imprivata MDA verbose logs. | Overrides the Verbose Logging switch on Imprivata MDA Settings page. |
| ConfigFlags | String | logcatOn | Send Imprivata MDA logs to Logcat. |
Helpful for troubleshooting purposes. For security reasons, by default, Imprivata MDA only sends error logs to Logcat. |
| ConfigFlags | String | msalLoginShowUserConsent | When present, the MSAL consent screen is shown to the user; omitting this flag causes Imprivata MDA to bypass the consent screen automatically. | |
| ConfigFlags | String | msalLoginTimeout=<ms> |
Overrides the MSAL sign-in timeout. Default is 15000 ms. Example: msalLoginTimeout=30000. |
|
| ConfigFlags | String |
msalLoginOn |
Automatically sign the user in to Microsoft apps when using shared device mode. | |
| ConfigFlags | String | followMsalGlobalSignout | Automatically sign the user out of all apps, including non-MSAL apps, when the user logs out of a Microsoft app. | |
| ConfigFlags | String | autostartApps=[appPackagenames] | Automatically launch the apps on checkout. | |
| ConfigFlags | String | autostartDelayMillis=<milliseconds> |
Allows a delay, in milliseconds, before Imprivata MDA starts processing AutostartApps. |
|
| ConfigFlags | String | autostartPeriodMillis=<milliseconds> |
Allows a delay, in milliseconds, between AutostartApps launch attempts. |
|
| ConfigFlags | String | lockOnCharge |
Lock the device when Imprivata MDA detects the device is charging Used with logoutOnCharge |
|
| ConfigFlags | String | logoutOnCharge |
Log the user out from the apps when Imprivata MDA detects the device is charging. Used with lockOnCharge |
|
| ConfigFlags | String | allowOfflineMode | Enables offline mode, allowing authenticated users to Imprivata MDA to unlock the device and have SSO available when in offline mode. | |
| ConfigFlags | String | offlineToOnlineReauth |
Require the user to reauthenticate when Imprivata MDA transitions from offline to online, only when the user session was last unlocked in offline. The flag has no effect on online established sessions. Used in combination with allowOfflineMode. |
|
| DefaultAuthDomain | String | <yourDomain> |
Set the domain selected by default when the user authenticates to Imprivata MDA with their username and password. . |
See Configure a Default Domain. Depending on your MDM interface, this AppConfig may appear as: The domain selected by default when authenticating on MDA with username and password. |
| ConfigFlags | String | allowUntrustedEAMCertificate |
|
Enabled by default in Imprivata MDA 7.15 and later |
| ConfigFlags | String | forceTrustedEAMCertificate |
Imprivata MDA checks for Imprivata appliance server certificate validity and allows you to check whether Imprivata appliance certificate is configured correctly.
|
Supported by Imprivata MDA 7.15 and later. See Trusted Communication to the Imprivata Appliance
|
| ConfigFlags | String | deviceSdkLogout |
Use the Zebra SDK for all SDK based logout methods. Setting deviceSdkLogout is equivalent to setting the following three values:
|
|
| ConfigFlags | String | deviceSdkClearData | Use the Zebra SDK for clearing data based on the SDK. | |
| ConfigFlags | String | deviceSdkClearData | Use the Zebra SDK for clearing cache based on the SDK | |
| ConfigFlags | String | deviceSdkForceStop | Use the Zebra SDK to force stop based on the SDK. | |
| ConfigFlags | String | numericPinOnly | Set the device's keypad to numeric only |
If numericPinOnly is not set, the default behavior of Imprivata MDA is to allow the keypad to be alphanumeric |
| ConfigFlags | String | preventAccidentalTyping |
Prevent users from accidentally typing characters into credentials screens. |
|
| ConfigFlags | String | autofillOn | Allow the Autofill Service to use Imprivata MDA. |
See Configuring Imprivata Mobile Device Access with the Google Autofill Framework. |
| MobilePolicyOverride | String |
For the supported values, see the table of supported mobile policy values available for override. |
Override a limited set of properties of the EAM mobile policy using AppConfig setting. | |
| ConfigFlags | String | com.package.name:forceStop| clearCache|clearData |
Run additional logout actions or different logout methods for the same app. | |
| ConfigFlags | String | allowScreensaver | Allows Imprivata MDA to coexist with device screensavers and not block their use. | |
| ConfigFlags | String | zams |
Allows Zebra Access Management System |
Works with ZAMS v.2.2.9 or later See Configure Imprivata MDA with Zebra Access Management System (ZAMS) |
| ServerIP | String | <Imprivata appliance address> | The server address of the Imprivata appliance | Depending on your MDM interface, may appear as Server address or OneSign server address. |
| OneSignServerCertificate | String | certificate |
Upload the Imprivata appliance certificate to the MDM when deploying Imprivata MDA to a device |
Depending on your MDM interface, may appear as OneSign server certificate. |
| AdminAccessCode | String | <The Admin passcode> | Sets the passcode for admin access. | Requires a minimum of 8 characters. |
| ExternalDeviceSerial | String |
|
Sets Serial number of the device, depending on your MDM. | Imprivata MDA requires access to the device ID to report on individual login and device activity. |
| LandscapeDevices | String | Comma-separated list of mobile device model numbers | Change the mobile device's orientation from portrait to landscape mode. |
Optional. Device numbers can be found in Android settings, but may depend on the device vendor and Android version. Example: Versity 9540, SM-G95OU1, Pixel 4 |
| LockMode | String | CountdownToLockMode | Enables the Countdown to lock mode. | Optional. |
| CountdownToLockMinutes | String | 240 | Sets the number of minutes to count down before locking the device. |
Default value is 240 minutes (4 hours). Minimum value is 20 minutes. |
| DeviceInfoPattern | String | <string with Variables> |
Sets a string pattern containing the supported variables to identify the device, that will be replaced with actual device-specific strings. |
Optional. Variables - obtained from system settings:
The variables can be combined with a customized text string to identify the device. Example: This is $DeviceName, $AndroidShortVersion Results: This is Galaxy Note 5, A13 |