Configure the ENS2 with the application configuration values. You can configure settings for the ENS2 using the configuration key and configuration value provided by the Workspace ONE UEM.

ENS2 Application Configuration for Workspace ONE UEM Console Version 2003 or Lower

The following screenshot displays the ENS2 configuration keys and value types applicable for Workspace ONE UEM console version 2003 or lower.

The following table lists the application configuration keys and the configuration values for ENS2 that are applicable for Workspace ONE UEM console version 2003 or lower.

Configuration Key Value Type Configuration Value Description
ENSLinkAddress String

Supported format:

https://ens.getboxer.com/api/ens

Replace ens.getboxer.com with the resolved name or IP provided by VMware based on your region.

Sample link address:

  • For AMER - https://ens.getboxer.com/api/ens
  • For APAC - https://ens-apj.getboxer.com/api/ens
  • For EMEA - https://ens-eu.getboxer.com/api/ens
  • For UK - https://ens-uk.getboxer.com/api/ens

The URL address of the ENS server. Provide the address for the ENS2 system for your users to connect.

For Cloud customers, the address must be https://ens.getboxer.com/api/ens (or any of the ENS Cloud URLs or API endpoints).

For on-premises users, the address must be in the following format: https://mycompany.com/MailNotificationService/api/ens. Here, mycompany.com is the IP or domain name of your ENS server.

ENSAPIToken String Sample API token - da848cc9340034843ecdjdad11048461q VMware provides the API token to activate the ENS service. For the on-premises installation, the on-premises installer creates this token.
AccountNotifyPush Boolean

False - disable (default)

True - enable

Enables ENS for the account.
EWSUrl String

Supported Format:

https://[external_email_server_domain]/EWS/Exchange.asmx

Sample EWS URL:

  • https://e.mail.com/EWS/Exchange.asmx
  • https://seg.dom.com/EWS/Exchange.asmx
Enables manual configuration of Exchange Web Services (EWS) endpoint when the autodiscovery is disabled in your Exchange environment.
PolicyLimitNotificationText Integer

0 - sets notification to sender, subject, and preview.

1 - sets notification to sender and subject (default).

2 - sets notification to sender.

3 - sets notification to a generic message (new message).

4 - sets notification to none (only the badge is updated).

To configure the ENS notification policy for Workspace ONE Boxer, add the following key value pair. When configured, Workspace ONE Boxer immediately resubscribes to the ENSv2 and notification policy is updated as per the set key value.

ENS2 Application Configuration for Workspace ONE UEM Console Versions 2004, 2005, 2006, and 2007

The following screenshot displays the ENS2 configuration in the Boxer app assignment page for Workspace ONE UEM console versions 2004, 2005, 2006, and 2007.

The following table describes the ENS2 configuration options that are applicable for Workspace ONE UEM console versions 2004, 2005, 2006, and 2007.

Settings Description
ENS2 Server Address The URL address of the ENS2 server.

For Cloud ENS users, the address must be in the https://ens.getboxer.com/api/ens format. See the ENS Endpoints and IP Allowlist section in the Configure Email Notification Service for Cloud Deployment topic for a list of supported cloud ENS2 geo-specific endpoint.

For on-premises users, the address must be in the https://mycompany.com/MailNotificationService/api/ens format. Here, the mycompany.com is the IP or domain name of your ENS2 the on-premises server.

ENS2 API token VMware provides the API token to activate the ENS service. For the ENS2 on-premises installation, the installer generates the ENS2 API token.

Sample API token - da848cc9340034843ecdjdad11048461q

ENS2 (Enable – Disable toggle) Enables or disables ENS2 in Workspace ONE Boxer.
EWS URL Enables manual configuration of the Exchange Web Services (EWS) endpoint when autodiscovery is disabled in your email environment.

Supported format: https://[external_email_server_domain]/EWS/Exchange.asmx

Sample EWS URLs:

  • https://e.mail.com/EWS/Exchange.asmx
  • https://seg.dom.com/EWS/Exchange.asmx
  • https://outlook.office365.com/EWS/Exchange.asmx
Notification Content Configure the information to be displayed in each incoming mail notification alert.

ENS2 Application Configuration for Workspace ONE UEM Console Versions 2008, 2010, and 2011

The following screenshot displays the ENS2 configuration in the Boxer app assignment page for Workspace ONE UEM console versions 2008, 2010, and 2011.

The following table describes the ENS2 configuration options that are applicable for Workspace ONE UEM console versions 2008, 2010, and 2011.

Settings Description
ENS2

(Enable – Disable toggle)

Enables or disables ENS2 in Workspace ONE Boxer.
ENS2 Server Address The URL address of the ENS2 server.

For Cloud ENS users, the address must be in the https://ens.getboxer.com/api/ens format. See the ENS Endpoints and IP Allowlist section in the Configure Email Notification Service for Cloud Deployment topic for a list of supported cloud ENS2 geo-specific endpoint.

For on-premises users, the address must be in the https://mycompany.com/MailNotificationService/api/ens format. Here, the mycompany.com is the IP or domain name of your ENS2 the on-premises server.

