本文为您介绍了新旧密钥及版本的划分、密钥逻辑等信息。
新旧密钥及版本的划分
新旧密钥和新旧SDK版本的划分如下:- 新密钥与旧密钥的划分:新密钥是指采用新结构的密钥,同理,旧密钥是指采用旧结构的密钥。新旧密钥划分的时间界限为2020-10-20,在该时间点之前创建的方案号称为旧方案号,该时间点之后创建的方案号称为新方案号。
- 新版SDK与旧版SDK的划分:只有Android端SDK区分新旧版本。一键登录和本机号码校验的新版SDK是指版本在v2.8.4和v9.4.0及以上的SDK,其余功能的SDK版本不涉及此问题。
密钥逻辑
若您开启一个新功能,旧认证方案的密钥会自动更新一次,SDK也需要更换成最新的密钥,否则无法使用此功能。密钥的处理逻辑为:- 对于旧方案号,旧方案的密钥信息没有携带认证相关的信息,例如您想使用活体认证功能,则需要更换为最新版本的SDK,并且要更换为最新的密钥。
- 对于新方案号,如果想用号码认证服务的功能,iOS可正常使用,Android SDK需要保证为新版本,否则会报密钥解析错误600017。
注意 由于低版本的Android SDK不兼容新方案号,若客户的方案号存在于服务端,需要由App主动拉取,在服务端更新密钥时需要对App或者SDK版本号做判断区分。如果密钥信息是保存在App客户端,则无需考虑该问题。
密钥配对
SDK | 配对详情 | 功能是否可正常使用 |
---|---|---|
Android SDK | 旧版SDK与旧密钥进行配对 | 可正常使用。 |
新版SDK与新密钥进行配对 | ||
旧版SDK与新密钥进行配对 | 功能不可使用。需保证SDK版本为新版,否则会报密钥解析错误600017,建议升级到最新版本的SDK。 | |
新版SDK与旧密钥进行配对 | 不可使用。 | |
iOS SDK(不区分新旧版) | SDK与新密钥进行配对 | 可正常使用。 |
SDK与旧密钥进行配对 | 不可使用。 |