Enable notifications from iObeya Mobile Application

Note

The notifications from iObeya Mobile Application need to be enabled only for On-Prem platforms.

Introduction

iObeya relies on the Firebase Cloud Messaging service to send push notifications to the iObeya mobile iOS and Android applications.

In addition to the privacy and security provided by Firebase (https://firebase.google.com/support/privacy), iObeya implements an end-to-end encryption of the notifications data between the iObeya server and mobile applications.

If you choose not to configure Firebase in your iObeya server to avoid usage of an external service, iObeya mobile applications will be fully functional with the exception of the push notifications (notifications will still be accessible in the Notification Center inside the iObeya mobile application).

Setup the Firebase key file

To allow the server to send notifications from iObeya Mobile Application:

  1. Contact support@iobeya.com to get the configuration file.

  2. Make sure the file ROOT.xml of iObeya is updated. It is the file iobeya.xml renamed as ROOT.xml.

    Note

    It must contain the property pluginsPropertiesDirectory: pluginsPropertiesDirectory=”<path_to_plugins_properties_directory>”

  3. Copy the file iobeya-mobile-app.json in the plugins properties directory.

  4. Reboot the server

Firewall configuration

To allow the iObeya server to send and the iObeya mobile applications to receive push notifications, your Firewall needs to allow traffic to and from the following ports:

  • 5228
  • 5229
  • 5230
  • 443

For outgoing connections, Firebase Cloud Messaging recommends no IP restrictions, if you must have an IP restriction, the IP addresses to whitelist are available in the following list: https://www.gstatic.com/ipranges/goog.json

For more information, please refer to the FCM documentation: https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall