Login

Learning & Support

Documentation

iOS: Setup Key based authentication for Apple Push Notifications (>8.0)

Twixl Support Team Updated: - Created :

In the past we used Certificate based authentication for sending Push Notifications to iOS devices. The procedure to create these certificates is rather complex and can cause frustrations. That's the reason why we introduce Key based authentication. This KB-article explains everything!

1. Setup your App ID

To enable Push Notifications in your iOS Application, you still need to adapt the App ID.

  1. Navigate to (developer.apple.com > Account > Certificates, Identifiers & Profiles > Identifiers > App ID)
  2. If you want to edit an existing App ID, select Configure, otherwise select New Apple ID
  3. After you entered a description for this App ID and the Bundle Identifier (use the same reverse-DNS name as in the Twixl Distribution Platform) you can configure it.

ALERT:

It's very important that you use the same Bundle Identifier as in the Twixl Distribution Platform (reverse-DNS name). This is a requirement in order to be able to send Push Notifications from within the Twixl Distribution Platform to your iOS devices.

Setup an App ID
2. Activate Push Notifications for the App ID
  1. When in the App ID detail window, you'll notice a list of all App Services.
  2. Enable for Apple Push Notifications.

WARNING:

Don't create a Development or Production SSL Certificate! That part is not necessary when setting up a Key based authentication.

3. How to create the authentication key
  1. Navigate to https://developer.apple.com/account/ios/authkey/ . (developer.apple.com > Account > Certificates, Identifiers & Profiles > Keys)
  2. Top on the + button to add a new key.
  3. Give the key a name and enable the service called Apple Push Notifications (APNs).
  4. Click on Continue. You will then be asked to confirm your key configuration.
  5. Click on Confirm to create the key.
  6. Select Download in the next screen to download the .p8 file to your local machine.
  7. After you've created the key, click on Keys again in the left column, select the key you have just created and write down the value for Key ID.
  8. Then, navigate to https://developer.apple.com/account and click on Membership in the left column, write down the Team ID.
4. Configure the Push Notification settings on the Twixl Distribution Platform.
  1. On the Twixl Distribution Platform:
  2. Navigate to your app.
  3. Select Push Notifications in the App Menu.
  4. Select Key-based Authentication for the Authentication Mode.
    1. Upload the .p8 file
    2. Insert the Key ID you wrote down
    3. Insert the Team ID you wrote down.

Was this article helpful?

1 out of 1 found this helpful