diff --git a/zh-cn/application-dev/security/accesstoken-guidelines.md b/zh-cn/application-dev/security/accesstoken-guidelines.md index 09a741ecacb682613dfe3b012bc389498f50c847..43c534fbc58fc9f8070fa13b6ac8445041b23e7d 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方式声明