APNs鉴权配置

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

iOS应用如需使用推送服务,需在移动推送控制台做鉴权配置,鉴权配置包含两种方式:通过P12证书鉴权(certificate-based)和通过P8证书鉴权(token-based),本文详细介绍两种方式的具体配置流程。

方式一、通过P12证书鉴权

前提条件

已获取推送证书,获取方式请参见iOS配置推送证书指南

首次上传证书

  1. 登录EMAS管理控制台

  2. 查找您的项目,单击项目,进入EMAS概览页。

  3. 在顶部导航栏,选择用户增长

  4. 用户增长产品页面,从左侧导航栏选择移动推送 > 概览,打开概览页面。

  5. 如果您未配置证书,系统将提示:您好!您的开发证书未配置。单击进行配置

  6. 在弹出的提示框中,单击确认,进入APNs证书配置页签。

  7. 选择鉴权方式为P12证书,并依次上传配置好的.P12证书、输入推送证书密码

    重要

    上传有密码的推送证书才能保存成功,且必须通过验证后才能生效。

  8. 单击验证证书

    证书上传后,系统将提示:开发/生产环境证书将于yyyy-MM-dd hh-mm到期。

    image

  9. 输入测试token,单击测试推送

  10. 测试成功后,单击保存完成配置。

证书即将到期

警告

  • 距离证书到期时间30天内,界面将显示提示信息提醒您更换证书。

  • 证书到期后,您的推送业务将会中断。为避免您的业务受影响,请密切关注证书到期时间,并及时更换。

证书即将到期时,系统将展示如下提示信息,请您及时更新证书,具体请参见首次上传证书fig2

证书已经到期

警告

证书到期后,您的iOS通知推送业务将无法进行。为继续使用推送业务,请您更换证书。

证书到期后,系统将展示如下提示信息,请您及时更新证书,具体请参见首次上传证书fig2

方式二、通过P8证书鉴权

前提条件

已在苹果开发者网站获取Team ID、Key ID和P8证书。

操作步骤

获取Team ID

  1. 登录苹果开发者网站进入开发者账户。

  2. 在首页会员资格详细信息中,记录团队ID(即Team ID)。

    image

获取Key ID和P8证书

  1. 在开发者账户首页,滑动页面至计划资源区域。

  2. 单击如下标识符图标,进入Certificates, IDs & Profiles页面。

    image

  3. Certificates, IDs & Profiles页面,选择左侧导航栏的Keys,单击 “+” 新建。

    image

  4. 填写Key Name,并选择APNs服务。单击Continue进入下一步。

    image

  5. 在如下页面,单击Register

    image

  6. 单击Download下载证书,并记录Key ID

    image

上传P8证书

  1. 登录EMAS管理控制台

  2. 查找您的项目,单击项目,进入EMAS概览页。

  3. 在顶部导航栏,选择用户增长

  4. 用户增长产品页面,从左侧导航栏选择移动推送 > 概览,打开概览页面。

  5. 如果您未配置证书,系统将提示:您好!您的开发证书未配置。单击进行配置

  6. 在弹出的提示框中,单击确认,进入APNs证书配置页签。

  7. 选择鉴权方式为P8证书,并依次上传已下载的P8证书,填写Key IDTeam ID后,单击保存

    重要

    p8证书上传后预计需等十分钟后生效。

    image