Keys for real-time and interval-based push notifications (Core and Cloud)

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.

Table 8.  Key-value pairs 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

  • basic
  • ntlm
  • cert_base
  • modern_auth

Defines the authentication method to the Exchange ActiveSync service.

  • basic: Select if you are using Basic authentication (user name and password)
  • ntlm: Select if you are using NTLM authentication
  • cert_base: Select if you are using identity certificates for authentication
  • modern-auth: Select to enable modern auth for corresponding protocol

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

  • basic
  • ntlm
  • cert_base
  • modern_auth

Defines the authentication method to the Exchange EWS service.

  • basic: EWS uses basic authentication (User name and password)
  • ntlm: EWS uses NTLM authentication
  • cert_base: EWS uses identity certificates for authentication
  • modern_auth: user authentication on first application launch or when token cannot be refreshed or renewed

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

  • true

  • false

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>

Core: Name of the SCEP setting in Core.

Cloud: Name of the Identity certificate configuration in Cloud

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:

notification_server_organization_id

notification_server_authorization

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.

Table 9.  Key-value pairs for push notifications (interval-based)

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.