自建应用的权限介绍和审核规则推荐

自建应用的权限介绍和审核规则推荐

本文阅读时长:6 分钟
一、简介
🔖
谁能操作:超级管理员或拥有全部应用权限的管理员
管理员可以在自建应用的审核规则中,为开发者设置“需审核的权限”,这不仅可以降低企业内自建应用的审核成本,还能有效提升审核效率。
本文将从应用权限的类型和等级划分、平台推荐的审核规则两方面,为管理员设置审核规则提供参考和建议。
二、说明
  1. 应用权限的定义
应用权限是一种控制机制,可通过 Lark 提供的服务端 API,获取或修改企业内的数据,如获取企业组织架构、操作人员入职离职、更新云文档、发送消息等。
Lark 为每个 API 都设计了对应的应用权限,不同的应用权限能够访问或操作不同的企业信息数据。
企业管理员可以在应用提交发布后,对应用申请的应用权限进行审核。审核通过后,应用才开通了该权限,才可以调用服务端 API 或监听已订阅的事件列表。有关企业内可用权限的具体信息,请参考权限列表
管理员可以从“应用权限类型”和“应用权限等级”两个维度,判断是否可以将不涉及敏感数据的权限设置为免审权限。
1.1 应用权限的类型
根据调用 API 时使用的身份,应用权限可分为两种类型:
250px|700px|reset
  • 应用身份权限:即通过 Tenant Access Token 调用 API,API 所能操作的数据资源范围受限于应用的身份所能操作的资源范围。
  • 用户身份权限:即通过 User Access Token 调用 API,API 所能操作的数据资源范围受限于用户的身份所能操作的资源范围。
权限类型
描述
场景示例
应用身份权限 tenant_access_token
以 tenant_access_token 调用 API 或订阅事件时,需要申请应用身份权限。
假设有一个应用“My bot”,该应用:
  • 调用创建多维表格接口时,如果以 tenant_access_token 调用,则新创建的多维表格所有者是“My bot”。
  • 订阅云文档变更事件时,如果以 tenant_access_token 订阅,则仅能订阅“My bot”作为拥有者或管理员的云文档变更,无法接收其他云文档变更通知。
用户身份权限 user_access_token
以 user_access_token 调用 API 或订阅事件时,需要申请用户身份权限。
假设有一个应用“My bot”,该应用:
  • 调用创建多维表格接口时,如果以 user_access_token 调用,且该 token 代表的用户是“小美”,则新创建的多维表格所有者是“小美
  • 订阅云文档变更事件时,如果以 user_access_token 订阅,且该 token 代表的用户是“小美”,则仅能订阅“小美”作为拥有者或管理员的云文档变更,无法接收其他云文档变更通知。
1.2 应用权限的等级划分
在商店应用、自建应用两类不同的应用中,权限存在不同的等级划分。你可以通过下表了解不同应用类型中的权限等级划分情况。
自建应用的应用权限,按照等级可分为两类:
  • 普通权限:该权限访问的数据敏感程度不高,如访问应用 ID、应用配置、接口名称等应用运行所必需的数据,因此无需审核,申请后立即生效。
  • 高级权限:该权限访问的数据敏感程度较高,如需要访问文档、日历日程、IM 消息、头像、地理位置等涉及内容及个人信息的数据。申请后,需要创建版本并提交审核,由应用管理员审核通过后才可生效。
  1. 推荐的审核规则
基于应用权限的类型和等级,平台推荐以下审核规则。有关 API 的具体信息,请参考 API 权限列表
权限等级/类型
应用身份调用
用户身份调用
普通权限
此类权限不涉及企业敏感字段信息,可设置为“免审”。
高级权限
此类权限涉及企业敏感字段信息,需要审核。
:如无必要原因,申请高级权限时不会通过审核。
此类权限中,应用代表用户进行操作。使用应用时,用户需要给应用授予权限后才可以使用。因此,除特定的敏感权限外,大部分权限可设置为“免审”。
:特定的敏感权限,如通讯录、消息等,需要审核,以提升企业安全性。
作者Lark 帮助中心
最后更新于2025-01-17
评价此内容
提交成功,感谢你的反馈!
未能解决你的问题?请联系在线客服
0
将帮助中心添加到导航栏
方便下次快速访问帮助中心
* 通过浏览器添加,Lark 需升级到 V7.6 及以上版本
暂不添加
添加到导航栏
rangeDom