- Integrating Exchange Server or IBM Notes Traveler Server
- S/MIME for WorxMail
- Push Notifications for WorxMail for iOS
- Testing and Troubleshooting WorxMail
WorxMail for iOS can receive notifications about email and calendar activity when the app is running in the background or is closed. WorxMail supports notifications provided through the iOS background app refresh functionality or push notifications provided through the Apple Push Notification service (APNs).
By default, WorxMail uses the background app refresh method, which does not require any configuration yet can have significant delays in syncing. To provide users with real-time push notifications when WorxMail is in the background, configure WorxMail as described in this article.
WorxMail sends push notifications for the following Inbox activities:
The WorxMail icon shows the total count of unread and new messages in the Exchange Inbox folder only. WorxMail updates the icon after users read emails on a desktop or laptop computer.
The WorxMail drawer still provides the count of unread Inbox emails in Worx for the sync period. If the Control locked screen notifications policy is On, push notifications appear on a locked device screen after iOS wakes up WorxMail to perform a sync.
During an installation or upgrade, WorxMail prompts users to allow push notifications. Users can also allow push notifications later by using iOS Settings.
To provide push notifications, Citrix hosts a listener service on Amazon Web Services (AWS) to perform the following functions:
No personally identifiable information is stored by the Citrix service. Instead, a device token and subscription ID identifies the specific device and Inbox folder to be updated within WorxMail.
The Citrix listener service does not impact mail data traffic, which continues to flow between user devices and Exchange Servers through ActiveSync. The listener service, which is configured for high availability and disaster recovery, is available in three regions: Americas, Europe, Middle East and Africa (EMEA), and Asia Pacific (APAC).
For details about the EWS push notification service, see the Microsoft article Notification subscriptions, mailbox events, and EWS in Exchange.
Note: Push notifications are not currently supported for IBM Notes.
Exchange Server configuration:
For details, see the blog post http://www.butsch.ch/post/Exchange-20XX-Client-Certificate-und-IIS-ActiveSync-uploadReadAheadSize.aspx. Be aware that the serverRuntime element in IIS 7.0 replaced some IIS 6.0 metabase properties, including UploadReadAheadSize. For details, see Server Runtime in the IIS reference.
NetScaler Gateway configuration:
Provisioning profiles and app IDs:
XenMobile Management Tools for APNs signature signing is compatible with these browsers:
Be aware that the type of app ID previously used for WorxMail affects whether users can upgrade WorxMail or must reinstall the app, as shown in the following table.
|App ID on deployed version of WorxMail||Upgrades from WorxMail 10.0.x to 10.0.7 are supported?||Required user action|
|Explicit app ID, with a provisioning profile created with an explicit app ID||Yes||Users can upgrade to WorxMail 10.0.7.|
|Wildcard app ID, with a provisioning profile created with a wildcard app ID||No
APNs does not support wildcard IDs, so you must use a new explicit app ID.
|Users must perform a fresh install of WorxMail 10.0.7.|
Follow these steps to configure WorxMail for push notifications:
WorxMail requires an APNs certificate to support push notifications. This cannot be the same APNs certificate uploaded to the XenMobile server.
To obtain and upload an APNs certificate:
You can return to the Dashboard view to view details, obtain your customer ID, or delete certificates.
Background Network Services
If you disable split tunneling on NetScaler Gateway, add a Citrix push registration server FQDN to this policy in order to enable WorxMail to sync properly. These values are appended to the values in the policy. The values are comma-separated with no spaces. Depending on the push notifications region selected, the server to be added is as follows:
8. If your previously deployed WorxMail had a wildcard app ID, let your users know that they must reinstall WorxMail.
For more details about push notifications, see FAQ: WorxMail APNS for IT Admins. A Citrix customer login is required to view that content. Also see the blog post A Step-by-Step Guide to Configuring WorxMail APNS.
For details on how to update an expired certificate, please see Update Apple Push Services Certificate for WorxMail.
To troubleshoot outbound connections, check the Exchange event logs, which include log entries when a subscription request or the notification for a subscription is invalid or fails. You can also run Wireshark traces on the Exchange Server to track outbound traffic to the Citrix listener service.