Configuring push notifications for iOS apps

Keep the users up-to-date with various events in your business process by configuring push notification support in your mobile app for iOS devices. You configure push notification support for iOS apps by adding an Apple Push Notification service certificate to your iOS mobile certificate set in Pega Platform. The certificate is stored in a .p12 file that you can use to enable push notifications for your app.
Before you begin: Prepare the framework for enabling push notifications in your app:
  1. Use a computer with the macOS operating system.
  2. Set up an Apple Developer Portal account for generating a .p12 file with a push notification certificate. For more information, see the Apple developer documentation.
  3. Create and configure an App ID, a signing certificate, and provisioning profile that supports push notifications. For more information, see Obtaining an App ID for iOS apps, Obtaining a signing certificate for iOS apps, and Obtaining a mobile provisioning profile for iOS apps.
  4. Create a certificate set for your app. For more information, see Creating an iOS certificate set.
  • Create a push notification certificate for your app identifier
    1. Go to https://developer.apple.com, and then sign in to your Apple Developer Portal account.
    2. On your Apple Developer Portal account dashboard, navigate to the Certificates, Identifiers & Profiles page, and then click Identifiers.
    3. In the list of identifiers, click the one that you want to use in your app.
    4. In the list of capabilities for the identifier, select the check box next to the push notifications capability, and then save the identifier.
    5. In the list of identifiers, reopen the identifier that you edited, and then start the configuration workflow next to the push notifications capability.
    6. In the push notification configuration window, choose and create a certificate type that matches your needs:
      • Development SSL Certificate
      • Production SLL Certificate
  • Generate and upload a certificate signing request from your macOS computer
    1. On your macOS computer, open the Keychain Access application.
    2. On the menu bar, click Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority.
    3. In the Certificate Assistant window, enter your email address and a common name for the certificate.
    4. Choose the request type by clicking Saved to disk.
    5. Click Continue, and then save the certificate signing request file on your hard drive.
    6. In the Apple Developer Portal, on the certificate signing request upload page, upload the file that you generated in Keychain Access.
    7. Generate a .cer file by completing the configuration process.
  • Generate a .p12 file from the .cer file
    1. From the Apple Developer Portal, download the generated .cer file.
    2. On your computer, double-click the .cer file, and then confirm its addition to Keychain Access.
    3. In Keychain Access, find your certificate file.
    4. Right-click the certificate, and then click Export "Apple Push Services: your certificate name".
    5. In the export window, in the File Format list, select the Personal Information Exchange (.p12) format.
    6. Click Save.
    7. In the password protection window, protect the file from unauthorized use by encrypting the file with a password, and then click OK.
    8. Enter your system password, and then click Allow.
  • Add the .p12 file to the certificate set that you want to use in your iOS app
    1. In the navigation pane of App Studio, click Settings > Mobile certificates.
    2. On the Mobile certificates page, click the iOS certificate set that you want to use in your mobile app.
      Note: The mobile provisioning file that you use in the certificate set must support push notifications. Otherwise, the push notification certificate section is not available.
    3. In the Push notification certificate section, click New.
    4. In the Upload new certificate file window, enter the encryption credentials for the certificate, and then upload the .p12 file for push notifications.
    5. Click OK, and then click Save.
    What to do next: Ensure that your app receives automatic and manual push notifications by adding the certificate set that you updated to the mobile channel for your app. For more information, see Generating native mobile apps.