Configure App Platforms

Add support for app messaging to your project, or edit an existing configuration.

Configure iOS

We recommend that new applications use token signing for authentication.

Token-Based Authentication

 Note

You will need your Apple Push Notification Service (APNs):

  • Authentication Signing Key (saved as a .p8 file)
  • Team, Bundle, and Key IDs

See: Register Your Authentication Signing Key.

 Note

Airship defaults to token-based authentication for APNs, but will fall back on certificates if token authentication is not configured. For existing projects, it is recommended that apps leave their certificate in place when migrating to token authentication so that push can be quickly restored if there are any issues during that process.

  1. Go to Settings » Channels » Mobile App and click Add for iOS.
  2. Select Token-based authentication, then upload the .p8 file and enter your Team, Bundle, and Key IDs.
  3. Click Add iOS.

Certificate-Based Authentication

 Warning

Never use the same push certificate across multiple Airship app keys. You should also never use the same bundle ID across multiple app keys in the same environment (development or production).

Not following these instructions can result in rejected device tokens and APNs feedback processed by the wrong app key. If you need to have a third app key for ad hoc builds (which also use Distribution-type push certificates), the bundle ID should be changed so you can use a different certificate, for example: com.yourcompany.app.adhoc.

 Note

You will need your Apple Push Notification Service (APNs):

  1. Go to Settings » Channels » Mobile App and click Add for iOS.
  2. Select Certificate-based authentication, then enter the certificate password and upload the .p12 file.
  3. Click Add iOS.

Configure Amazon

 Note

You will need your Amazon Device Messaging (ADM) OAuth Client Credentials:

  • Client ID
  • Client secret

You can find these in the Amazon developer console. See: Get Your OAuth Credentials and API Key.

  1. Go to Settings » Channels » Mobile App.
  2. Click Configure for Amazon and enter your client ID and client secret.
  3. Click Save.

Configure Android

 Note

For Firebase Cloud Messaging (FCM), you will need:

  • Server key
  • Package name

You can find the server key in the Firebase console in Project settings » Cloud Messaging.

For Huawei Mobile Services (HMS), you will need:

  • App ID
  • App secret

You can find these in AppGallery Connect. Navigate to My Apps, select the app you want to configure with Airship, and copy its App ID and App secret.

  1. Go to Settings » Channels » Mobile App.
  2. Click Add for Android.
  3. Enter your Firebase server key and package name and/or Huawei app ID and app secret.
  4. Click Add Android.

Configure Windows

 Note

You will need your Windows Push Notification Services (WNS):

  • Package security identifier (SID)
  • Secret key

You can find these in the Partner Center; follow the instructions on the App Management - WNS/MPNS page.

  1. Go to Settings » Channels » Mobile App.
  2. Click Configure for Windows and enter your SID and secret key.
  3. Click Save.

Configure Apple News

 Note

You will need your Apple News Publisher:

  • Channel ID
  • API key
  • API key secret

You can find the channel ID and API key in the Settings tab in News Publisher. The API key secret is shown only when it is first issued.

  1. Go to Settings » Channels » Mobile App.
  2. Click Configure for Apple News and enter a channel name and your News Publisher channel ID, API key, and API secret The Apple News channel name is used for preview purposes in the dashboard.
  3. Check the box for each of the Supported Countries you have configured in your News Publisher channel settings.
  4. Click Save.
 Note

  • Your News Publisher channel ID has no relation to an Airship Channel ID.

  • We validate the country selection you click Send Now or Send When Live as the final step in creating an Apple News notification. If a country selected here is not configured in your News Publisher channel settings, you will see an error in the dashboard when attempting to send to that country.

Edit or Delete a Mobile App Channel

  1. Go to Settings » Channels » Mobile App.
  2. Click Edit.
  3. Make your changes and click Save, or click Remove Service.