IBM Support

Configuring Traveler notifications for iOS secure mail

How To


Summary

Instructions on how to configure iOS Traveler Notifications for the IBM Secure Mail Client.

Objective

In order to configure notifications for Traveler configured iOS devices, there are minor changes that need to happen. For starters, let's go into high level workflows:

  1. Traveler will see that an user receives a new email.
  2. Traveler will alert MaaS360 that a new email has been received
  3. MaaS360 will communicate with Apple APNS
  4. APNS will send back to MaaS360 a response
  5. MaaS360 will provide user information to APNS
  6. APNS will send down audible notification to the mobile device.

In order to accomplish the above, we need to point Traveler, via notes.ini configurations, to point to MaaS360 to send these notifications. Below are the steps needed to accomplish this integration:

  1. Navigate to MaaS360 admin console --> setup --> services. Once there, expand Secure Mail and enable Email Notification for iOS Device.
  2. Contact IBM MaaS360 support. MaaS360 will create a case which we will track accordingly.
  3. MaaS360 will generate a .p12 certificate that will grant Traveler communication access to MaaS360
  4. Once the .p12 certificate has been created, it will be supplied via the ticket.
  5. Once you receive the .p12, you can designate a location and copy the full path of that location. The location path must be local to the machine that has the notes.ini file.

Once you receive the .p12 certificate, you will need to make the below configurations in notes.ini

NTS_PUSH_ENABLE_APNS_MAAS360_PRODUCTION=true
NTS_PUSH_APNS_MAAS360_PRODUCTION_KEYSTORE=<Location of p12 certificate>
NTS_PUSH_APNS_MAAS360_PRODUCTION_KEYSTORE_PASSWORD=<password created for csr>
NTS_PUSH_APNS_MAAS360_PRODUCTION_SERVER=traveler-apns.maas360.com
NTS_PUSH_ALERTS_ALLOW_SUMMARY=true
NTS_PUSH_APNS_MAAS360_PRODUCTION_FEEDBACK_SERVER=traveler-apns.maas360.com
NTS_PUSH_ALERTS_TRUNCATION_APNS_BODY=1948
NTS_PUSH_ALERTS_VERSION_MAX=1
NTS_PUSH_APNS_MAAS360_PRODUCTION_SERVER_CONNECTIONS=15
NTS_PUSH_APNS_MAAS360_PRODUCTION_SERVER_PORT=2195
NTS_PUSH_APNS_MAAS360_PRODUCTION_FEEDBACK_INTERVAL=1440
NTS_PUSH_APNS_MAAS360_PRODUCTION_FEEDBACK_SERVER_PORT=2196
NTS_PUSH_APNS_MAAS360_PRODUCTION_MAX_RETRIES=3
******NOTE: In order for communication from Traveler to reach our servers, please make sure the following IP address and host URL's are allowlisted in your network:

Server URL Server IP Addresses
traveler-apns.maas360.com

OLD Washington: 173.193.219.244     New Washington: 169.55.90.28 (3 April 2024)

London: 159.8.170.232
Singapore: 119.81.207.132
 

Once the notes.ini has been configured properly, you will want to configure the workplace persona policy in MaaS360 admin console to allow notifications. Navigate to Security --> policies, and locate your workplace persona policy and hit "edit".

Under WorkPlace tab inside Services, make sure you enable Real-time Email Notifications

image-20190627143223-1

Once Real-time Email Notifications has been enabled, go to Email --> Configurations. You will see new configuration options here under Enable Real-time Notification. You will want to set this to Yes and allow notifications for all new email:
image-20190627143558-2

Once the policy has been configured, you are good to go! Next email you receive should also receive an audible notification.

Document Location

Worldwide

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYSXX","label":"IBM MaaS360"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Document Information

Modified date:
27 March 2024

UID

ibm10957603

Page Feedback