mirror of
https://gitee.com/openharmony/useriam_user_auth_framework
synced 2024-11-23 07:39:51 +00:00
8dbdc61621
Signed-off-by: Zen知仁 <xuzhiren@huawei.com> Change-Id: I0ef4181fa133882a14ea3fa1601a168bb141edd1 Signed-off-by: Zen知仁 <xuzhiren@huawei.com>
2.7 KiB
2.7 KiB
统一用户认证
简介
统一用户认证（userauth）是用户IAM子系统的基础部件之一，对外提供统一用户身份认证功能，并且开放生物特征认证API给三方应用调用。
图1 统一用户认证架构图
用户认证接口支持针对目标用户完成达到目标认证结果可信等级（ATL）的用户身份认证。其中目标ATL由业务指定，目标用户id可以由业务指定（系统服务或系统基础应用），也可以从系统上下文获取（三方应用）。
目录
//base/user_iam/user_auth
├── frameworks # 框架代码
├── interfaces # 对外接口存放目录
│ └── innerkits # 对内部子系统暴露的头文件，供系统服务使用
├── sa_profile # Service Ability 配置文件
├── services # Service Ability 服务实现
├── test # 测试代码存放目录
├── utils # 工具代码存放目录
├── bundle.json # 组件描述文件
└── userauth.gni # 构建配置
说明
接口说明
表1 统一用户认证API
| 接口名 | 描述 |
|---|---|
| getAvailableStatus(authType : AuthType, authTrustLevel : AuthTrustLevel) : number; | 指定ATL，查询是否支持目标认证方式 |
| auth(challenge: BigInt, authType : AuthType, authTrustLevel: AuthTrustLevel, callback: IUserAuthCallback): BigInt; | 指定ATL和认证方式，完成用户身份认证 |
使用说明
- 厂商在对接统一用户认证框架时，需要在可信执行环境中实现以下两个功能点：
- 认证方案生成：根据目标用户录入的认证凭据和目标认证安全等级，决策用户身份认证方案。
- 认证结果评估：根据执行器返回的身份认证结果，评估是否达到目标认证安全等级。
- 需在可信执行环境内实现useriam_auth_executor_mgr仓内，头文件
common\interface\userauth_interface.h中定义的接口，保证用户身份认证方案决策和结果评估过程的安全性。