ENS2 API token VMware provides the API token to activate the ENS service. For the ENS2 on-premises installation, the installer generates the ENS2 API token.

Sample API token - da848cc9340034843ecdjdad11048461q

Notification Content Configure the information to be displayed in each incoming mail notification alert.

The EWS URL configuration is optional, but it is recommended you configure the EWS URL. You can configure the EWS URL in the Email Settings page as shown in the following screenshot. For more information, see the Assign and Configure Workspace ONE Boxer Using the App Assignment Page section in the Workspace ONE Boxer Admin Guide.

The following table describes the EWS URL option.

Settings Description
EWS URL Enables manual configuration of the Exchange Web Services (EWS) endpoint when autodiscovery is disabled in your email environment.

Supported format: https://[external_email_server_domain]/EWS/Exchange.asmx

Sample EWS URLs:

  • https://e.mail.com/EWS/Exchange.asmx
  • https://seg.dom.com/EWS/Exchange.asmx
  • https://outlook.office365.com/EWS/Exchange.asmx

ENS2 Application Configuration for Workspace ONE UEM Console Version 2101 or Later

For specific customers with Workspace ONE UEM version 2101 and later, the following screenshot displays the ENS2 configuration in the Boxer app assignment page.

Note: For Workspace ONE UEM version 2105 or later, by default, for all the users, the following options appear in the Boxer app assignment page. For Workspace ONE UEM version 2101 or later and Workspace ONE UEM version 2102 or lower, by default, for all the users, the following options do not appear in the Boxer app assignment page. The displayed options are enabled only for specific customers. In case, you do not see the displayed options in the Email Settings screen, then switch to the Workspace ONE UEM 2011 or lower versions for ENS2 configuration although you might be using Workspace ONE UEM version 2101 or lower.

The following table describes the ENS2 configuration options that are applicable for Workspace ONE UEM console version 2101 or later.

Settings Description
ENS2

(Enable – Disable toggle)

Enables or disables ENS2 in Workspace ONE Boxer.
ENS2 Server Address The URL address of the ENS2 server.

For Cloud ENS users, the address must be in the https://ens.getboxer.com/api/ens format. See the ENS Endpoints and IP Allowlist section in the Configure Email Notification Service for Cloud Deployment topic for a list of supported cloud ENS2 geo-specific endpoint.

For on-premises users, the address must be in the https://mycompany.com/MailNotificationService/api/ens format. Here, the mycompany.com is the IP or domain name of your ENS2 the on-premises server.

After entering the URL, click Retrieve Token.

If Workspace ONE UEM console is successfully able to communicate with the cloud ENS2 Server referenced in the ENS2 Server Address field, then a successful API token generation and retrieval notification is seen.

If Workspace UEM console cannot successfully communicate and obtain the API token from the cloud ENS2 server, then you might see an error notification. The error might be due to the either of the following reasons. However, the reason for the error is not limited to the reasons listed below:
  • The URL entered might be incorrect. Check if the entered URL matches the actual ENS2 server URL and correct it.
  • You might be using an older version of the ENS which does not support this capability. You must update to the latest version of ENS2.
  • The ENS server might not be active. Check if the ENS2 alive endpoint is accessible at the URL: <ENS2 Server Address>/alive. The URL can be opened in a user's Web browser. For example, https://ens.getboxer.com/api/ens/alive.
  • The required network ports might not be open on the on-premises Workspace ONE UEM Console and/or the on-premises ENS2 server. Depending on the URL provided for the ENS2 server address, ensure that the HTTPS (443) is open for outbound on the on-premises UEM console and inbound on the on-premises ENS2 server. For the on-premises UEM console, you can check if the ENS2 alive endpoint is accessible from the Windows Server on which the UEM console is installed.
  • Due to temporary network issue the communication between UEM Console and the ENS might be impaired. In such scenarios, the issue might resolve automatically, or you can retry later. Refer the ENSv2 logs for more information on the errors. See the Integrated Services Logging and/or the Workspace ONE UEM console /API/MEM endpoint logs at Core Services Logging to check the exact cause of the issue.

For any further assistance, reach out to VMware Support.

Notification Content Configure the information to be displayed in each incoming mail notification alert.

The EWS URL configuration is optional, but it is recommended you configure the EWS URL. You can configure the EWS URL in the Email Settings page as shown in the following screenshot. For more information, see the Assign and Configure Workspace ONE Boxer Using the App Assignment Page section in the Workspace ONE Boxer Admin Guide.

The following table describes the EWS URL option.

Settings Description
EWS URL Enables manual configuration of the Exchange Web Services (EWS) endpoint when autodiscovery is disabled in your email environment.

Supported format: https://[external_email_server_domain]/EWS/Exchange.asmx

Sample EWS URLs:

  • https://e.mail.com/EWS/Exchange.asmx
  • https://seg.dom.com/EWS/Exchange.asmx
  • https://outlook.office365.com/EWS/Exchange.asmx