====== 第三方推送异常情况说明 ======

----

IM 推送服务支持第三方厂商推送通道，包含苹果 APNS 推送、小米推送、华为推送、魅族推送、vivo 推送、OPPO 推送以及 Google FCM 推送。

''当第三方推送通道返回证书不可用相关报错时，环信 IM 推送服务会对相应证书进行禁用处理，封禁后会向 console 后台注册账号（超级管理员）的邮箱和手机号发送通知，重新上传可用证书后即可正常使用。''

本文档主要说明各第三方通道的因异常报错会导致证书被禁用的情况、以及建议的处理方案。

===== 异常说明以及处理建议 =====

可能导致证书被禁用的异常原因如下：

|第三方厂商|异常禁用原因|第三方错误码|处理建议|
|vivo 推送|appId 不存在|10205|证书名称上传错误，请核对证书信息。|
|小米推送|认证失败|21301|证书密钥上传错误，请核对密钥。|
|OPPO 推送|无效的 App Key 参数|14|证书名称上传错误，请核对证书信息。|
|OPPO 推送|无效的签名|16|证书密钥上传错误，请核对密钥。|
|魅族推送|appId 不合法|110000|证书名称上传错误，请核对证书信息。|
|魅族推送|签名认证失败|1006|证书密钥上传错误，请核对密钥。|
|华为推送|参数无效|1101|证书名称或证书密钥上传错误，请核对证书信息。|
|Google FCM 推送|无效的 token|无|证书密钥无效，请核对证书信息以及证书可用性。|
|苹果 APNS 推送|keystore password was incorrect|无|证书密钥上传错误，请核对密钥。|
|苹果 APNS 推送|certificate_revoked|无|证书被撤销，请重新申请证书。|
|苹果 APNS 推送|certificate_expired|无|证书过期，请重新申请证书。|
|苹果 APNS 推送|InvalidProviderToken|无|P8 证书无效，请重新申请证书。|
|苹果 APNS 推送|Could not find private key header/footer|无|P8 证书文件内容识别错误，请重新上传正确证书。|