You can configure settings for your Boxer deployment using the Configuration Key and Configuration Value pairs provided by AirWatch.

To configure these settings, enter the configuration key and the corresponding value into the Application Configuration setting during the app assignment.

Important:

If Boxer is already installed on end-user device, it might take few minutes for Boxer to download the new profile settings.

Sync Period

Add this key value pair to configure the maximum number of past days of mail and calender to sync in the Boxer app. This setting allows you to hide the No Limit feature available in the Boxer app settings.

Configuration Key Value Type Configuration Value Description
PolicyEmailMaxSyncPeriod Integer

0 - sync all

1 - 1 day

2 - 3 days

3 - 1 week

4 - 2 weeks

5 - 1 month

Enter the number of days of past mail to sync.
PolicyCalendarMaxSyncPeriod Integer

0 - sync all

4 - 2 weeks

5 - 1 month

6 - 3 months

7 - 6 months

Enter the number of days of past calendar events to sync.
Note:

Set the key value pairs to block syncing of all old emails and calendar until new emails or calendar events are synced first. Removing 0 from the key values disables the No Limit option for PolicyEmailMaxSyncPeriod and PolicyCalendarMaxSyncPeriod.

(iOS only) Allow Print

Configuration Key Value Type Configuration Value Description
PolicyAllowPrint Boolean

True - enabled

False - disabled

Set to False to disable printing of emails and attachments from Boxer.

(Android Only) Limit Notification

Configuration Key Value Type Configuration Value Description
PolicyLimitNotificationText Integer

0 - Displays Sender, Subject, and Body Preview (Default)

1- Displays Sender and Subject

2 - Displays Sender

