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.

NOTE:

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 purpose of this flag is to allow the SIM PIN to be entered into the device. The user cannot freely unlock and use the device normally.

The delay timer only starts when the device has finished rebooting.

  • The assigned integer value defines the delay in seconds.

  • The maximum delay time is 60 seconds.

  • If the integer is not present, is 0 or negative, the flag is ignored.

  • If the integer entered is more than 60 seconds, the flag applies the maximum delay of 60 seconds.

Supported by Imprivata MDA 8.2 and later.

See Delay the Start of Imprivata MDA

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.

  • If treatNfcTapAsProx is not set, FIDO security keys previously enrolled as proximity cards will fail to authenticate to MDA 8.1 and later.

  • If treatNfcTapAsProx is set, Imprivata MDA will ignore fidoEnrollmentOn.

Supported by Imprivata MDA 8.1 and later.

 

See Authentication Methods

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.

  • The user will not be able to dismiss the notification from the Android notifications bar by swiping.

  • The notification will always be available in the notification bar.

 
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.

See Microsoft Apps Support

ConfigFlags String msalLoginTimeout=<ms>

Overrides the MSAL sign-in timeout.

Default is 15000 ms.

Example: msalLoginTimeout=30000.

See Microsoft Apps Support

ConfigFlags String

msalLoginOn

Automatically sign the user in to Microsoft apps when using shared device mode.

See Microsoft Apps Support

ConfigFlags String followMsalGlobalSignout Automatically sign the user out of all apps, including non-MSAL apps, when the user logs out of a Microsoft app.

See Microsoft Apps Support

ConfigFlags String autostartApps=[appPackagenames] Automatically launch the apps on checkout.

See Launch Apps After First Time Authentication

ConfigFlags String autostartDelayMillis=<milliseconds>

Allows a delay, in milliseconds, before Imprivata MDA starts processing AutostartApps.

See Launch Apps After First Time Authentication

ConfigFlags String autostartPeriodMillis=<milliseconds>

Allows a delay, in milliseconds, between AutostartApps launch attempts.

See Launch Apps After First Time Authentication

ConfigFlags String lockOnCharge

Lock the device when Imprivata MDA detects the device is charging

Used with logoutOnCharge

See Configure Device Lock and Logout on Charging

ConfigFlags String logoutOnCharge

Log the user out from the apps when Imprivata MDA detects the device is charging.

Used with lockOnCharge

See Configure Device Lock and Logout on Charging

ConfigFlags String allowOfflineMode Enables offline mode, allowing authenticated users to Imprivata MDA to unlock the device and have SSO available when in offline mode.

See Offline Authentication.

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.

See Offline Authentication.

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
  • Allows communication with an Imprivata appliance that contains any seIf-signed or expired or invalid certificate.

  • This communication method is considered as not secure, but is for backward compatibility or for administrators to use while they resolve Imprivata appliance certificate issues.

  • If allowUntrustedEAMCertificate is set, then forceTrustedEAMCertificate is ignored.

Enabled by default in Imprivata MDA 7.15 and later

See Trusted Communication to the Imprivata Appliance

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:

  • deviceSdkClearData

  • deviceSdkClearData

  • deviceSdkForceStop

See Configure Zebra SDK Based App Logout

ConfigFlags String deviceSdkClearData Use the Zebra SDK for clearing data based on the SDK.

See Configure Zebra SDK Based App Logout

ConfigFlags String deviceSdkClearData Use the Zebra SDK for clearing cache based on the SDK

See Configure Zebra SDK Based App Logout

ConfigFlags String deviceSdkForceStop Use the Zebra SDK to force stop based on the SDK.

See Configure Zebra SDK Based App Logout

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.

See Prevent Accidental Typing.

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.

See Configure Multiple Mobile Policies via MDM

ConfigFlags String com.package.name:forceStop|
clearCache|clearData
Run additional logout actions or different logout methods for the same app.

See Configure App Logout Actions

ConfigFlags String allowScreensaver Allows Imprivata MDA to coexist with device screensavers and not block their use.

See Configure Imprivata MDA for Screensaver Tolerance

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
  • {{SerialNumber}} - Microsoft Intune

  • {DeviceSerialNumber} - Omnissa Workspace ONE

  • %SERIALNUM% - Soti

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:

  • $AndroidVersion

  • $AndroidShortVersion

  • $DeviceName

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