Create an iOS push certificate

Updated at:

To send push notifications to iOS devices, you need an iOS push certificate. This topic explains the supported certificate types and shows you how to create one in the Mobile Push console.

Certificate types

The Mobile Push service supports only Apple Push Service certificates. For more information about Apple certificate types, see Apple certificate types.

Using an iOS Development certificate will cause many push notifications to fail. The following sections show how to distinguish between these two types using Keychain Access and the Mobile Push console.

Type

Purpose

Apple Push Service

A push certificate for the production environment. It connects your notification service to APNs to send remote notifications to your app.

iOS Development

A development certificate. It is used for on-device debugging and test releases.

Important

iOS supports three certificate types: Development, Production, and Development & Production. Mobile Push does not support using a Development & Production certificate for push testing.

Keychain Access

Double-click a .p12 certificate to import it into the macOS keychain. You can then view information such as the certificate name:

cert_list.png

The following certificate names indicate different certificate types:

  • iPhone Developer: an Apple development certificate. Not supported by Mobile Push.

  • Apple Push Service: an Apple push certificate for the production environment. Supported by Mobile Push.

  • Apple Development IOS Push Services: an Apple push certificate for the development environment. Supported by Mobile Push.

Mobile Push console

After you import a certificate into the Mobile Push console, you can view the following certificate information:

2

As shown in the preceding figure, the subjectDN attribute can be one of the following values:

  • Apple Development IOS Push Services: an Apple push certificate for the development environment. Supported by Mobile Push.

  • Apple Push Service: an Apple push certificate for the production environment. Supported by Mobile Push.

3

As shown in the preceding figure, if the subjectDN attribute is iPhone Developer, the certificate is an Apple development certificate, which is not supported by Mobile Push.

Create a certificate

Create an Apple App ID

  1. In the Apple Developer portal, click App IDs in the left-side navigation pane, and then click + in the upper-right corner.

  2. Enter the basic information.

    • App ID Description > Name

    • App ID Suffix > Bundle ID: The Bundle ID must be unique.

  3. Select the Push Notifications capability.

  4. Click Continue, and then click Register to complete the creation.

Generate a certificate signing request

  1. Open Keychain Access on your Mac.

  2. Choose Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority….

  3. In the Certificate Information dialog box, enter your email address, a common name, and the other required information.

  4. This generates a .certSigningRequest file.

Create the certificate

  1. On the App IDs page in the Apple Developer portal, select your iOS App ID and click Edit.

    edit_app_id.png

  2. In the Development SSL Certificate or Production SSL Certificate card, click Create Certificate for either the development or production environment.

    create_cert_entry.png

  3. Upload the .certSigningRequest file.

    upload_certSigningRequest_file.png

  4. Once the certificate is created, click Download to save the .cer file.

    cert_ok.png

  5. Convert the .cer file to a .p12 file.

    1. Double-click the .cer file to import it into your keychain.

    2. Find the imported certificate, right-click it, and choose Export. This creates the .p12 certificate.

      convert_cer_to_p12.png

  6. With the .p12 certificate file, go to the Settings > Channel Configuration page in the Mobile Push console and upload your iOS push certificate.