3 - Generic notification (You've got a new email)

4 - No notification

Set configuration value to limit what is displayed in Boxer notification.

(iOS only) Allow Local Contacts

Add this key to define the policy for local contacts in Boxer.

Configuration Key Value Type Configuration Value Description
PolicyAllowLocalContacts Boolean

True - enabled

False - disabled

Set to True to enable local contacts in Boxer. If disabled, the Local Contacts option in Boxer is unavailable to the end users.

 

(iOS only) Allow Local Calendars

Add this key to define the policy for local calendars in Boxer.

Configuration Key Value Type Configuration Value Description
PolicyAllowLocalCalendars Boolean

True - enabled

False - disabled

Set to True to enable local calendars in Boxer. If disabled, the Local Contacts option in Boxer is unavailable to the end users.

(iOS only) Default Swipe Actions

Add this key to define the default swipe actions in Boxer.

Configuration Key Value Type Configuration Value Description
AppSwipesLeftShortDefault Integer

1 = actions grid

2 = archive

3 = delete

4 = move

5 = flag

6 = quick reply

7 = read or unread

8 = spam

Define the default swipe actions. User can customize swipe actions using the options provided in the Boxer app.

AppSwipesLeftLongDefault
AppSwipesRightShortDefault
AppSwipesRightLongDefault

(iOS only) Default Avatar Policy

Add this key to define the default policy for avatars in Boxer.

True - enabled

False - disabled

Set to True to enable avatars by default. User can change the Avatar setting using the options provided in the Boxer app.

(iOS only) Allow Custom Keyboards

Add this key to define the policy for allowing third-party keyboards with Boxer.

Configuration Key Value Type Configuration Value Description

True - enable (default value for managed device)

False - disable (default value for unmanaged device)

Set to True to permit users to activate third-party keyboards within Boxer.

 

Export Contacts by Default

Add this key to enable or disable exporting of contacts by default.

Configuration Key Value Type Configuration Value Description
AppDefaultCallerID Boolean

True - enabled

False - disabled

Set to true to enable the exporting of contacts by default. This setting requires the Caller ID option in the AirWatch Console to be set as Unrestricted.

Allow Caller ID (Export Contacts for iOS)

Add this key to enable or disable Export Contacts option in Boxer for end users.

Configuration Key Value Type Configuration Value Description
PolicyAllowCallerID Boolean

True - enabled

False - disabled

Set to true to enable the exporting of contacts by the end users. This setting requires the AppDefaultCallerID configuration value set to 'enabled'.

If disabled, the Export Contacts option in Boxer is unavailable for the end users.

Allow Archive

Add this key to enable or disable Archive action in Boxer for end users.

Configuration Key Value Type Configuration Value Description
PolicyAllowActionArchive Boolean

True - enabled

False - disabled

Set to true to enable archive action by the end users.

If disabled, the Archive option in Boxer is unavailable for the end users.

Allow Spam

Add this key to enable or disable Spam action in Boxer for end users.

Configuration Key Value Type Configuration Value Description
PolicyAllowActionSpam Boolean

True - enabled

False - disabled

Set to true to enable spam action by the end users.

If disabled, the Spam option in Boxer is unavailable for the end users.

Restricting Third-Party Attachments

Add this key to restrict the device user from attaching files to emails from multiple third-party sources.

Configuration Key Value Type Configuration Value Description
PolicyAllowDocProviders Boolean

True - enable

False - disable

Enables or disables attachments from external providers (iCloud, Dropbox, Google Drive, etc.) within Boxer.
PolicyAllowOpenIn Integer

0 - not allowed

1 - allowed

Enables or disables attaching of files from other apps using open-in or share into Boxer. When open-in or sharing of attachments are disabled, the message 'Your administrator has restricted attachments from external applications' is displayed.
(iOS Only) PolicyAllowPhotoAttachment Boolean

True - enable

False - disable

Enables or disables attaching of images and media files from photo gallery and camera.

S/MIME

Use this key value pairs to configure S/MIME support.

Configuration Key Value Type Configuration Value Description
PolicySMIME Integer

0 - disabled (default)

1- allowed

2 - required

Changes the status of S/MIME support.
PolicySMIMEEnableRevocationCheck Integer

0 - disabled

1- enabled

Enable or disable Online Certificate Status Protocol (OCSP).
PolicySMIMERevocationCheckUrl String

Supported format:

http://ocsp.acme.us/

ocsp:88

Configure the Revocation check URL.
PolicySMIMERevocationCheckType Integer

0 - check entire chain

1 - check only user certificate

Configure the revocation check type.
PolicySMIMERevocationUseAIA Integer

0 - disabled (don't use URL configured inside certificate for revocation status, use PolicySMIMERevocationCheckUrl only)

1 - enabled (use URL configured inside certificate for revocation status check, fall back to PolicySMIMERevocationCheckUrl if it is unavailable)

2 - required (only use URL configured inside certificate to check for revocation status, ignore PolicySMIMERevocationCheckUrl)

Define the revocation usage policy.
PolicySMIMERevocationEnforceNonce Integer

0 - disabled (enforce nonce)

1 - enabled (do not use nonce)

Define the nonce usage policy.
PolicySMIMERevocationTTL Integer 7- Default value Define the amount of time to retain the revocation data.
PolicySMIMETrustStore Integer

0 - Device Trust Store (default)

1 - Boxer Trust Store

Define the Trust Store.
PolicyRefetchEmptyLinksUsingMime Boolean True - Use MIME to fetch bodies For emails (fetched using HTML) that contain non-standard URL schemes, pointing to non-server domains, Exchange replaces the URL with two empty spaces. Enable the PolicyRefetchEmptyLinksUsingMime for the Boxer to detect this occurrence and re-download the affected body using MIME, which is not subject to the URL replacement error.

Modern Authentication

Add this key value pair to enable modern authentication for Office 365 accounts.

Configuration Key Value Type Configuration Value Description
AccountUseOauth Boolean

True - enable

False - disable

Enables or disables modern authentication for Office 365 accounts. When enabled, during enrollment, users are redirected to the login page for entering email password.

Downloading Attachments

Add this key value pair to enable or disable downloading of attachments.

Configuration Key Value Type Configuration Value Description
PolicyAllowAttachments Boolean

True - enable

False - disable

Enables or disables downloading of attachments.

Activate SSO

If SSO is enabled in the Security Policies, enable Application uses AirWatch SDK and assign the following application configuration keys and values to add SSO functionality for Boxer. For using SSO functionality in Boxer (iOS and Android) , you must have AirWatch Console version 9.0.5 or above.

Configuration Key Value Type Configuration Value Description
AppForceActivateSSO Boolean

True - enable

False - disable

Enables or disables SSO for Boxer.

Browser Exception List

You can use the AppDefaultBrowserExceptions key to create exception lists for hyperlinks when hyperlinks are Restricted or Unrestricted in the AirWatch Console.

You can configure the key value pairs to support the following functionalities:

  • If hyperlinks are restricted in the AirWatch Console, all links open in VMware Browser
  • If hyperlinks are restricted, but has an exception list, all available browsers are displayed but only links in the exception list opens in the default browser
  • If hyperlinks are unrestricted in the AirWatch Console, all available browsers are displayed and all links open in the default browser
  • If hyperlinks are unrestricted in the AirWatch Console, but has an exception list, all available browsers are displayed and the links in the exception list only opens in VMware Browser
Configuration Key Value Type Configuration Value Description
AppDefaultBrowserExceptions String

AppDefaultBrowserExceptions = ["*.acme.com", "acme*.acme1.com", "source.acme.com", "acme.com"]

Create exception list to restrict and unrestrict specific links from opening in the default browser.

Security Classifications

Enable Email Classification Marking to assign security classifications to the emails sent from Boxer. Assign the following application configuration keys and values to enable Email Classification Marking feature:

Configuration Key Value Type Configuration Value Description
PolicyClassMarkingsEnabled Integer

0 - disable

1 - enable

Enables or disables classification markings.

PolicyClassMarkingsXHeader

String x-header-name (Optional) Enables and defines x-header for classification.
PolicyClassVersion String

1.0

Version number for classification feature.
PolicyClassMarkingsRankEnabled Integer

0 - disable

1 - enable

(Optional) Enables hierarchical classification ranking.
PolicyClassMarkingsDefaultClass String Confidential, Restricted, Protected, or Secret (Optional) Set the default classification for emails. The value must match a display name from an entry in PolicyClassMarkings configuration value.
PolicyClassMarkings String PolicyClassMarkings Configuration Value Defines the hierarchical list of classifications.

PolicyClassMarkings Configuration Value

PolicyClassMarkings = [{
                  "Rank": 4,
                  "DisplayName": "Secret",
                  "Description": "This is secret...",
                  "Subject": "(Secret)",
                  "TopBody": "Classification: Secret",
                  "BottomBody": "Classification: Secret",
                  "XHeader": "Secret"
                  }, {
                  "Rank": 3,
                  "DisplayName": "Restricted",
                  "Description": "This is restricted...",
                  "Subject": "(Restricted)",
                  "TopBody": "Classification: Restricted",
                  "BottomBody": "",
                  "XHeader": "Restricted"
                  }, {
                  "Rank": 2,
                  "DisplayName": "Protected",
                  "Description": "This is protected...",
                  "Subject": "[Sec=Protected]",
                  "TopBody": "",
                  "BottomBody": "Classification: Protected",
                  "XHeader": "Protected"
                  }, {
                  "Rank": 1,
                  "DisplayName": "Confidential",
                  "Description": "This is confidential...",
                  "Subject": "(Confidential)",
                  "TopBody": "Classification: Confidential",
                  "BottomBody": "Classification: Confidential",
                  "XHeader": "Confidential"
                  }]