From 922f61f70fcbc8115ec04fb5786b62f0d8bc8bda Mon Sep 17 00:00:00 2001 From: zengyawen Date: Wed, 19 Jul 2023 14:41:06 +0800 Subject: [PATCH] update permissions docs Signed-off-by: zengyawen --- .../security/accesstoken-guidelines.md | 52 ++++++++++--------- 1 file changed, 27 insertions(+), 25 deletions(-) diff --git a/zh-cn/application-dev/security/accesstoken-guidelines.md b/zh-cn/application-dev/security/accesstoken-guidelines.md index 09a741ecac..43c534fbc5 100644 --- a/zh-cn/application-dev/security/accesstoken-guidelines.md +++ b/zh-cn/application-dev/security/accesstoken-guidelines.md @@ -6,10 +6,18 @@ 本文将从如下场景分别介绍： -- [配置文件权限声明](#配置文件权限声明) -- [ACL方式声明](#acl方式声明) -- [向用户申请授权](#向用户申请授权) -- [user_grant权限预授权](#user_grant权限预授权) +- [访问控制授权申请指导](#访问控制授权申请指导) + - [场景介绍](#场景介绍) + - [配置文件权限声明](#配置文件权限声明) + - [Stage模型](#stage模型) + - [FA模型](#fa模型) + - [权限使用理由的文案内容规范](#权限使用理由的文案内容规范) + - [ACL方式声明](#acl方式声明) + - [向用户申请授权](#向用户申请授权) + - [Stage模型](#stage模型-1) + - [FA模型](#fa模型-1) + - [user\_grant权限预授权](#user_grant权限预授权) + - [相关实例](#相关实例) ## 配置文件权限声明 @@ -100,41 +108,35 @@ ### 权限使用理由的文案内容规范 -当申请的权限为user_grant权限时，字段reason（申请权限的原因）必填。所有的user_grant权限均被归类到某个权限组中，使用时均通过[权限组](accesstoken-overview.md#权限组和子权限)进行申请。当前支持的权限组请查看[应用权限组列表](permission-group-list.md)。 +当申请的权限为user_grant权限时，字段reason（申请权限的原因）必填。开发者需要在应用配置文件中，配置每一个需要使用的权限。 -**reason字段的内容写作规范及建议如下：** - -1. 如果需要申请“电话、信息、日历、通讯录、通话记录”这五个权限组的权限，根据工信部要求，需要展示具体子权限的内容与用途。 - - **建议句式**： - - 中文：包括子权限A和子权限B，用于某事。 - - 英文：Includes: PermissionA and PermissionB. This is used to do/for something. - - > **说明：**
中文使用逗号分割，英文使用句点分割。 +但在实际向用户弹窗申请授权时，user_grant权限将会以[权限组](accesstoken-overview.md#权限组和子权限)向用户申请。当前支持的权限组请查看[应用权限组列表](permission-group-list.md)。 - **示例**：用于获取通话状态和移动网络信息，用于安全运营和统计计费服务。 +**reason字段的内容写作规范及建议如下：** -2. 如果当前权限组申请不涉及子权限。 +1. 保持句子简洁、不要加入多余的分割符号。 **建议句式**：用于某事。 **示例**：用于扫码拍照。 - > **说明：**
保持句子简洁、不要加入多余的分割符号。 - -3. 用途描述的字串建议小于72个字符（即36个中文字符，UI界面显示大约为两行）。不能超过256个字符，以免在多语言适配后体验不好。 +2. 用途描述的字串建议小于72个字符（即36个中文字符，UI界面显示大约为两行）。不能超过256个字符，以免在多语言适配后体验不好。 -4. 如果不写，将展示默认的申请理由。 +3. 如果不写，将展示默认的申请理由。 **权限使用理由展示方式：** -向用户申请授权时，弹窗将以权限组维度显示，但在应用权限配置时，需要配置每个需要使用的子权限。 +权限使用理由有两个展示途径：授权弹窗界面和“设置（Settings）”界面。“设置”的具体路径：设置-隐私-权限管理-某应用某权限详情 + +1. 如果是申请“电话、信息、日历、通讯录、通话记录”这五个权限组中的权限，根据工信部要求，将展示具体子权限的内容与用途。 + + **句式**：包括子权限A和子权限B，用于某事。 + + **样例**：用于获取通话状态和移动网络信息，用于安全运营和统计计费服务。 -该用途有两个展示途径：授权弹窗界面和“设置（Settings）”界面。“设置”的具体路径：设置-隐私-权限管理-某应用某权限详情 +2. 如果是申请其他权限组中的权限。系统将使用权限组内当前被申请的第一个子权限的使用理由，作为该权限组的使用理由进行展示。组内的排序，固定按照权限管理内排列的权限组数组顺序。 -系统将使用权限组内当前被申请的第一个子权限的使用理由，作为该权限组的使用理由进行展示。组内的排序，固定按照权限管理内排列的权限组数组顺序。举例说明：权限组A = {权限A, 权限B, 权限C}；申请传入的是{权限C, 权限B}，界面将展示权限B中的权限使用理由。 + 举例说明：权限组A = {权限A, 权限B, 权限C}；申请传入的是{权限C, 权限B}，界面将展示权限B中的权限使用理由。 ## ACL方式声明 -- GitLab