In this section, we will see together how to configure your iOS channel using a push notification certificate (P12).
Setting up your iOS channel is a technical process.
This is best completed by a developer or any other technical resource.
To conclude this process, you will need the login to your Apple iOS Developer Portal. You also need knowledge of Mac OS X and the Keychain Access application.
We recommend that new applications use token signing for authentication, rather than certificate-based authentication. |
1. Generate a provisioning profile
To support Catalyst apps in Xcode 11+, it’s necessary that your app be built with a provisioning profile that includes an Apple Developer certificate (for Xcode 11 or later) and the Mac capability listed under Enabled Capabilities:
To communicate with APNS, we need the full certificate/key combination that is created from the Apple Developer Member Center for your app.
WARNING Always create a Live Airship project first, and make sure your application code is pointing to the live project’s app key. |
2. Create your identifier
- Log in to the Apple Developer Member Center and go to Account > Certificates, IDs & Profiles, or use this direct link.
- On the left side menu, click Identifiers, click +, select App IDs, and click Continue
-
Fill out the Register an App ID form, making sure to check the Push Notifications checkbox, then click Continue and Register.
3. Get your certificate
-
Go to the Identifiers page and select your App ID.
-
In the list of Capabilities, go to the box for Push Notifications, then click Configure to continue to the Apple Push Notification service SSL Certificates section. The button will be labeled Edit if it has been configured previously.
If the Configure/Edit button is not available, you may not be the team agent or the admin. The person who originally created the developer account is your team agent, and they will have to carry out the remaining steps of this article.
- Click Create Certificate to create a Production SSL Certificate. This will generate an Apple Push Notification service SSL (Sandbox & Production) certificate compatible with both the Production and Development environments.
You should now see the Create New Certificate section to generate an Apple Push Notification service SSL (Sandbox & Production) certificate: -
Follow the instructions to create a certificate signing request in the Create New Certificate section, then click Continue after your certificate signing request is uploaded.
You can now use the newly-created Certificate Signing request to generate the APNs Push SSL certificate. The next step requires the Download button to be active. You may need to reload the page if it is not yet active.
- Click Download and save the file for use in the next step.
4. Export the certificate as a .p12 file
- Open the certificate you downloaded in the previous steps, which should open in the Keychain Access app. The certificate should be listed in My Certificates.
- Click the certificate in the list, then from the File menu, select Export Items….
- Save the file in the Personal Information Exchange (.p12) format.
- You will be prompted to create a certificate password. Use this password in the next step.
5. Configure the iOS channel
- Go to Settings > Channels > Mobile Apps > iOS.
- Click Edit for Certificate-based authentication.
- Enter the certificate password and upload the .p12 file.
- Click Save.
Your iOS channel is now setup and ready to send push notifications.