Apply your push notification credentials

Apply your Adalo App push notification services

• Android requires the Firebase Cloud Messaging (FCM) server key token.

• Apple iOS requires the Apple Push Notification Service (APNS) certificate in two separate files, cert.pem containing the certificate and key.pem containing the private key.

Android FCM

To create a Firebase Cloud Messaging (FCM) server key token for your Android app, follow these steps:

1. Create a Firebase project (if you haven't already)

   • Go to the Firebase Console (https://console.firebase.google.com/) and sign in with your Google account.

   • Click "Add project" and enter the required information, such as the project name and region.

   • Accept the terms and click "Create Project".

2. Add an Android app to the Firebase project

   • In the Firebase Console, navigate to your project's dashboard.

   • Click the Android icon to add an Android app to your project.

   • Enter your Android package name (e.g., "com.example.myapp"). You can find this information in your AndroidManifest.xml file or the "applicationId" field in your app-level build.gradle file.

   • Optionally, you can also add an app nickname and SHA-1 certificate fingerprint for Google Sign-In and other Firebase features.

   • Click "Register app".

   • Download the generated "google-services.json" file and place it in your Android project's "app" directory.

   • Follow the on-screen instructions to add the Firebase SDK to your Android app.

3. Create a Legacy FCM Server Key Token

   • In the Firebase Console, navigate to your project's dashboard.

   • Click the gear icon next to "Project Overview" and select "Project settings".

   • Go to the "Cloud Messaging" tab.

   • In the "Project credentials" section, you will find "Cloud Messaging API (Legacy server)".

   • Click the three dots on the right to select options for "Cloud Messaging API (Legacy server)".

   • Click "ENABLE".

   • In the "Cloud Messaging API (Legacy server)" is your FCM server key token for the "Cloud Messaging API (Legacy)".

The Firebase Cloud Messaging (FCM) server key token can now be entered in the Apple Credentials in the 'App Management' side menu in the Parousya Customer Account.

Note: Keep your server key confidential, as it can be used to send push notifications to all devices associated with your Firebase project.

Apple APNS

To create an Apple iOS app APNS (Apple Push Notification Service) certificate in two separate files, cert.pem containing the certificate and key.pem containing the private key, follow these steps:

1. Create a Certificate Signing Request (CSR)

   • Open the "Keychain Access" application on your Mac.

   • In the top menu, go to Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority.

   • Fill in the required information (email address, common name, etc.), make sure "Saved to disk" is selected, and click "Continue".

   • Save the CSR file to your computer.

2. Create an APNS Certificate

   • Go to the Apple Developer Portal (https://developer.apple.com) and sign in with your Apple Developer account.

   • Navigate to "Certificates, Identifiers & Profiles" and click on "Identifiers" under the "iOS, tvOS, watchOS" section.

   • Find the App ID associated with your app and click on it.

   • Scroll down to the "Push Notifications" section and click "Configure".

   • Choose "Create Certificate" under the "Development" or "Production" section, depending on your needs.

   • Click "Choose File" and upload the CSR file you created in step 1.

   • Click "Continue" and then "Download" to download the newly generated APNS certificate (.cer file).

3. Convert the APNS Certificate to .pem format

   • Locate the downloaded .cer file and double-click it to add it to the "Keychain Access" application.

   • In "Keychain Access", find the certificate you just added (it should have a name like "Apple Development/Production IOS Push Services: [Your App ID]").

   • Right-click (or Control-click) on the certificate and select "Export [certificate name]".

   • Choose "Personal Information Exchange (.p12)" as the file format and save the file to your computer. You will be prompted to set a password for the exported file, but you can leave it blank for now.

   • Open the Terminal application on your Mac and navigate to the directory where you saved the .p12 file.

   • Run the following command to convert the .p12 file to a .pem file:

     openssl pkcs12 -in [your_certificate].p12 -out [your_certificate].pem -nodes -clcerts

     Replace [your_certificate] with the appropriate file name.

   • Extract the certificate from the .pem file by running the following command:

     openssl x509 -in [your_certificate].pem -out cert.pem -outform PEM

   • Extract the private key from the .pem file by running the following command:

     openssl pkcs12 -in [your_certificate].pem -nocerts -out key.pem -nodes

Now you should have two separate files, cert.pem containing the certificate and key.pem containing the private key. These can now be entered in the Apple Credentials in the 'App Management' side menu in the Parousya Customer Account.

Note: Remember to keep your private key confidential, as it can be used to send push notifications to your app users.