Configure Channels

Configure Mobile Channels and Push Providers in the Airship Dashboard

iOS Channel Configuration

To configure an iOS channels, you must configure Apple Push Notification Service (APNs). To do this, you can either use token or certificate auth. It is recommended to use token auth to simplify setup and to avoid having to renew your certificate every year.

 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 you leave your certificate in place when migrating to token-based authentication so that push can be quickly restored if there are any issues during that process. Also, if you remove your certificate before setting up token-based authentication, you may have a period when you cannot send messages.

After confirming token-based authentication is working, you can let the certificate expire, or revoke the certificate from the Apple Developer Member Center.

  1. Log in to the Apple Developer Member Center.

  2. Go to Account » Membership and copy your Team ID. You’ll need this ID when you configure the APNs service in Airship later.

  3. In the left side menu, go to Certificates, Identifiers & Profiles » Identifiers.

     Note

    If you have not already registered an iOS App ID, select Identifiers from the menu on the left side, click + to add a new identifier, make sure that App IDs is selected from the menu on the right side, then click Continue:

    Fill out the Register an App ID form. Note your Bundle ID, then check the Push Notifications checkbox and click Continue and Register. Now can skip to step 4 below.

  4. Note your Bundle ID and check the box for Push Notifications, then click Save. If Push Notifications was already enabled, click All Identifiers at the top of the page to go back.

  5. In the left side menu, click Keys.

  6. Click + to register a new key, then enter a unique key name and enable Apple Push Notifications service (APNs). Click Continue.

  7. Click Register to finish registering your key.

  8. On the following screen, note your Key ID and click Download to save the key in .p8 format.

     Important

    Be sure to save your key in a secure location if you intend to use it across multiple apps or Airship projects. Apple only allows two registered APNs keys per team, so reaching this limit would require you to revoke one of your existing keys before creating a new one, which in turn would require an update for any apps previously using the revoked key. Airship will not make your key available for download or sharing across projects once it has been uploaded.

  9. Navigate to the Airship dashboard.

  10. Go to Settings » Channels » Mobile Apps » iOS.

  11. Click Edit for Token-based authentication.

  12. Upload the .p8 file and enter your Team, Bundle, and Key IDs.

  13. Click Save.

Certificate Auth

  1. Log in to the Apple Developer Member Center and go to Account » Certificates, Identifiers & Profiles, or use this direct link.

  2. In the left side menu, click Identifiers, then click your app’s name in the list of App IDs.

     Note

    If you have not already registered an iOS App ID, 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.

    Click your app’s name in the list of App IDs, and skip to step 4 below.

  3. In the list of Capabilities, check 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.

     Note

    If the Configure/Edit button is not available, you may not be the team agent or an admin. The person who originally created the developer account is your team agent, and they will have to carry out the remaining steps in this section.

  4. 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:

  5. Follow Apple’s 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.

  6. Click Download and save the file for use in the next step.

  7. Open the certificate you downloaded in the previous step. It should open in the Keychain Access app and be listed in My Certificates.

  8. Click the certificate in the list, then from the File menu, select Export Items….

     Note

    Be sure to select My Certificates under the Category menu on the lower left-hand side. If My Certificates is not highlighted, you will not be able to export the certificate as a .p12 file.

  9. Save the file in the Personal Information Exchange (.p12) format.

    You will be prompted to create a certificate password. Use this password in a later step.

  10. Navigate to the Airship dashboard.

  11. Go to Settings » Channels » Mobile Apps » iOS.

  12. Click Edit for Certificate-based authentication.

  13. Enter the certificate password and upload the .p12 file.

  14. Click Save.

Android Channel Configuration

To configure Android channels, you must configure either Firebase Cloud Messaging (FCM) and/or Huawei Mobile Services (HMS). If both push providers are configured, the Airship SDK will prioritize FCM as the push provider if the app and the SDK are set up for both.

FCM

  1. Log in to the Firebase console.

  2. Either create a new project or open an existing project that you want to configure with Airship.

  3. In the left side menu, click   and select Project settings.

  4. Select Cloud Messaging from the options at the top of the screen, then click   for Cloud Messaging API (Legacy) and select Manage API in Google Cloud Console.

  5. Click ENABLE in the Google Cloud Console.

  6. Return to the Firebase console and open your project.

  7. In the left side menu, click   and select Project settings.

  8. Select Cloud Messaging from the options at the top of the screen, then copy the Server key from the Cloud Messaging API (Legacy) section.

  9. Configure FCM in the Airship dashboard using the Server key.

  10. In Airship, go to Settings » Channels » Mobile Apps » Android.

  11. Enter your Firebase server key and package name.

  12. Click Add Android.

HMS

  1. Follow Huawei’s documentation to configure app information in AppGallery Connect.

  2. Log in to AppGallery Connect.

  3. Go to My Apps and select the app you want to configure with Airship.

  4. Enable Push service by following Huawei’s documentation.

  5. Go to the Develop Overview and scroll to the bottom. Copy the Client ID and Client secret.

  6. Configure Airship Android Channel with the HMS Credentials.

    1. In Airship, go to Settings » Channels » Mobile Apps » Android.

    2. Enter your Huawei client ID and client secret.

    3. Click Add Android.

Amazon Channel Configuration

To configure Amazon channels, you must configure Amazon Device Messaging (ADM).

 Note

While you will not need in-depth knowledge of Amazon’s ADM platform in order to use ADM for push notifications, we recommend that you review Amazon’s Overview of Amazon Device Messaging before continuing.

  1. Follow Amazon’s documentation to obtain your OAuth Credentials and API Key.
  2. Configure Airship Amazon Channel with the OAuth Credentials.
    1. In Airship, go to Settings » Channels » Mobile Apps » Amazon.
    2. Enter your Client ID and Client secret.
    3. Click Save.