Quick BI支持添加飞书用户为组织成员。在实际应用时,组织管理员可以绑定Quick BI飞书微应用并给飞书接口授权。本文为您介绍如何进行飞书接口授权。
前提条件
您已下载并注册飞书。
使用限制
仅专业版支持该功能。
步骤一:在飞书中创建自建微应用
登录飞书开放平台,单击创建应用。
在创建应用页面,选择企业自建应用,并填入应用名称、应用描述和应用图标后,单击确定创建。
在企业自建应用列表中,单击目标应用的名称,进入应用详情页面。
单击左侧导航栏的凭证与基础信息,在应用凭证区域,获取App ID和App Secret。
步骤二:在飞书中配置自建微应用
用于配置微应用的域名、重定向URL和应用所需的权限。
单击左侧导航栏的应用功能网页,按照下图操作,配置自建应用(Quick BI应用)主页的域名。
(可选)
单击左侧导航栏的应用功能机器人,按照下图操作,开通飞书机器人。
若您选择飞书通知、飞书群的方式接收订阅或告警信息时,需要开启飞书机器人。
单击左侧导航栏的安全设置,按照下图指引,配置应用安全。
配置应用安全时,您需要在重定向URL中添加用于登录验证的URL和用于用户绑定的URL:
登录验证的URL:
<Quick BI服务域名>/authx/feishu/identity/verify
用户绑定的URL:
<Quick BI服务域名>/api/v2/organization/feishu/binding
Quick BI服务域名,以具体环境域名为准。例如:Quick BI公共云环境域名为
bi.aliyun.com
;Quick BI金融云环境域名为bi-finance.aliyun.com
,则:登录验证的URL为
https://bi.aliyun.com/authx/feishu/identity/verify
用户绑定的URL为
https://bi.aliyun.com/api/v2/organization/feishu/binding
单击左侧导航栏的权限管理,按照下图指引,配置应用权限。
配置应用权限时,需要参考以下权限进行配置:
必须配置以下权限:
基础权限:
获取用户user ID
获取用户基本信息
获取企业信息
获取用户组织架构信息
获取部门组织架构信息
获取部门基础信息
获取用户组信息
更新用户组信息
以应用身份访问通讯录(历史版本)
以应用身份读取通讯录
飞书通知权限
选择飞书通知的方式接收监控告警时,必须配置以下权限:
获取与发送单聊、群组消息
给多个用户批量发消息
选择飞书通知的方式接收订阅时,必须配置以下权限:
获取与发送单聊、群组消息
给多个用户批量发消息
获取上传图片或文件资源
飞书群权限
选择飞书群的方式接收监控告警时,无需额外配置权限。
选择飞书群的方式接收订阅时,必须配置以下权限:
获取上传图片或文件资源
可能会用到的权限:
获取用户邮箱信息
获取用户手机号
通过手机号或邮箱获取用户ID
获取用户雇佣信息
搜索用户
已添加权限的列表见下图。如果用户需要升级权限,请参见升级用户权限。
单击左侧导航栏的应用发布版本管理与发布,按照下图指引,创建版本。
企业自建应用若要供企业内其他用户使用,或应用目录应用若要上架飞书应用目录,都必须发布一个版本。
您可以单击创建版本或点击创建,进行创建版本。
在版本详情页面,配置以下参数,并单击保存。
参数
描述
示例
应用版本号
设置微应用的版本号。
1.0.0
PC客户端默认的应用功能
您通过工作台访问应用时打开的功能。
网页
更新说明
对微应用版本变更的说明。
无
可用性状态
支持修改为指定人员或企业所有员工。
更新应用版本号时,若权限不敏感建议将可用性状态调整为所有员工。
所有员工
说明本文的后续操作中,系统会将飞书的通讯录同步至Quick BI中,故本示例必须选择所有员工。
配置完成后,单击申请发布。
则应用状态更新为审核中。
步骤三:在管理后台审核并配置微应用
超级管理员登录管理后台,审核应用。
在顶部菜单栏单选择管理后台,进入飞书管理后台。
在左侧导航栏选择工作台应用审核,在应用审核页面单击通过。
在左侧导航栏单击应用管理,在已安装的应用中,找到目标应用并单击操作列的配置。
确保应用可用成员为全员成员。
升级用户权限
在飞书管理后台,在左侧导航栏单击安全用户权限,可以针对组织架构的可见范围进行升级。
步骤四:在Quick BI中绑定飞书
登录Quick BI控制台。
在Quick BI首页,按照下图指引,配置接口信息。
填入AppId和APPSecret,并单击保存。
后续步骤
配置完成后,您可以在Quick BI中绑定飞书账号,将飞书账号所在的组织通讯录体系同步到Quick BI。请参见添加飞书账号为组织成员。