iOS Push

The notifications system on iOS leverages the APNs Service, which requires a certificate to be invoked by the DPS backend.
Here are the steps to obtain a certificate for iOS push notifications with Apple APNs service.

Prerequisites

• An active Apple Developer Program membership.

• A Mac with Keychain Access (needed to generate the certificate request and export the final certificate).

• An App ID for your app with the Push Notifications capability enabled.

1. Create a Certificate Signing Request (CSR)

On your Mac, open Keychain Access → menu Certificate Assistant → Request a Certificate From a Certificate Authority.
Enter your email and a common name, select Saved to disk, and save the .certSigningRequest file.
This generates a private/public key pair in your keychain; the private key stays on your machine.

2. Register/verify the App ID

Go to the Apple Developer portal → Certificates, Identifiers & Profiles → Identifiers.
Select (or create) your App ID and make sure the Push Notifications capability is checked.

3. Create the APNs certificate

In the portal go to Certificates → + (add).
Under Services, choose Apple Push Notification service SSL (Sandbox & Production); this single certificate covers both development and production.
Select your App ID, then upload the CSR file from Step 1.

4. Download and install

Download the generated .cer file and double-click it to install it into Keychain Access.
It will be paired with the private key created in Step 1.

5. Export as .p12

In Keychain Access, find the certificate, expand it to confirm the private key is attached, right-click → Export.
Save it as a .p12 file and set a password.
This .p12 (certificate + private key) is what your push server uses to authenticate with APNs.

Plugin Configuration

To enable this plugin, you need to:

1. Go to the Integrations / Plugins page.

2. Select the Notifications category.

3. Locate the iOS Push card.

4. Click on the card switch to activate the plugin.

5. Enter the Mobile Application Id, the Certificate and relative password.

6. Save.

Here is the list of all the properties that can be used in the plugin configuration.