All Products
Search
Document Center

Push configuration

Last Updated: Jun 30, 2021

Push configuration can be completed by configuring the FCM or iOS push certificate.

  • Configure FCM
    When you push messages to an Android device outside China, the FCM service is used as the message push gateway. You must configure FCM on the console.

  • Configure iOS push certificate
    When you push messages to an iPhone, the APNs service is used as the message push gateway. You must upload the iOS push certificate on the console to access APNs service.

Prerequisites

  • You have obtained the FCM server key from the Firebase console (Project settings > Cloud messaging > Server key).
  • Before configuring the iOS push certificate, you have created an iOS push certificate by referring to Create an iOS push certificate.

Procedure

Configure FCM

Log in to the mPaaS console, select the App, and perform the following steps to configure FCM:

  1. On the left-side navigation pane, choose Message Push Service.
  2. Click the Push configuration tab.
  3. Click Configure in the upper right corner of the FCM area.

    fcm

    • Turn on the Status switch, MPS accesses the FCM service. If the switch is turned off, the FCM service is disabled in MPS.
    • Enter the FCM server key. Make sure that this is the server key. Android, iOS, and browser keys will be rejected by FCM.
  4. Click OK to save the settings.

Configure iOS push certificate

Log in to the mPaaS console, select the App, and perform the following steps to configure the iOS push certificate:

  1. On the left-side navigation pane, choose Message Push Service.
  2. Click the Push configuration tab.
  3. In the iOS push certificate area, configure the iOS push certificate. The following table describes the parameters.
    • Select certificate file: Select and upload the pre-prepared iOS push certificate. The backend will obtain the certificate environment and BundleId by parsing the uploaded certificate. For how to generate iOS push certificate, see Create an iOS push certificate.
    • Certificate password: Enter the certificate password.
  4. Click the Upload button to save the settings. If the certificate is in a correct format, you can view the details. You can use Simple push to test whether a certificate is valid and is compatible with the environment.
    Note: The iOS push certificate is only valid for a certain period, please renew the certificate before it becomes invalid to keep the message push working normally. You will be prompted to replace the certificate 15 days before the certificate expires. To replace the certificate, you can click Re-upload at the bottom to upload a new one.
    1