Configuring iOS Push Notifications

Enabling Push Notifications in Xcode project

  1. Choose View → Navigators → Show Project Navigator.
  2. Choose the target from the Project/Targets pop-up menu or in the Targets section of the second sidebar if it appears.
  3. Click Capabilities to view app services you can add to your app.
  4. In the Capabilities pane, if Push Notifications isn’t enabled, click the switch in the Push Notifications section.
  5. In Member Center, the Push Notifications service will appear as Configurable (not Enabled) until you create a client SSL certificate.

Creating a Universal Push Notification Client SSL Certificate

You use Member Center to generate a push notification client SSL certificate that allows your notification server to connect to the APNs. Each App ID is required to have its own client SSL certificate. The client SSL certificate Member Center generates is a universal certificate that allows your app to connect to both the development and production environments.

You must be a Apple Developer Program member to be able to create a push notification certificate.

To generate a universal client SSL certificate:

  1. Go to your Apple's dev center.
  2. In Certificates, Identifiers & Profiles, select Certificates.
  3. Click the Add button (+) in the upper-right corner.
  4. Under Production, select the "Apple Push Notification service SSL (Sandbox & Production)" checkbox, and click Continue.
  5. Choose the explicit App ID that matches your bundle ID from the App ID pop-up menu, and click Continue.
  6. Follow the instructions on the next webpage to create a certificate request on your Mac, and click Continue.
  7. Click Choose File.
  8. In the dialog that appears, select the certificate request file (with a .certSigningRequest extension), and click Choose.
  9. Click Generate.
  10. Click Download and save the file (aps.cer).
  11. Click Done.

Generate the SSL certificate for Push Notifications for WordPress

  1. Load aps.cer in the Keychain Access double-clicking on it.
  2. From the Keychain Access application select the certificate (search for "Apple Push Services") and press the right mouse button.
  3. Select "Export" and save it as Certificates.p12 using a password that you remember.
  4. From the command line, in the same directory where you have saved the certificates enter this command:
    $ openssl x509 -in aps.cer -inform der -out Cert.pem
  5. Then, from the same position enter this:
    $ openssl pkcs12 -nocerts -out Key.pem -in Certificates.p12
    It will ask an import password (the one you have used in step 3) and then a secure password for the certificate (the one you will use in Push Notifications for WordPress).
  6. At this point merge the certificate and the key together:
    $ cat Cert.pem Key.pem > ck.pem
    The ck.pem file will be the one you have to use in Push Notifications for WordPress.

Configure Push Notifications for WordPress

  1. Go to Push Notifications → Settings → iOS tab.
  2. Click the Upload button.
  3. Drag and drop the ck.pem file generated.
  4. Click Select.
  5. Enter the password you have selected for the certificate.
  6. Click Save Settings.

With the new certificate system implemented by Apple you can use the same certificate both in distribution and development.

Renew a Universal Push Notification Client SSL Certificate

To renew a universal push notification client SSL certificate:

  1. Go to your Apple's dev center.
  2. In Certificates, Identifiers & Profiles, select App IDs.
  3. Choose the explicit App ID that matches your App ID from the pop-up menu, and click Edit.
  4. Press Create Certificate... under Production SSL Certificate, follow the instructions on the next webpage to create a certificate request on your Mac, and click Continue.
  5. Click Choose File.
  6. In the dialog that appears, select the certificate request file (with a .certSigningRequest extension), and click Choose.
  7. Click Generate.
  8. Click Download and save the file (aps.cer).
  9. Click Done.

Then follow Generate the SSL certificate for Push Notifications for WordPress and Configure Push Notifications for WordPress to use the renewed certificate in Push Notifications for WordPress.