GCM for Android Setup Guide This guide provides information on...... Prerequisites for using Google Cloud Messaging service... Instructions for setting up GCM service via the Google API console... Configuring the GO!Enterprise MDM server for GCM service GO!Enterprise MDM - GCM for Android Setup Google Cloud Messaging for Android 3
Table of Contents Google Cloud Messaging for Android 5 Set up GCM 7 Step 1: Create a Google API Project... 7 Step 2: Enable GCM Service... 9 Step 3: Obtain the API Key from the Google API Website... 10 Configure the MDM Server for GCM Service 12 GO!Enterprise MDM - GCM for Android Setup Google Cloud Messaging for Android 4
Google Cloud Messaging for Android What Is GCM Google Cloud Messaging (GCM) for Android is a service that allows GO!Enterprise MDM to send push notifications from the server to the GO!Enterprise MDM Android device agent. How GCM Works GO!Enterprise MDM can use the Google Cloud Messaging service to let Android devices know that it is time to synchronize. Each device establishes an accredited and encrypted IP connection with the GCM service. Whenever notifications for the device are available, the GO!Enterprise MDM server connects with GCM servers. GCM then pings the device telling it to synchronize with GO!Enterprise MDM. This method of initiating synchronization is used in place of the GO!Enterprise MDM app s device connection schedule, eliminating delayed updates to the device. Using the service offers added functionality in the following ways: Security commands such as Full Wipe or Lock Device are applied immediately. Changes made to a policy suite or user settings are applied immediately. Android corporate resource assignments are applied immediately. Fewer resources are used than with direct push, since the connection is not persistent. Requirements GO!Enterprise MDM version 3.4.1 or later Port 5228-5230 (GCM does not provide specific IPs, so it frequently changes IPs. A Google Mail (Gmail) account (required for obtaining the GCM token and Sender ID) Prerequisites for Devices Devices must run Android 2.2 or higher. Certain 2.2.x devices will not register with GCM properly. In this case, the GO!Enterprise MDM device connection schedule handles the aspects of queuing of messages and delivery to the target Android app running on the device. Devices with an Android OS lower than 4.0.4 must have a Gmail account and have the Google Play Store application installed on the device. A Google account is not required on devices running Android OS 4.0.4 or higher. GO!Enterprise MDM - GCM for Android Setup Google Cloud Messaging for Android 5
An Overview of the Steps to Set Up GCM Service Only one GCM project is required per GO!Enterprise MDM system, regardless of the number of organizations hosted on the server. From the main page of the Google APIs Console: 1. Create a Google API project that will generate the GCM Sender ID. 2. Enable the GCM Service. 3. Obtain an API Key. On the GO!Enterprise MDM server: 4. Enter the GCM credentials and enable the service for each organization. GO!Enterprise MDM - GCM for Android Setup Google Cloud Messaging for Android 6
Set up GCM Step 1: Create a Google API Project Make sure you have a Gmail account before you begin. 1. Navigate to the Google Developers Console at https://cloud.google.com/console and sign in using your Google account credentials. 2. Create a new project by selecting Create an empty project or by clicking the Select a project dropdown and selecting Create a project. 3. In the New Project pop-up, do the following: a. Enter a name for the project in the Project name field. b. The project will be assigned a Project ID that mirrors the project name you have typed in, however, you can click Edit if you want to modify the project ID. c. Check the box to acknowledge that you agree to the Terms of Service. d. Click Create. GO!Enterprise MDM - GCM for Android Setup Set up GCM 7
e. An Activities pop-up will display while the project is being created. A green checkmark symbol indicates completion. f. The project now has a Project ID and a Project Number. The Project Number is located in parentheses after the Project ID. Make note of the Project Number. It is the Sender ID that you will need in order to configure the GO!Enterprise MDM server for GCM service. GO!Enterprise MDM - GCM for Android Setup Set up GCM 8
Step 2: Enable GCM Service 1. From the left panel of the main Google API Console page, select APIs & auth > APIs. 2. Select the Google Cloud Messaging for Android option. 3. Click Enable API. GO!Enterprise MDM - GCM for Android Setup Set up GCM 9
Step 3: Obtain the API Key from the Google API Website 1. Again, from the main Google API Console page, select APIs & auth > Credentials. 2. Click Add Credentials and select API Key. 3. On the Create a new key pop-up, select the Server key. 4. Click Create to create server API key. GO!Enterprise MDM - GCM for Android Setup Set up GCM 10
5. Make a note of the API key. You will need this along with the Sender ID created in Step 1 to configure the GO!Enterprise MDM server for GCM service. GO!Enterprise MDM - GCM for Android Setup Set up GCM 11
Configure the MDM Server for GCM Service The GCM service must be enabled for the system on the GO!Enterprise MDM server under System Settings. GCM credentials (Sender ID and API Key) are also entered here. Only one set of credentials is required per system, regardless of the number of organizations the system hosts. The GCM service can be turned or left off for each individual organization. Enter your GCM credentials and enable the GCM service for the system 1. From the GO!Enterprise MDM dashboard, select System > System Administration > System Settings. 2. Check the box next to Enable GCM. 3. In the Sender ID field, enter the Project Number that was generated via the Google API console. 4. Enter the API Key that was generated via the Google API Console. 5. Click Save Changes. Toggle the service on for each organization that will use GCM 1. From the GO!Enterprise MDM dashboard, select System > Organization. GO!Enterprise MDM - GCM for Android Setup Configure the MDM Server for GCM Service 12
2. Check the box next to Use GCM to turn on the service for the organization. 3. Click Save Changes. 4. To turn on GCM service for other organizations hosted by the system, switch to another organization and mark the Use GCM checkbox. To switch organizations: Select System > System Administration > Organizations and click the Switch Organizations button. GO!Enterprise MDM - GCM for Android Setup Configure the MDM Server for GCM Service 13