更新记录

0.1.0（2026-10-28） 下载此版本

• 首发：阿里云号码认证一键登录 UTS 插件（App 原生端 + H5），与移动认证插件 reglow-mobile-login 二选一按需引入
• 统一取号 API：preAuth() 预取号（检测本机运营商与 SDK 可用性）、getPhoneNumber() 取号，返回 { operator, token, userInformation }
• 平台覆盖：Android（AAR 2.14.24）、iOS（xcframework 2.14.19）、HarmonyOS（HAR 2.0.25）原生 SDK，分别由 utssdk/app-android / app-ios / app-harmony 实现；H5 走阿里号码认证 Web SDK（numberAuth-web-sdk.js，线上加载）
• 开发期内置 mock（operator='mock'）：未配置 ALI_AUTH_SECRET 时自动降级 mock 凭证，配合后端 reglow-pyproject-starter 的 POST /api/v1/auth/operator/login（mock provider）即可跑通「一键登录 → 授权弹窗 → 自动注册 → 登录」
• 取号凭证由后端 ali provider（阿里云号码认证 GetMobile OpenAPI）校验，请求方传 operator=ali

平台兼容性

uni-app x(5.31)

其他

reglow-ali-login（阿里云号码认证一键登录 UTS 插件）

阿里云号码认证一键登录插件，提供统一取号 API：

• preAuth()：预取号，检测本机运营商与 SDK 可用性
• getPhoneNumber()：取号，返回 { operator, token, userInformation }（调用前须先弹授权协议）

移动认证为独立插件 reglow-mobile-login（operator=mobile / mobile-h5）。 两个插件二选一按需引入：用阿里装本插件，用移动装 mobile 插件，各只带自己的 SDK（按需打包）。

平台覆盖

阿里云号码认证主要覆盖 App 原生端与 H5；小程序场景建议使用移动认证（reglow-mobile-login）。

开发期（mock）

默认内置 mock 实现（operator='mock'），配合后端 reglow-pyproject-starter 的 POST /api/v1/auth/operator/login（mock provider）即可跑通： 一键登录 → 授权弹窗 → 自动注册 → 登录。

接入真实 SDK（阿里云号码认证）

1. 申请参数

在阿里云控制台开通「号码认证」服务：

• 客户端 SDK 密钥串：控制台生成，填入各平台文件顶部的 ALI_AUTH_SECRET；
• 服务端 OpenAPI 凭证（AccessKey）：控制台申请，用于后端 ali provider 的 GetMobile 校验。

2. 填写客户端参数

把各平台文件顶部的 ALI_AUTH_SECRET 替换为真实值； iOS 端需在 App 启动（App.uvue onLaunch）调用 register() 注册 SDK； 未配置时自动降级为 mock 凭证，开发期流程可继续跑通。

3. 后端配置

.env 注入（见 reglow-pyproject-starter/backend/.env.example）：

OPERATOR_PROVIDER=ali
OPERATOR_ALI_ENDPOINT=dypnsapi.aliyuncs.com
OPERATOR_ALI_ACCESS_KEY_ID=<AccessKeyId>
OPERATOR_ALI_ACCESS_KEY_SECRET=<AccessKeySecret>

后端 ali provider 已实现（官方 Python SDK GetMobile OpenAPI）， 测试见 backend/tests/test_operator_login.py。

4. H5 特别说明

• 集成页面地址（referer）与请求来源（origin）需在阿里云号码认证服务中报备；
• 取号仅支持数据流量，wifi / 热点下会失败；
• H5 端 numberAuth-web-sdk.js 加载地址与签名规则以阿里官方文档为准（插件内已留 TODO）。

注意

• 取号前必须先向用户展示授权协议并获得同意（合规要求）；
• 平台文件最终编译需在 HBuilderX 运行到 Android / iOS / HarmonyOS 真机时验证；
• 阿里 App 原生端与 H5 的 token 都通过后端 ali provider（GetMobile）校验，请求方传 operator=ali。