Skip to content

iOS certificate-based configuration

Follow this guide to configure the iOS platform manually.

Generating a certificate request file

Anchor link to
  1. Launch Keychain Access, go to Certificate Assistant and click Request a Certificate From a Certificate Authority:
Keychain Access on macOS showing Certificate Assistant menu to request a CSR for APNs certificate
  1. Enter the required information and choose Saved to disk. You should leave the CA email field blank. Click Continue and Save the certificate request using the suggested name.
Create CSR in Keychain Access

Creating an APNs certificate in Apple Developer Portal

Anchor link to
  1. Sign in to the Apple Developer Portal and open Certificates, Identifiers & Profiles in the Account tab. Click Add:
Apple Developer Portal—Certificates, Identifiers & Profiles dashboard with Add certificate button
  1. Choose the certificate type you need and click Continue at the bottom of the page.
Selecting APNs SSL (Sandbox & Production) certificate type in Apple Developer Portal
  1. Select your project’s App ID on the next page, then click Continue.
Choosing App ID for APNs certificate issuance in Apple Developer Portal
  1. Choose the Certificate Signing Request you created previously.
Uploading the CSR file
  1. Download the certificate and add it to the Keychain Access. Once you click on the certificate, Keychain Access will be launched.
Downloading the certificate from Apple Developer Portal

Exporting the private key (.p12)

Anchor link to

In Keychain Access, right-click the certificate you just added and choose Export.

Export the certificate and private key as .p12 from Keychain Access

Save the Personal Information Exchange (.p12) file. You will be prompted to set up a password.

After you type in your password, click Allow to finish exporting the Private Key.

Configuring the iOS platform in Pushwoosh

Anchor link to

In your Pushwoosh project, go to the Configure Platforms section and click Configure in the iOS row:

In the opened form, choose certificate-based manual configuration and click Next:

In the opened window, do the following:

  • Upload the certificate file (.p12)
  • Enter the Private key password
  • Choose the Gateway

Click Configure to complete the setup.