AppConfig Reference

The following tables provide a reference for AppConfig key/value pairs used to configure Imprivata MDA with Mobile Device Management (MDM) platforms.

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.

Required AppConfig Keys

These keys are required by Imprivata MDA.

AppConfig Configuration Key AppConfig Value Type

AppConfig Value

Description Notes
ServerIP String <Imprivata appliance address> The server address of the Imprivata appliance.

Depending on your MDM interface, this may appear as Server address or Enterprise Access Management server address.

OneSignServerCertificate String certificate

Upload the Imprivata appliance certificate to the MDM when deploying Imprivata MDA to a device.

Required only when using a self-signed certificate.

Depending on your MDM interface, may appear as OneSign server certificate.

ExternalDeviceSerial String
  • {{SerialNumber}} - Microsoft Intune

  • {DeviceSerialNumber} - Omnissa Workspace ONE

  • %SERIALNUM% - Soti

Depending on your MDM, represents the serial number of the device.

Imprivata MDA requires access to the device ID to report on individual login and device activity.
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

 

MamRegistrationMdmId String <ID> MAM registration MDM ID from the Mobile Access server.

Required for registering the Imprivata MDA app to the MDA console.

MamRegistrationMamServerAddress String <MAM server address>, typically groundctl.com. Mobile Access server address.

Required for registering the Imprivata MDA app to the MDA console.

MamRegistrationDeviceId String
  • {{SerialNumber}} - Microsoft Intune

  • {DeviceSerialNumber} - Omnissa Workspace ONE

  • %SERIALNUM% - Soti

Device identifier for registration to the MDA console.

Required for registering the Imprivata MDA app to the MDA console.

MamRegistrationSecret String <registration secret> Registration secret for registration to the MDA console. Required for registering the Imprivata MDA app to the MDA console.

Optional AppConfig Keys

These keys enable specific features or integrations when configured.

AppConfig Configuration Key AppConfig Value Type

AppConfig Value

Description Notes
DefaultAuthDomain String <yourDomain>

Set the domain selected by default when the user authenticates to Imprivata MDA with their username and password.

.

Depending on your MDM interface, this AppConfig may appear as:

The domain selected by default when authenticating on MDA with username and password.

See Configure a Default Domain.

AdminAccessCode String <The Admin passcode> Sets the passcode for admin access.

Depending on your MDM interface, this may appear as Admin Access Code.

Requires a minimum of 8 characters.

See Configure Admin Access Code.

LockMode String CountdownToLockMode Enables the Countdown to lock mode.  
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.

Depending on your MDM interface, this may appear as Device Info Pattern.

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

See Configure the Display of Device Information on Authentication Screens

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

LandscapeDevices String Comma-separated list of mobile device model numbers Change the mobile device's orientation from portrait to landscape mode.

Depending on your MDM interface, this may appear as Landscape devices.

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

See Configure Landscape Mode

Configuration Flags

These ConfigFlags enable specific behavior and functionality in the MDA mobile policies or for specific integrations.

AppConfig Configuration Key AppConfig Value Type

AppConfig Value

Description Notes
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 allowUntrustedEAMCertificate
  • Enabled by default in Imprivata MDA 7.15 and later.

    • Allows communication with an Imprivata appliance that contains any seIf-signed or expired or invalid certificate.

    • If allowUntrustedEAMCertificate is set, then forceTrustedEAMCertificate is ignored.

    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.

     

    See Trusted Communication to the Imprivata Appliance

    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 FIDO2 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 FIDO2 security keys, treatNfcTapAsProx enables proximity card-only mode.

    • If treatNfcTapAsProx is not set, FIDO2 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.

    ConfigFlag String ignoreCustomContentView

    Beginning with 10.1, Imprivata MDA draws Conent view UI on MDA Lock screen notifications by default.

    In previous releases, Imprivata MDA didn't show notification contents from Custom Content view if a notification had one, resulting in an empty notification shown over the Imprivata MDA Lock screen.
    The flag ignoreCustomContentView enables the previous MDA behavior of ignoring the Custom Content view set in notifications.

    Supported in Imprivata MDA 10.1 and later.


     

    ConfigFlag String msalLoginDomain

    Sets the domain name to use when building UPN formatted usernames for MSAL login that is enabled by the msalLoginOn flag.

    This flag is useful when the EAM user identity is configured with a different domain name than the Microsoft Entra ID domain name.

    Without the msalLoginOn flag setting msalLoginDomain has no effect.

    Supported in Imprivata MDA 10.1 and later.

    See Microsoft Apps Support

    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 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.

    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.

    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)