鸿蒙 Account Kit：静默登录（五）

静默登录适用于应用卸载重装、用户换机等场景不需要用户点击登录/注册按钮即可自动获取用户的身份标识UnionID/OpenID完成用户的静默登录。一、静默登录在应用卸载重装、用户换机等场景如登录的华为账号与应用重装、换机前一致应用可通过Account Kit提供的静默登录方式即不需要用户点击登录/注册按钮即可获取用户的身份标识UnionID/OpenID完成用户的静默登录。场景说明应用卸载重装用户重新安装应用后无需再次登录用户换机用户更换设备后自动登录特点无需用户交互不需要用户点击登录/注册按钮自动获取身份标识获取UnionID/OpenID提升用户体验减少用户操作步骤二、支持版本设备类型支持版本Phone支持Tablet支持PC/2in1支持Wearable5.1.0(18)开始支持TV5.1.1(19)开始支持三、业务流程阶段说明调用登录API用户使用华为账号登录过应用应用卸载重装或换机后再进入应用时应用传forceLogin false等参数调用登录API。如华为账号已登录且API调用成功获取Authorization Code如华为账号未登录返回错误码1001502001用户关联应用账号服务端通过Authorization Code获取Access Token再获取UnionID应用完成静默登录通过Authorization Code凭证获取用户信息可以有效避免黑客通过数据遍历、身份伪造、重放攻击等手段导致的安全风险。四、开发前提在进行代码开发前请确保已完成配置项说明配置签名和指纹参考配置签名和指纹配置Client ID参考配置Client ID注意此场景无需申请账号权限。五、接口接口描述createLoginWithHuaweiIDRequest()创建账号登录请求。forceLogin参数静默登录场景设置为falseconstructor(context)创建登录请求ControllerexecuteRequest(request)通过Promise方式执行登录操作注意上述接口需在页面或自定义组件生命周期内调用。六、客户端开发6.1 导入模块import { authentication } from kit.AccountKit; import { hilog } from kit.PerformanceAnalysisKit; import { util } from kit.ArkTS; import { BusinessError } from kit.BasicServicesKit;6.2 错误码枚举export enum ErrorCode { ERROR_CODE_LOGIN_OUT 1001502001, // 账号未登录 ERROR_CODE_NETWORK_ERROR 1001502005, // 网络错误 ERROR_CODE_INTERNAL_ERROR 1001502009, // 内部错误 ERROR_CODE_USER_CANCEL 1001502012, // 用户取消授权 ERROR_CODE_SYSTEM_SERVICE 12300001, // 系统服务异常 ERROR_CODE_REQUEST_REFUSE 1001500002 // 重复请求 }6.3 创建登录请求并执行// 创建登录请求并设置参数 const loginRequest new authentication.HuaweiIDProvider() .createLoginWithHuaweiIDRequest(); // false表示静默登录重要 loginRequest.forceLogin false; // 用于防跨站点请求伪造 loginRequest.state util.generateRandomUUID(); // 执行登录请求 try { const controller new authentication.AuthenticationController(); controller.executeRequest(loginRequest).then((response: authentication.LoginWithHuaweiIDResponse) { const state response.state; if (state loginRequest.state ! state) { hilog.error(0x0000, testTag, The state is different, response state: ${state}); return; } hilog.info(0x0000, testTag, Succeeded in logging in.); const code response?.data?.authorizationCode; // 开发者处理code传给服务端 }).catch((error: BusinessError) { dealAllError(error); }); } catch (error) { dealAllError(error); }6.4 参数参数静默登录值说明forceLoginfalse不强制拉起登录页面静默获取授权state随机UUID防跨站点请求伪造6.5 错误处理函数function dealAllError(error: BusinessError): void { hilog.error(0x0000, testTag, Failed to login. Code: ${error.code}, message: ${error.message}); if (error.code ErrorCode.ERROR_CODE_LOGIN_OUT) { // 用户未登录华为账号请登录华为账号并重试或使用其他方式登录 } else if (error.code ErrorCode.ERROR_CODE_NETWORK_ERROR) { // 网络异常请检查当前网络状态并重试 } else if (error.code ErrorCode.ERROR_CODE_INTERNAL_ERROR) { // 登录失败请尝试使用其他方式登录 } else if (error.code ErrorCode.ERROR_CODE_USER_CANCEL) { // 用户取消授权 } else if (error.code ErrorCode.ERROR_CODE_SYSTEM_SERVICE) { // 系统服务异常请稍后重试 } else if (error.code ErrorCode.ERROR_CODE_REQUEST_REFUSE) { // 重复请求应用无需处理 } else { // 应用登录失败请尝试使用其他方式登录 } }七、服务端开发7.1 获取Access Token应用服务端使用Client ID、Client Secret、Authorization Code调用获取用户级凭证接口向华为账号服务器请求获取Access Token、Refresh Token。7.2 获取UnionID使用Access Token调用解析凭证接口获取用户的UnionID。7.3 用户关联应用通过查询获取的UnionID判断该用户是否已关联已关联完成用户登录未关联创建新用户绑定UnionID完成用户登录7.4 业务流程应用启动重装/换机后 ↓ 创建LoginWithHuaweiIDRequest ↓ 设置forceLoginfalse ↓ 调用executeRequest执行静默登录 ↓ 如华为账号已登录 → 获取Authorization Code 如华为账号未登录 → 返回错误码1001502001 ↓ 服务端用Authorization Code换取Access Token ↓ 用Access Token获取UnionID ↓ 根据UnionID关联用户完成静默登录7.5 注意事项forceLogin必须为false静默登录的关键参数华为账号未登录处理返回错误码1001502001需引导用户登录Token管理注意Access Token和Refresh Token的有效期八、Token过期处理项目说明有效期60分钟处理方式使用Refresh Token有效期180天通过刷新用户级凭证接口获取新的Access Token备注当Access Token失效时若应用不使用Refresh Token获取新的Access Token账号的授权信息将会失效导致使用Access Token的功能都会失败。Access Token非正常失效场景当Access Token非正常失效如修改密码、退出账号、删除设备时应用可重新登录授权获取Authorization Code向华为账号服务器请求获取新的Access Token。Refresh Token过期处理项目说明有效期180天处理方式失效后应用服务端需要通知客户端重新调用授权接口请求用户重新授权九、四种登录方式对比对比项静默登录自定义按钮登录华为账号登录按钮华为账号一键登录用户操作无需点击点击自定义按钮点击标准按钮点击标准按钮forceLoginfalsetrue--获取信息UnionIDUnionIDUnionID手机号UnionID开发者类型企业个人企业个人企业个人仅企业适用场景重装/换机自动登录UI定制需求快速集成需要手机号静默登录通过forceLoginfalse参数调用华为账号登录API在应用卸载重装或换机场景下无需用户点击即可获取Authorization Code服务端再用Code换取UnionID完成自动登录适用于企业开发者和个人开发者。