创建鸿蒙推送证书

更新时间: 2024/05/22 09:59:23

NIM HarmonyOS SDK 自 v0.6.0 版本起支持鸿蒙推送服务。

本文主要介绍如何集成鸿蒙的离线推送通道,使消息通过鸿蒙推送服务离线推送至未在线的用户。

集成流程

步骤 1:在华为者开发平台创建 HarmonyOS 应用并启用推送服务

若已在华为开发者平台开通鸿蒙推送服务,则忽略该步骤。具体信息请参考鸿蒙推送最新文档:鸿蒙推送服务启用指南

  1. 在华为开发者平台注册开发者账号并完成认证,详情请参考华为开发者账号注册指南

  2. 登录华为开发者平台,创建华为项目。在当前项目下,创建 HarmonyOS 应用

    创建 HarmonyOS NEXT 应用,而非 Android 应用。

  3. 华为 AppGallery Connect 平台中,选择当前项目,单击左侧推送服务并开通。

    开通鸿蒙推送服务.png

步骤 2:在华为开发者平台申请该项目 API 服务凭证

  1. 登录华为开发者官网,确保华为项目、HarmonyOS 应用已创建完毕。

  2. 进入管理中心,依次单击 API 服务 -> 我的 API -> 新增 HMS API 服务,然后选择推送服务

    鸿蒙推送API服务.png

  3. 创建 API 服务凭证,点击“ 凭证”>“ 服务帐号密钥”>“创建凭证”,选择创建 服务帐号密钥 类型凭证。

    若创建步骤不适用,最新步骤需参考创建服务帐号密钥。在华为开发者的 API Console 上创建并下载服务帐号密钥文件,相关创建步骤及支持此类鉴权的公开 API 类型请参见 API Console 操作指南

    此处提供一个脱敏的“服务帐号密钥”文件示例:

    {
        "project_id": "dev7519896637536769923",
        "key_id": "18366af0b4b44dd8bb4a77184d04704f",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIJQgIBADANB此处省略较多字符MYT76N4WB3Y8PZV6p5gMMQ==\n-----END PRIVATE KEY-----\n",
        "sub_account": "101783233",
        "auth_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/authorize",
        "token_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/token",
        "auth_provider_cert_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/certs",
        "client_cert_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/x509?client_id=101783233"
    }
    

    创建的 服务帐号密钥(即推送证书) 请谨慎保管,云信控制台需上传 服务帐号密钥 部分信息才能实现离线推送能力。

步骤 3:在云信控制台添加鸿蒙推送证书

  1. 登录云信控制台,在控制台首页应用管理中选择应用进入应用配置页面。

  2. 顶部选择证书管理页签,进入推送证书配置页。

  3. 在对应的鸿蒙证书配置项中,单击添加证书,配置推送相关信息。

    添加鸿蒙证书.png

    • 证书名称:名称需要与 NIM 初始化时传入 pushServiceConfig.harmonyCertificateName 完全相同,上传的推送证书才会生效,例如 "DEMO_HMOS_PUSH_xxx"。

    • 应用包名:与 AppGallery Connect 中创建的 HarmonyOS 应用包名相同。

    • ProjectId: “服务帐号密钥”的 project_id 具体值,例如 "project_id": "dev7519896637536769923",则填入 dev7519896637536769923

    • KeyId: “服务帐号密钥”的 key_id 具体值,同上。

    • SubAccount: “服务帐号密钥”的 sub_account 具体值,同上。

    • PrivateKey: “服务帐号密钥”的 private_key 具体值,同上。

      private_key 需要去掉头尾的换行符,仅保留中间字段。

      // 原始 private_key
      "private_key": "-----BEGIN PRIVATE KEY-----\nXXXXXMIIJQgIBADANB此处省略较多字符MYT76N4WB3Y8PZV6p5gMMQXXXXXX==\n-----END PRIVATE KEY-----\n"
              
      // 需传入的 private_key
      XXXXXMIIJQgIBADANB此处省略较多字符MYT76N4WB3Y8PZV6p5gMMQXXXXXX==
      
  4. 填写证书信息并上传后,单击确定,即完成在云信控制台的鸿蒙推送证书的上传。

此文档是否对你有帮助?
有帮助
去反馈
  • 集成流程
  • 步骤 1:在华为者开发平台创建 HarmonyOS 应用并启用推送服务
  • 步骤 2:在华为开发者平台申请该项目 API 服务凭证
  • 步骤 3:在云信控制台添加鸿蒙推送证书