Configuring [email protected] using Key-Value Pairs (Android)

Certain features in [email protected] for Android can be configured by applying Key-Value Pairs (KVPs) in Custom Configurations field in app configuration on Core. The following table lists the features that are configurable using KVPs:

 

Key

Value

Purpose

Increase logging level

vlog_level

1

Once set verbose and debug levels of logging are enabled.

When enabled, "setting native verbose logging level to 1" line should be shown in logs on [email protected] start.

Access to device camera

enable_camera_capture

TRUE

Allows [email protected] to ask for access to device camera.

Access is granted only after user confirms the proper dialog.

Product name in User Agent string

browser_product_name

MISecureBrowser

Applied KVP replaces 'MobileIron' word with 'MISecureBrowser' in User Agent string.

It allows tablet devices not to be perplexed with 'mobile' word and to display tablet mode.

"Request desktop site" option

allow_desktop_mode

TRUE

Enables "Request desktop site" option in [email protected] overflow menu.

Configure user certificates

IdCertificate_1

certificate name

Sets the certificate to be used for authentication. There can be any number in the key - it is used to bind with IdCertificate_x_host

IdCertificate_1_host

certificate host

Sets the host for authentication with the user certificate

Enable password auto-fill option for sites with both form-based and HTTP-based type of authentication

allow_password_autofill

true

yes

Users successfully logged into site with HTTP/form authentication will be suggested to save password for auto-filling (if the site allows it).

false

no

Users successfully logged into site with HTTP/form authentication will NOT be suggested to save password for auto-filling (even if the site allows it).

Enable forms auto-fill option

allow_form_autofill

true

yes

Values submitted in forms will be suggested in auto-complete list next time users fill this form in.

false

no

Values submitted in forms will not be suggested in auto-complete list next time users fill this form in.

Set expiration time for autofill option

password_autofill_expire

 

Saved passwords will be available for autofill for the mentioned time in hours.

For example, "1", "2h", " 3H ", and so on.

Configure custom home page

home_page

https://url.url/

URL set for home_page will be loaded in each new tab.

Sett white-list and blacklist URL filtering rules

 

 

 "URL_filter_1","URL_filter_2"

URL to which filtering rules are applied will be blocked when accessed.

 

 "URL_filter_1","URL_filter_2"

URL to which filtering rules are applied will be considered as exceptions from blacklist and will be allowed to access.

Configure custom blacklist warning message   

blacklist_warning_message

Warning message text.

Standard blacklist warning message will be changed to a custom one.

Enable "Logout" button

enable_logout_button

true

false

Enables "Logout" button in Settings menu.

Ignore warnings for all sites with untrusted ssl

trust_all_certificates

 

true

yes

 

Users will NOT be prompted with warnings when navigating to sites with untrusted ssl.

false

no

Users will be prompted with warnings when navigating to sites with untrusted ssl, as usual.

Ignore warnings for specific sites with untrusted ssl

trust_certificates_list

 

SHA1:XX:XX...XX,SHA256:XX:XX...XX

Users will not  be prompted with warnings when navigating to specified sites with untrusted ssl.

Support for URI with custom schemes

custom_url_scheme

url_sheme_1

url_scheme_2

URIs with specified custom schemes will be treated as URIs in valid format instead of being used as a search request in google search.

Set MixPanel analytics collection ON/OFF

allow_analytics

true

false

 

Administrators can enable or disable analytics collection depending on set value. To disable Mixpanel, enter the following:

Key: allow_analytics

Value: false

Note: Mixpanel is enabled by default if the key-value pair is not configured.

Disable Search Engine

 

true

false

When search engine is disabled, [email protected] will treat the terms in the URL navigation bar as web addresses to be resolved.

Note: By default, search engine is enabled.

Clear cache, browsing history, and other user data

clear_user_data_after_duration_in_minutes

15-10080 minutes

You can delete sensitive user data after a defined time period. You can set the value using the clear_user_data_after_duration_in_minutes key in the admin portal.

This feature is disabled by default.

 

Data is cleared in background when a device locked and time expires.

When the app is ready to delete the data in the foreground mode (timer expires) then the app is sent to background. It waits for 60 seconds before deleting the data in the background mode.