All Products
Search
Document Center

Mobile Platform as a Service:Channel configuration

Last Updated:Feb 05, 2024

This topic describes how to configure push channels for iOS and Android.

Configure an iOS push channel

When accessing an Apple mobile phone, it relies on the APNs service as the message push gateway. You need to upload an iOS push certificate on the console side to connect to the APNs service.

Complete these steps to configure the iOS push certificate:

  1. Log on to the mPaaS console. In the left-side navigation pane, choose Message Push Service > Settings.

  2. On the right-side Settings page, click the Channel Settings tab. In the iOS Channel section, configure the iOS certificate.

    • Select Certificate File: Select and upload the prepared iOS push certificate. The backend parses the uploaded certificate to obtain the certificate environment and the BundleId. For more information about how to create an iOS push certificate, see Create an iOS push certificate.

    • Certificate Password: Enter the certificate password that you set when you export the. p12 certificate.

  3. Click Upload to save the configuration. If the format of the certificate is correct, you can view the details of the certificate. If you need to verify whether the certificate corresponds to the environment and is valid, you can test it by pushing a message in the console.

Note

An iOS push certificate has a validity period. Update the certificate before the push certificate expires to prevent message push from working properly. The system starts reminding you to replace the certificate 15 days before the certificate expires. To replace the certificate, click Re-upload below the certificate information to upload a new certificate.

Configure iOS Live Activity Message Push Certificate

Important

Before configuring the iOS live activity message push certificate, you must first make sure that the iOS original push certificate, that is, the .p12 certificate, has been configured, otherwise the live activity message certificate can not be configured.

The steps to configure the iOS live activity messaging certificate are as follows:

  1. Log in to the mPaaS console, select the target application, and enter the Message Push Service > Settings page from the left navigation bar.

  2. On the settings page of the iOS channel, check the Token Authentication configuration. After configuring bundleId, keyId, and teamId, upload the p8AuthKey private key file, which is a .p8 file, and click OK.

Important

The environment for pushing live activity messages is bound to the original iOS certificate, so the usage effect is as follows:

  • If the original iOS certificate is a test environment sandbox certificate, live activity messages in the test environment will be pushed.

  • If the original iOS certificate is a production environment certificate, live activity messages of the production environment will be pushed.

Configure an Android push channel

To improve the reach rate of push, mPaaS integrates push channels from manufactures such as Huawei, Xiaomi, OPPO, and vivo. Use Xiaomi notification bar messages, Huawei notification bar messages, OPPO notification bar messages and vivo notification bar messages to achieve message push. When the application is not run time, a notification can still be sent, and the user can activate the process by clicking on the notification bar.

Note

After you connect a manufacture-owned push channel, your application can achieve stable push performance. Therefore, we recommend that you connect the manufacture-owned push channel to your application.

This article will guide you to complete the console-side configuration required when you access the Xiaomi, Huawei, OPPO, and vivo push channels.

Prerequisites

You must configure the client-side access. For more information, see Connect the manufacture push channel.

Procedure

Configure a Huawei push channel

  1. In the left-side navigation pane, choose Message Push Service > Settings > Channel Configuration.

  2. Click Configure in the upper-right corner of the Huawei Push Channel section. The configuration entry is displayed.

    Parameter

    Required

    Description

    Status

    Yes

    The access status switch of the channel. If you turn on the switch, MPS will access the Huawei push channel based on the configuration; if you turn off the switch, the access is canceled.

    SDK package

    Yes

    Supports custom Huawei application package names. If this parameter is not specified, the package name registered by the Xiaomi channel is used by default.

    Huawei Application ID

    Yes

    Enter the App ID of the Huawei application.

    Huawei Application Key

    Yes

    Enter the App Secret of the Huawei application.

    Note

    You can log on to the Huawei Developer Alliance website and choose Management Center > My Product > mobile application Details to obtain the application package name, application ID, and key.

  3. Click OK to save the configurations.

