Page: Installing the Push Service
Page: Configuring the Push Provider
Page: Push Service Configuration
Page: Using the Push Service
Page: Push Configuration
Page: 7.4.7 Release Notes
Page: Announcing the 7.4.7 Release
Page: Using the Push Service
Configuring the Push Provider
The push service supplied with AppStudio enterprise mobility platform relies on a push provider from Apple, BlackBerry, or Google. You have to set up a push provider for the devices on which you want to support push.
This document contains the following topics:
Configuring an Apple Push Notification Service as the push provider
To support push on iOS devices, you have to set up an Apple Push Notification Service (APNS) as the push provider. To configure the Apple push service provider, you must obtain a push notification certificate from Apple. You also need the password required to access the certificate.
Push notification services certificate
For each AppStudio iOS application that uses push notification, you must obtain a signed iOS Push Notification services provisioning certificate as a registered agent:
- From the iOS Provisioning Portal on the iOS developer website, select AppIDs, select your application and click Configure.
From the Configuring App ID screen, check Enable for Apple Push Notification service and select a Development or Production push certificate option. The production certificate works for both. If you use a development certification for testing, you must reinstall the AppStudio push service with the production certification for production deployment.
When configuring an App ID for a distribution profile in the iOS Provisioning Portal, enabling it for iCloud needs to be off or else it will cause the application signing to fail. Storing documents to iCloud is not supported; therefore the Enable for iCloud option should be unchecked.
- Follow instructions in the Generate a Certificate Signing Request wizard, including utilizing the Keychain Access application.
- Name your key to associate it with your application according to the AppStudio convention that appends the default name with the application ID as in the following example:
- If necessary, rename the certificate.
- Save your certificate to the directory where the AppStudio push service is installed. The default location is:
C:\Program Files\AppStudio\Push Service\
Modify this path if you did not install the push service in the default location.
Troubleshooting the push service
If you install the push service on a non-production server, it might fail to execute depending on how permissions are set up. In this case, check the AppStudio log file for a message that indicates a failed APNS connection. This generally signifies that the user running the push notification service cannot access the Push service notification certificate. In this case, modify your AppStudio push service configuration as follows:
- From Windows Services Manager, select the AppStudio Push Service.
- Right click on the service and choose Properties.
- In the Properties dialog, select the Log On tab.
- Find and set the user account to NetworkService.
- Restart the push service.
Configuring a BlackBerry push provider
To support push on BlackBerry devices, you have to set up a BlackBerry push provider. Blackberry push providers have two different modes:
- BES (BlackBerry Enterprise Server) mode
With BES mode, you configure the push provider in AppStudio by setting the URL of your BES server. Note that if you are testing on your app on a simulator, you should use http://localhost and make sure you Push Test App and simulator are on the same machine.
- BIS (BlackBerry Internet Service) mode
To use BIS mode for your push provider, you must first to register with RIM at http://us.blackberry.com/developers/platform/pushapi.jsp. After you register, you will receive an email with the configuration information required by AppStudio.
Configuring Google Cloud Messaging as the push provider
To support push on Android devices, you have to set up a Google push provider. The push provider for Android devices relies on the Google Cloud Messaging (GCM) service. Before you can configure an app to use push on an Android device, you must create and configure the GCM service.
GCM requires that devices run Android 2.2 or later, and have the Google Play Store application installed. You can also use an Android simulator running Android 2.2 or later with Google APIs.
To create and configure the GCM service:
- Browse to https://code.google.com/apis/console.
- Click Create, specify the project name, and select Create Project.
When you create a Google project, Google assigns the project a URL in the form:
The value after '
project:' in the URL is the project ID. In the previous URL, the value is
You need the project ID to configure the push service in AppStudio.
- Select Services in the menu on the left side of the page, and turn on Google Cloud Messaging for Android.
- Select API Access in the menu on the left side of the page.
- On the API Access page, click Create new Server key for your GCM service.
- In the Accept requests from these server IP addresses area of the pop-up window, add the external IP address of the server hosting the AppStudio Push Service that you installed in Installing the Push Service.
Click Create. The API Access page now shows an area labelled Key for server apps (with IP locking).
You need the value of the API key field from the Key for server apps (with IP locking) area to configure the push service in AppStudio