SDK

Setting up APNs

Before you can send push notifications in iOS, you must create and configure an Apple Push Notification Service (APNs) authentication key. This process is completed through the Apple Developer Portal. This guide provides step-by-step instructions on how to create an App ID and generate an APNs authentication key.

Creating an App ID

Sign in to the Apple Developer Portal. From the Program Resources section, in the Certificates, IDs & Profiles menu, click Identifiers:

developer portal certificate identifiers menu

On the Identifiers page, click the plus (+) icon to create a new App ID:

developer portal create app id

Select App IDs and click Continue:

developer portal app ids

developer portal continue button

Provide a name and bundle identifier for you app: The bundle identifier should follow the reverse-DNS format, for example: com.example.app

developer portal app id settings

Select the capabilities your app will use. Ensure that Push Notifications is enabled:

developer portal capabilities

Once all required capabilities are selected, click Continue:

developer portal continue button

Review your configuration details on the confirmation screen. If everything is correct, click Register to finalize the App ID creation:

developer portal app id confirm

Your newly registered App ID will now appear in the list of identifiers.

Generate an APNs Auth Key

Apple introduced APNs authentication keys as part of the modern APNs service in 2016. An authentication key simplifies credential management by allowing a single key to be used across multiple apps within your Apple Developer account. These keys do not expire. However, if a key is revoked, you must update all associated apps and providers with the new key.

In the Apple Developer Portal, select Keys in the Certificates, IDs & Profiles menu of the Program Resources section:

developer portal certificate keys menu

Click the plus (+) icon to register a new key:

developer portal keys icon

Provide a name for the key, then select Apple Push Notification service (APNs) as the enabled service:

developer portal register key

Click Continue to proceed.

developer portal continue button

Review the key details and click Register to finalize creation:

developer portal key register confirm

Once the key has been registered, download the .p8 file:

Important: This file can only be downloaded once. Make sure to store it securely.

developer portal key download

You now have a valid APNs authentication key (.p8 file) ready to be uploaded to Actito. Uploading this key enables Actito to send push notifications to your iOS application.

Uploading the APNs Authentication Key

To configure you Notificare application, open the application in the Dashboard and navigate to the Services section via Menu > Settings > Services.

Click the Configure button on the APNs card.

dashboard apns card

Upload the .p8 file you previously downloaded.

p8 upload field

Provide the Key Identifier (usually the name of the .p8 file, but also available in the Apple Development Portal).

key field

Provide the Team Identifier (available in the Apple Development Portal).

team field

And finally provide the app's Bundle Identifier (available in the Apple Development Portal or in your app’s project settings).

bundle field

Upon saving, if everything is correct, the Authentication Key will appear as follows:

auth key