iOS - Push Notification Guide
By Technical Support
#7 Steps to configure your application for iOS :

To configure BulkPush for your iOS application you will need the following:
If you are Premium account holder you can go straightaway to step 5.2!
• Apple Push Notification Service (APNS) certificate
• private key for the certificate
• password for the private keys

1. Generating a Certificate Request
You need to generate a certificate request file that you can use to request a development SSL certificate later on.
1.1. Launch the Keychain Access application in your Mac OS X.
1.2. Select Keychain Access→Certificate Assistant→Request a Certificate From a Certificate Authority (see Figure 1):

Image

Figure 1. Generating a certificate request 1.3. Enter the information required and check the Saved to disk option. Click Continue (see Figure 2).

Image

Figure 2. Saving the certificate request to disk 1.4. Save the certificate request using the suggested name and click save (see Figure 3): Click done in the next screen.

Image

Figure 3. Naming the certificate request

2. Creating an App ID
If you have App ID ready, just skip to step “3. Configuring an App ID for Push Notifications”
Each iOS applications that use the APNs must have a unique application ID that uniquely identifies itself. In this step, you will learn how to create an App ID for push notifications.
2.1. Sign in to the iOS Developer Center at: https://developer.apple.com/membercenter/. Click on the Certificates, Identifiers and Profiles on the right of the page (see Figure 4).

Image

Figure 4. Launching the iOS Provisioning Portal
2.2. You should see the welcome page (see Figure 5). Choose Identifiers from the iOS Apps list.

Image

Figure 5. The welcome screen of the iOS Provisioning Portal 2.3. Click on the App IDs tab on the left and then click on the New App ID button (see Figure 6).

Image

Figure 6. Adding the new App ID
2.4. Register a new App ID. Enter your App ID Description (Ex: “BulkPushAppID”), and select an App ID Prefix. In the App ID Suffix section choose Explicit App ID, and provide the correct Bundle Identifier in the form com.company.application (i.e.: com.arellomobile.MyBulkPushApp). Check Push Notifications from the list of App Services and click Continue (see Figure 7), then Submit, and then done.

Image

Figure 7. Creating a new App ID
2.5. You should now see the App ID that you have created (together with those you have previously created). Click Edit to configure Push Notifications for your App ID (see Figure 8).

Image

Figure 8. Viewing the newly created App ID

3. Configuring an App ID for Push Notifications
Once an App ID is created, you need to configure it for push notifications.
3.1. To configure an App ID for push notification, you need to click the Create Certificate link displayed on the right. (See Figure 9).

Image

Figure 9. Creating the Development SSL Certificate 3.2. You will now see the Apple Push Notification service SSL Certificate Assistant screen. Click Continue (see Figure 10).

Image

Figure 10. The Apple Push Notification service SSL Certificate Assistant screen 3.3. Click the Choose File button to locate the Certificate Request file that you have saved earlier. Click Generate (see Figure 11).

Image

Figure 11. Generating the SSL certificate 3.4. Your SSL Certificate will now be generated. Click Continue, and then click the Download button to download the SSL Certificate on your drive. Click done (see Figure 12).

Image

Figure 12. Downloading the Certificate This is the first file your will need to upload to Bulkpush 3.5. Download the certificate and double-click on it to install it in the Keychain Access application (see Figure 13). This is the SSL certificate that will be used by Bulkpush so that it can contact the APNs to send push notifications to your applications. Now you need to export the certificate.

Image

Figure 13. Installing the generated certificate into the Keychain Access application

4. Exporting Private Key
4.1. Open up the Keychain Access Application and select the ‘Keys’ category. Click on the private key associated with your iOS Push Certificate and click ‘Export Items’ in the menu (see Figure 14). Please note this is not a private key for your iOS Development certificate. You will be prompted to create a password; you will need to enter the same password on Bulkpush configuration page. This is the second file you need to upload to Bulkpush. You also need to enter the same password you have used to create the Private Key (just few lines above).

Image

Image

Image

Figure 14 Exporting Key file 4.2. To install the Certificate and the Private Key for the application log in to your Control Panel, go to “My applications”, select your application, and open the “Configure” page in the left menu (see Figure 16).