Product Documentation

Notifications

Mar 06, 2015
You can use notifications in XenMobile for the following purposes:
  • To communicate with select groups of users for a number of system-related functions. You can also target these notifications for certain users; for example, all users with iOS devices, users whose devices are out of compliance, users with employee-owned devices, and so on.
  • To enroll users and their devices.
  • To automatically notify users (using automated actions) when certain conditions are met, such as when a user's device is about to be blocked from the corporate domain because of a compliance issue, or when a device has been jailbroken or rooted. For details on automated actions, see Automated Actions.

To send notifications with XenMobile, you must configure a gateway and a notification server. You can set up a notification server in XenMobile to configure Simple Mail Transfer Protocol (SMTP) and Short Message Service (SMS) gateway servers to send email and text (SMS) notifications to users. You can use notifications to send messages over two different channels: SMTP or SMS.

  • SMTP is a connection-oriented, text-based protocol in which a mail sender communicates with a mail receiver by issuing command strings and supplying necessary data, typically over a Transmission Control Protocol (TCP) connection. SMTP sessions consist of commands originated by a SMTP client (the person sending the message) and corresponding responses from the SMTP server.
  • SMS is a text messaging service component of phone, Web, or mobile communication systems. It uses standardized communications protocols to enable fixed line or mobile phone devices to exchange short text messages.

You can also set up a Carrier SMS Gateway in XenMobile to configure notifications that are sent through a carrier's SMS gateway. Carriers use SMS gateways to send or receive SMS transmissions to or from a telecommunications network. These text-based messages use standardized communications protocols to allow fixed line or mobile phone devices to exchange short text messages.

The procedures in this topic discuss adding a SMTP server, an SMS gateway, and a carrier SMS gateway.

To configure a SMTP server and SMS gateway

Prerequisites:

  • Before configuring the SMS gateway, consult your system administrator to determine the server information. It's important to know if the SMS server is hosted on an internal corporate server, or if the server is part of a hosted email service, in which case you will need information from the service provider's web site.
  • You must configure the SMTP notifications server to send messages to users. If the server is hosted on an internal server, contact your system administrator for configuration information. If the server is a hosted email service, locate the appropriate configuration information on the service provider's website.
  • Only one SMTP server and only one SMS server is active at a time.
  • Port 25 must be opened from XenMobile located in your network's DMZ to point back to the SMTP server on your internal network for notifications to be sent successfully.
  1. In the XenMobile web console, click Configure > Settings > More > Notification Server.

    The Notification Server configuration page appears.



  2. Click Add, click SMTP Server or SMS Gateway and then follow the procedures for each choice in the subsequent steps.
    • To add an SMTP server, follow steps 3 through 6.
    • To add an SMS gateway, follow steps 7 through 9.
  3. If you click to add an SMTP server, the Add SMTP Server page appears.



  4. Configure the following settings:
    • Name: Type the name associated with this SMTP server account.
    • Description: Optionally, enter a description of the server.
    • SMTP Server: Type the host name for the server. The host name may be a fully qualified domain name (FQDN) or an IP address.
    • Secure channel protocol: In the list, click the appropriate secure channel protocol used by the server (if the server is configured to use secure authentication): SSL, TLS, or None. By default, this field is set to None.
    • SMTP server port: Type the port used by the SMTP server. By default, the port is set to 25; if SMTP connections use the SSL secure channel protocol, the port is set to 465.
    • Authentication: Select ON or OFF. By default, this feature is disabled.
    • Microsoft Secure Password Authentication (SPA): If the SMTP server is using the SPA, click ON. By default, this feature is disabled.
    • From Name: Type the name displayed in the From box when a client receives a notification email from this server. For example, Corporate IT.
    • From email: Type the email address used if an email recipient replies to the notification sent by the SMTP server.
    • Test Configuration: Click to send a test email notification.
  5. Expand Advanced Settings and then configure the following settings:
    • Number of SMTP retries: Type the number of times to retry a failed message sent from the SMTP server. By default, this field is set to 5.
    • SMTP Timeout: Type the duration to wait (in seconds) when sending a SMTP request. Increase this value if message sending is continuously failing because of timeouts. Use caution when decreasing this value; it could increase the number of timed out and undelivered messages. By default, this field is set to 30 seconds.
    • Maximum number of SMTP recipients: Type the maximum number of recipients per email message sent by the SMTP server. By default, this value is set to 100.
  6. After configuring the SMTP server, click Add.
  7. On Notification Server configuration page, to configure an SMS gateway, click Add and then click SMS Gateway.

    The Add SMS Gateway page appears.

    Note: XenMobile only supports Nexmo SMS messaging. If you do not already have an account to use Nexmo messaging, visit their website to create one.
  8. Configure the following settings:
    • Name: Identify the SMS Gateway configuration.
    • Description: Optionally, enter a description of the configuration.
    • Key: Type the numerical identifier provided by the system administrator when activating the account.
    • Secret: Type a secret provided by the system administrator that is used to access your account in the event that a password is lost or stolen.
    • Virtual Phone Number: This field is used when sending to North American phone numbers (with the +1 prefix). You must enter a Nexmo virtual phone number; otherwise, enter a meaningful label or name. You can purchase virtual phone numbers on the Nexmo website.
    • HTTPS: Select this option if you want to use HTTPS to transmit SMS requests to Nexmo.
    • Country Code: In the list, click the default SMS country code prefix for recipients in your organization. This field always starts with a + symbol.
    • Test Configuration: Click to send a test message using the current configuration. Connection errors are detected and appear immediately, such as authentication or virtual phone number errors. Messages are received in the same time frame as messages sent between mobile phones.
  9. Click Add.

To add a Carrier SMS Gateway

You can set up a Carrier SMS Gateway in XenMobile to configure notifications that are sent through a carrier's SMS gateway. Carriers use Short Message Service (SMS) gateways to send or receive SMS transmissions to or from a telecommunications network. These text-based messages use standardized communications protocols to allow fixed line or mobile phone devices to exchange short text messages.

  1. In the XenMobile web console, click Configure > Settings > More > Carrier SMS Gateway. The Carrier SMS Gateway configuration page opens.



  2. Click Add to add a new carrier. Click Detect to automatically discover a gateway. The Add a Carrier SMS Gateway dialog box appears.



  3. Type the following information: XenMobile only supports Nexmo SMS messaging. If you do not already have an account to use Nexmo messaging, visit their website to create one.
    1. Carrier: Type the name of the carrier.
    2. Gateway SMTP domain: Type the domain associated with the SMTP gateway.
    3. Country code: In the list, click the country code for the carrier.
    4. Email sending prefix: Optionally, specify an email sending prefix.