Configure HONOR Push Channel

  1. In the left-side navigation pane, choose Message Push Service > Settings > Channel Configuration.

  2. Click Configure in the upper-right corner of the HONOR Push Channel configuration section. The configuration entry is displayed.

    Parameter

    Required

    Description

    Status

    Yes

    The access status switch of the channel. Turn on the switch, MPS will access the HONOR push channel according to the configuration; Turn off the switch, that is, cancel the access.

    SDK package

    Yes

    Support custom HONOR application package name.

    HONOR AppID

    Yes

    The unique application identifier, which is generated when the HONOR Push service of the corresponding application is activated on the developer platform.

    HONOR Application ID

    Yes

    The customer ID of the application, which is used to obtain the ID of the message sending token. It is generated when the corresponding application PUSH service is activated on the developer platform.

    HONOR Application Key

    Yes

    Enter the HONOR app secret (App Secret).

    Note

    You can log on to the HONOR Developer Alliance website and go to the Management Center > My Products > mobile application Details page to obtain the application package name, application ID, and key.

  3. Click OK to save the configurations.

Configure the Xiaomi push channel

  1. In the left-side navigation pane, choose Message Push> Settings> Channel Configuration.

  2. Click Configure in the upper-right corner of the Xiaomi Push Channel section. The configuration entry is displayed.

    Parameter

    Required

    Description

    Status

    Yes

    The access status switch of the channel. If you turn on the switch, MPS will access the Xiaomi push channel according to the configuration. If you turn off the switch, the access is canceled.

    SDK package

    Yes

    Enter the main package name of the Xiaomi app.

    sqlserver password

    Yes

    Enter the AppSecret of the Xiaomi app.

    Note

    To obtain the package name and key, log on to the Xiaomi Open Platform console and choose Application Management > Application Information.

  3. Click OK to save the configurations.

Configure an OPPO push channel

  1. In the left-side navigation pane, choose Message Push> Settings> Channel Configuration.

  2. In the upper-right corner of the OPPO Push Channel section, click Configure. The configuration entry is displayed.

    Parameter

    Required

    Description

    Status

    Yes

    The access status switch of the channel. If you turn on the switch, MPS connects to the OPPO push channel based on the configuration. If you turn off the switch, the access is canceled.

    SDK package

    Yes

    You can customize the name of an OPPO application package. The name must be the same as the name of the application package on the OPPO open platform. If this parameter is not specified, the package name registered by the Xiaomi channel is used by default.

    AppKey

    Yes

    The AppKey is the identity of the client and is used when the client SDK is initialized.

    MasterSecret

    Yes

    The MasterSecret is used by developers to verify their identities when they call API operations on the server.

    Note

    On the OPPO Open Platform, after you grant the OPPO push permission, you can view the AppKey and MasterSecret of the application on the OPPO Push Platform > Configuration Management > Application Configuration page.

  3. Click OK to save the configurations.

Configure the vivo push channel

  1. In the left-side navigation pane, choose Message Push> Settings> Channel Configuration.

  2. In the upper-right corner of the VIVO Push Channel section, click Configure. The configuration entry is displayed.

    Parameter

    Required

    Description

    Status

    Yes

    The access status switch of the channel. If you turn on the switch, MPS connects to the vivo push channel based on the configuration. If you turn off the switch, the access is canceled.

    SDK package

    Yes

    You can customize the name of the vivo application package. The name must be the same as the name of the application package on the vivo open platform. If this parameter is not specified, the package name registered by the Xiaomi channel is used by default.

    APP ID

    Yes

    AppId is the identity of the client and is used when the client SDK is initialized.

    AppKey

    Yes

    The AppKey is the identity of the client and is used when the client SDK is initialized.

    MasterSecret

    Yes

    The MasterSecret is used by developers to verify their identities when they call API operations on the server. This parameter corresponds to the AppSecret that you obtained from the vivo developer platform.

    Note

    After you apply for the push service for an application on the vivo open platform, you can obtain the AppId,AppKey, and MasterSecret(AppSecret) of the application.

  3. Click OK to save the configurations.

Configuring the FCM Push Channel

If you use Google's FCM service as the message push gateway when you connect Android devices outside China, you must configure the FCM push channel in the console.

Prerequisites

Before you configure the FCM push channel, you need to obtain the FCM server key on the Firebase console.

Procedure

  1. In the left-side navigation pane, choose Message Push Service > Settings > Channel Configuration.

  2. Click Configure in the upper-right corner of the FCM Push Channel section to configure the channel.

  3. Click the Status switch. If you turn on the switch, MPS is connected to FCM. If you turn off the switch, MPS is not connected to FCM.

  4. Enter the FCM server key. Make sure that the key is the server key. The Android key, iOS key, and browser key are rejected by FCM.

  5. Click OK to save the configuration.