Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
62095070
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
62095070
编写于
7月 08, 2022
作者:
Z
zengyawen
提交者:
Gitee
7月 08, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/security/accesstoken-overview.md.
Signed-off-by:
N
zengyawen
<
zengyawen1@huawei.com
>
上级
fdccd262
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
52 addition
and
46 deletion
+52
-46
zh-cn/application-dev/security/accesstoken-overview.md
zh-cn/application-dev/security/accesstoken-overview.md
+52
-46
未找到文件。
zh-cn/application-dev/security/accesstoken-overview.md
浏览文件 @
62095070
# 访问控制开发概述
## 简介
ATM(AccessTokenManager)是OpenHarmony上基于AccessToken构建的统一的应用权限管理能力。
ATM(AccessTokenManager)是OpenHarmony上基于AccessToken构建的统一的应用权限管理能力。
默认情况下,应用只能访问有限的系统资源。但某些情况下,应用为了扩展功能的诉求,需要访问额外的系统或其他应用的数据(包括用户个人数据)、功能。系统或应用也必须以明确的方式对外提供接口来共享其数据或功能。OpenHarmony提供了一种访问控制机制来保证这些数据或功能不会被不当或恶意使用,即应用权限。
...
...
@@ -24,10 +23,30 @@ ATM(AccessTokenManager)是OpenHarmony上基于AccessToken构建的统一的应
应用使用权限的工作流程如图所示。
![](
figures/figure1.png
)
![](
figures/figure1.jpg
)
![](
figures/permission-application-process.png
)
1:应用APL等级与权限等级的匹配关系请参考
[
权限等级说明
](
#权限等级说明
)
。
2:权限的授权方式分为user_grant(用户授权)和system_grant(系统授权),具体请参考
[
权限类型说明
](
#权限类型说明
)
。
3:应用可以通过ACL(访问控制列表)方式申请高级别的权限,具体请参考
[
访问控制列表(ACL)说明
](
#访问控制列表acl说明
)
。
## 权限使用场景说明
### 基本原则
在进行权限的申请和使用时,需要满足以下基本原则:
-
应用申请的权限,都必须有明确、合理的使用场景和功能说明,确保用户能够清晰明了地知道申请权限的目的、场景、用途;禁止诱导、误导用户授权;应用使用权限必须与申请所述一致。
-
应用权限申请遵循最小化原则,只申请业务功能所必要的权限,禁止申请不必要的权限。
-
应用在首次启动时,避免频繁弹窗申请多个权限;权限须在用户使用对应业务功能时动态申请。
-
用户拒绝授予某个权限时,与此权限无关的其他业务功能应能正常使用,不能影响应用的正常注册或登录。
-
业务功能所需要的权限被用户拒绝且禁止后不再提示,当用户主动触发使用此业务功能或为实现业务功能所必须时,应用程序可通过界面内文字引导,让用户主动到“系统设置”中授权。
-
当前不允许应用自行定义权限,应用申请的权限应该从
[
已有的权限列表
](
permission-list.md
)
中选择。
### 场景示例
下面列举两种应用需要使用权限的常见场景,用作参考。
...
...
@@ -46,18 +65,6 @@ ATM(AccessTokenManager)是OpenHarmony上基于AccessToken构建的统一的应
(1) ohos.permission.CAMERA 允许应用使用相机拍摄照片和录制视频。
### 基本原则
在进行权限的申请和使用时,需要满足以下基本原则:
-
应用申请的权限,都必须有明确、合理的使用场景和功能说明,确保用户能够清晰明了地知道申请权限的目的、场景、用途;禁止诱导、误导用户授权;应用使用权限必须与申请所述一致。
-
应用权限申请遵循最小化原则,只申请业务功能所必要的权限,禁止申请不必要的权限。
-
应用在首次启动时,避免频繁弹窗申请多个权限;权限须在用户使用对应业务功能时动态申请。
-
用户拒绝授予某个权限时,与此权限无关的其他业务功能应能正常使用,不能影响应用的正常注册或登录。
-
业务功能所需要的权限被用户拒绝且禁止后不再提示,当用户主动触发使用此业务功能或为实现业务功能所必须时,应用程序可通过界面内文字引导,让用户主动到“系统设置”中授权。
-
当前不允许应用自行定义权限,应用申请的权限应该从已有的权限列表中选择。
## 权限等级说明
根据接口所涉数据的敏感程度或所涉能力的安全威胁影响,ATM模块定义了不同开放范围的权限等级来保护用户隐私。
...
...
@@ -100,33 +107,6 @@ ATM(AccessTokenManager)是OpenHarmony上基于AccessToken构建的统一的应
鉴于该类型权限对系统的影响程度非常大,目前暂不向任何应用开放。
### 访问控制列表(ACL)说明
如上所述,权限等级和应用的APL等级是一一对应的。原则上,
**拥有低APL等级的应用默认无法申请更高等级的权限**
。
访问控制列表ACL(Access Control List)提供了解决低等级应用访问高等级权限问题的特殊渠道。
**场景举例:**
开发者正在开发应用A,该应用的APL等级为normal级别。由于功能场景需要,应用A必须申请到权限B和权限C,其中,权限B的权限等级为system_basic,权限C的权限等级为normal级别。
在权限B的ACL使能为TRUE的情况下,此时,开发者可以使用ACL方式来申请权限B。
ACL方式的工作流程可以参考
[
ACL方式使用说明
](
#ACL方式使用说明
)
。
权限的ACL使能情况可查阅
[
权限定义列表
](
permission-list.md
)
。
### ACL方式使用说明
如果应用申请的权限中,存在部分权限的权限等级比应用APL等级高,开发者可以选择通过ACL方式来解决这个等级不匹配的问题。
在上述的
[
授权流程
](
#不同权限类型的授权流程
)
的基础上,应用需要进行额外的ACL声明步骤。
应用除了需要在config.json文件声明所需申请的权限,还需要在应用的
[
profile文件中声明
](
accesstoken-guidelines.md#acl方式声明
)
不满足申请条件的高等级权限,接下来的授权流程不变。
**ACL申请方式须知**
开发应用安装包时,需要修改应用的profile文件,在文件的"acl"字段声明目标的访问控制列表,并使用profile签名工具生成证书。具体签名流程可以查看页面
[
Hap包签名工具指导
](
hapsigntool-guidelines.md
)
。
## 权限类型说明
根据授权方式的不同,权限类型可分为system_grant(系统授权)和user_grant(用户授权)。
...
...
@@ -153,15 +133,15 @@ ACL方式的工作流程可以参考[ACL方式使用说明](#ACL方式使用说
应用获取权限的流程取决于相应的权限类型:
-
如果目标权限是system_grant类型,开发者需要在
config.json文件中
[
声明目标权限
](
accesstoken-guidelines.md
)
,系统会在安装应用时为其进行权限预授予。
-
如果目标权限是system_grant类型,开发者需要在
配置文件中
[
声明目标权限
](
accesstoken-guidelines.md#权限申请声明
)
,系统会在安装应用时为其进行权限预授予。
-
如果目标权限是user_grant类型,开发者需要先在
config.json文件中
[
声明目标权限
](
accesstoken-guidelines.md
)
,然后运行时发送弹窗,请求用户授权。
-
如果目标权限是user_grant类型,开发者需要先在
配置文件中
[
声明目标权限
](
accesstoken-guidelines.md#权限申请声明
)
,然后运行时发送弹窗,请求用户授权。
### user_grant权限请求授权的步骤详解
在应用需要获取user_grant权限时,请完成以下步骤:
1.
在
config.json
文件中,声明应用需要请求的权限,详见
[
访问控制开发指导
](
accesstoken-guidelines.md
)
。
1.
在
配置
文件中,声明应用需要请求的权限,详见
[
访问控制开发指导
](
accesstoken-guidelines.md
)
。
2.
将应用中需要申请权限的目标对象与对应目标权限进行关联,让用户明确地知道,哪些操作需要用户向应用授予指定的权限。
...
...
@@ -172,7 +152,33 @@ ACL方式的工作流程可以参考[ACL方式使用说明](#ACL方式使用说
**注意事项:**
-
每次执行需要目标权限的操作时,应用都必须检查自己是否已经具有该权限。
-
如需检查用户是否已向您的应用授予特定权限,可以使用
[
verifyAccessToken
](
../reference/apis/js-apis-abilityAccessCtrl.md
)
函数,此方法会返回
[
PERMISSION_GRANTED
](
../reference/apis/js-apis-abilityAccessCtrl.md
)
或
[
PERMISSION_DENIED
](
../reference/apis/js-apis-abilityAccessCtrl.md
)
。具体的示例代码可以查看
[
访问控制开发指导
](
accesstoken-guidelines.md
)
。
-
user_grant权限授权要基于用户可知可控的原则,需要应用在运行时主动调用系统动态申请权限的接口,系统弹框由用户授权,用户结合应用运行场景的上下文,识别出应用申请相应敏感权限的合理性,从而做出正确的选择。
-
即使用户向应用授予过请求的权限,应用在调用受此权限管控的接口前,也应该先检查自己有无此权限,而不能把之前授予的状态持久化,因为用户在动态授予后还可以通过设置取消应用的权限。
## 访问控制列表(ACL)说明
如上所述,权限等级和应用的APL等级是一一对应的。原则上,
**拥有低APL等级的应用默认无法申请更高等级的权限**
。
访问控制列表ACL(Access Control List)提供了解决低等级应用访问高等级权限问题的特殊渠道。
**场景举例:**
开发者正在开发应用A,该应用的APL等级为normal级别。由于功能场景需要,应用A必须申请到权限B和权限C,其中,权限B的权限等级为system_basic,权限C的权限等级为normal级别。
在权限B的ACL使能为TRUE的情况下,此时,开发者可以使用ACL方式来申请权限B。
ACL方式的工作流程可以参考
[
ACL方式使用说明
](
#ACL方式使用说明
)
。
具体某个权限能否通过ACL使能情况可查阅
[
权限定义列表
](
permission-list.md
)
。
### ACL方式使用说明
如果应用申请的权限中,存在部分权限的权限等级比应用APL等级高,开发者可以选择通过ACL方式来解决这个等级不匹配的问题。
在上述的
[
授权流程
](
#不同权限类型的授权流程
)
的基础上,应用需要进行额外的ACL声明步骤。
应用除了需要在config.json文件声明所需申请的权限,还需要在应用的
[
profile文件中声明
](
accesstoken-guidelines.md#acl方式声明
)
不满足申请条件的高等级权限,接下来的授权流程不变。
**ACL申请方式须知**
开发应用安装包时,需要修改应用的profile文件,在文件的"acl"字段声明目标的访问控制列表,并使用profile签名工具生成证书。具体签名流程可以查看页面
[
Hap包签名工具指导
](
hapsigntool-guidelines.md
)
。
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录