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

PolicyAllowPrint

Configuration Key Value Type Configuration Value Description
PolicyAllowPrint (iOS only) Boolean

True - enabled

False - disabled

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

Caller ID

Add this key to enable or disable Caller ID option on the device.

Configuration Key Value Type Configuration Value Description
AppDefaultCallerID Boolean

True - enabled

False - disabled

Set to False to disable the device Caller ID option. This setting requires the Caller ID option in the AirWatch Console to be set as Unrestricted.

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 pair to enable S/MIME support.

Configuration Key Value Type Configuration Value Description
PolicySMIME Boolean

True - enable

False - disable

Enables or disables S/MIME support.

(Android Only) 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"
                  }]