Keys for real-time and interval-based push notifications (Ivanti EPMM and Ivanti Neurons for MDM)
Key-value pairs for real-time push notifications
The following keys are applicable to configuring real-time push notifications:
- notification_server_host
For real-time push notifications enter the following value: cns.mobileiron.com/PROD.
- allow_realtime_notifications
- email_ews_host
- eas_min_allowed_auth_mode
- ews_min_allowed_auth_mode
- notification_resubscription_interval
- allow_device_keychain
- subscription_valid_until
- sentry_server_host
- should_cache_tunneling_config
The following table describes the key-value pairs applicable for real-time push notifications.
Key | Value: Enter/Select one | Description |
|---|---|---|
allow_realtime_notifications | true | Enables real-time push notifications. |
notification_server_host | The URL of the notification server | The URL for the notification server for real-time push notifications is cns.mobileiron.com/PROD. Alternately, you can enter the following IP addresses: 13.56.49.23 34.253.2.239 Ivanti strongly recommends entering the URL for the notification server, as the IP addresses for the server might change. |
email_ews_host | Exchange server address for the EWS host | Explicitly sets the EWS host address for real-time push notifications, as opposed to the value configured for email_exchange_host. Enter the IP address or DNS of the EWS host. The DNS name must be in the following format: case2010.xyz.com. Do not prepend https or full path name. For Office 365, enter outlook.office365.com. This key-value pair is required if your Standalone Sentry is the email host, i.e. the email_exchange_host key points to the Standalone Sentry FQDN. |
eas_min_allowed_auth_mode |
| Defines the authentication method to the Exchange ActiveSync service.
If a key-value pair is not configured, the default authentication method is Basic. If you have configured ntlm or cert_base or modern_auth, and there are errors in your configuration, the authentication method defaults to basic. |
ews_min_allowed_auth_mode |
| Defines the authentication method to the Exchange EWS service.
If you have configured ntlm or cert_base or modern_auth, and there are errors in your configuration, the authentication method defaults to basic. Default value if no key-value is configured is basic. |
notification_resubscription_interval | A number | Optional. Sets the interval when Email+ resubscribes to receive real-time push notifications. The resubscription interval is in minutes. If a key-value pair is not configured, the default resubscription interval is 60 minutes. |
subscription_valid_until | The default value for "validUntil" is 1440 minutes | Sets the duration of the subscription. |
sentry_server_host | host name address | Installs Sentry, to support VIP notification. Once Sentry is installed, the "VIP Allowed After Work Hours" option is enabled. |
should_cache_tunneling_config |
| Use the should_cache_tunnelling_config key along with the allow_device_keychain. true key. The configuration is cached by AppConnect, as a result device user can view detailed push notifications and badge count (number of unread mails) after force closing the app. false key: The configuration is not cached. Default if key-value is not configured: false. |
Add the following key-value pairs if you are using an identity certificate for authentication | | |
email_exchange_username | $USERID$ | The user ID for the ActiveSync server. |
email_exchange_host | <exchange_real_address> | The fully qualified domain name of the ActiveSync server. |
email_trust_all_certificates | true | Email+ automatically accepts all certificates. |
email_login_certificate | <name of the identity certificate configuration> | Ivanti EPMM: Name of the SCEP setting in Ivanti EPMM. Ivanti Neurons for MDM: Name of the Identity certificate configuration in Ivanti Neurons for MDM |
email_ssl_required | true | Secures communication using https to the server that you specified in email_exchange_host. |
allow_logging | true | Email+ logs data to the device console, and allows the log file to be attached to a feedback email. |
email_device_id | $DEVICE_UUID_NO_DASHES$ | Identifies the device to the ActiveSync server. |
email_address | $EMAIL$ | Email address of the device user. |
feedback_email_address | An email address | Device user app feedback and log messages are sent to the email address. |
Add the following key-value pairs if your deployment includes Email+ versions 2.3.4 and less and the devices require interval-based push notifications:
For a description of the key-value pairs see Key-value pairs for push notifications (interval-based). Email+ versions 2.3.4 and less do not get real-time notifications. | | |
Key-value pairs for push notifications (interval-based)
The following keys are applicable to configuring push notifications:
- notification_server_host
For push notifications enter the following value: cns-na1.mobileiron.com/PROD.
- notification_server_organization_id
- notification_server_authorization
- notification_interval
- allow_device_keychain
The following table describes the key-value pairs applicable for interval-based push notifications.
Key | Value: Enter/Select one | Description |
|---|---|---|
notification_server_host | The URL of the notification server | The URL for the notification server for real-time push notifications is cns-na1.mobileiron.com/PROD. |
notification_interval | A number | The desired notification interval in seconds. The recommended interval is 15 minutes, or 900 seconds. The minimum interval is 5 minutes, or 300 seconds. This key is ignored if real-time push notifications is configured. Default value if no key-value is configured: 900 seconds. |
allow_device_keychain | true | Enables Email+ to fetch email in the background. |
notification_server_organization_id | ID provided by Ivanti | Organization ID provided by Ivanti. |
notification_server_authorization | Token provided by Ivanti | Token for the cloud notification service. |