产品功能

产品简介

能力介绍

一键登录：SDK获取当前流量卡对应的token，通过服务端可置换当前流量卡的手机号码。

本机校验：SDK获取当前流量卡对应的token，提供手机号码，通过服务端可校验提供的手机号是否为当前流量卡的手机号码。

注意：本机校验和一键登录是两个单独的能力，两者的token不能互用，否则会报"应用能力不匹配"。

能力优势

● 降低应用注册/登录门槛，减轻用户记忆负担，提高用户体验；

● 降低对用户身份、通信行为等属性验证的繁琐步骤，助力企业完善风险管控系统

● 取号成功率高达99.9%。

● 两步完成注册登录，耗时仅需1~3秒。

● 实现机卡不分离，提高安全等级

隐私条款

根据工信部要求，需要在打开 APP 时弹出相关用户隐私条款政策，充分告知关于用户隐私数据收集范围及用途。 具体详见SDK初始化合规性指南。

使用场景

App 注册/登录页面进行一键登录并建立账户，也可以使用在任何需要获取手机号的场景。例如：手机号绑定环节，修改/找回密码环节，支付环节验证手机号等等

能力申请

接入方需在创蓝控制台认证公司资质，报备应用信息，以获取 appid、appkey 等参数用于 SDK 集成。安卓、iOS、H5需分开申请 appid。

SDK 评估

SDK 支持系统

Android4.1 以上，iOS8.0 以上

SDK 集成增量体积

Android SDK：全部增量:860kb

aar 资源包 470kb，so 资源包根据用户自身集成

主流 3 个架构（arm64-v8a，armeabi，armeabi-v7a）：485kb

armeabi-v7a 一个架构：288kb

iOS SDK：ipa 增量 1.3M 注：上述包体大小取于2.3.6.0版本，后续版本更新可能会有变化

SDK 取号的原理

通过运营商的数据网关获取号码，因此需要用户开启数据网络量并且给予应用蜂窝数据权限才能使用，当信号弱或者网络有干扰时，时延会高于平均值，取号成功率降低。

初始化

主要用于账号验签，以及相关配置信息拉取，首次调用有网络请求，不经初始化 SDK 无法调用。

取号阶段

在用户无感知的情况下进行网络判断、蜂窝数据网络切换和网关取号等操作（以上操作均需消耗一定时间），并缓存凭证 scrip，以便在用户登录时大大缩短拉起授权页的耗时（因为取号已完成）。

成功获取到临时令牌

取号所需网络环境

运营商取号能力是通过数据网关实现，取号过程须在数据流量打开的情况下才能进行。（WiFi 和数据流量同时打开时，SDK 会强制切换到数据流量执行取号逻辑）

用户如果关闭数据流量、或改变手机的 IP 地址（如 VPN 代理，路由器 VPN、手机 VPN、手机热点），都将无法取号；若当前信号弱或者网络有干扰时，时延会高于平均值，取号成功率降低

授权阶段

1.创蓝 SDK 必须在授权页上会展示手机掩码提供给用户确认，经由用户授权才能正常执行获取号码的行为。

2.运营商根据来自 SIM 卡的访问请求，识别该数据流量对应的手机号码，并展示运营商授权页。

授权页的拉起

由用户触发或者自动触发的方式执行拉取授权页方法

当取号缓存 scrip 有效时，SDK 能几乎无耗时地拉起授权页；

当取号缓存 scrip 已失效（用户换卡、缓存有效期已过等）或不存在时，SDK 需要先消耗一定时间进行取号，取号成功才能拉起授权页。此取号阶段的用户交互（如增加loading）由业务方自行处理。

授权页元素的自定义和插入自定义控件

对页面内的元素的自定义，请参考 SDK 开发文档的章节；

若希望在页面中插入其他第三方登录方式，或其他内容，可通过插入自定义控件实现，请参考 SDK 开发文档的章节

注：自定义的控件不允许覆盖 SDK 默认的 UI，如运营商授权协议

一键登录阶段

用户授权并点击一键登录，发起一键登录授权请求后，SDK 后台向运营商发起校验请求，运营商校验通过后传递 token 到SDK，SDK通过回调返回给App 客户端

token 获取超时时间

移动/联通/电信默认超时间隔：5 秒（业务提供方会根据线上综合情况评估，超时时间可能会有调整）

token 获取的限制

同一用户（手机号）10 分钟内获取 token 且未使用的数量不超过 30 个

token 有效时间

移动/联通/电信 token 有效期最短10秒钟（建议获取后直接置换手机号，防止token失效）

服务端接口联调

服务端需要凭 token 置换用户授权的本机号码，接口可报备服务端出口 IP 地址后才能正常使用，不建议从客户端直接调用。

使用条件

1.支持中国移动 3/4G/5G、联通 3/4G/5G、电信 4G/5G 的取号能力，在 3G 网络下时延会更高
2.支持单数据网络、数据网络与 WiFi 网络双开，不支持单 WiFi 网络
3.对于双卡手机，只对当前流量卡取号，双卡均未开数据流量 SDK 将会返回错误码

OPPO 等部分终端网络问题

部分低系统版本的oppo 手机（一般6.0~9.0系统）第一次登录必须使用纯流量环境。

由于 oppo 操作系统增加了应用的数据网络使用权限，在手机 wifi 和数据网络同时打开时，应用首次打开，将默认使用 wifi 数据通道，且无法通过 SDK 强制切换到数据通道取号，会导致取号失败

客户案例

解决问题

1、打印报错信息，根据报错信息，查看返回码文档及常见问题文档，并进一步解决问题
2、技术支撑邮箱：wangg@253.com