新闻资讯

飞书授权配置说明

向日葵 | 2022-08-31

1. 在飞书中创建自建应用

(1)登录飞书开放平台 ,点击 <创建企业自建应用>

(2)在创建应用页面,选择企业自建应用,并填入应用名称、应用描述和应用图标后,确认无误后点击 <创建>

(3)在企业自建应用列表中,选择 “目标应用” ,进入应用详情页面。

(4)点击左侧导航栏【凭证与基础信息】,在应用凭证区域,获取App IDApp Secret。(需记录)

(5)在步骤4中将获取的App IDApp Secret填入向日葵管理平台中。

2. 配置自建应用授权

用于配置重定向URL和应用所需的权限,从而实现成员使用飞书扫码登录的效果。
(1)点击左侧导航栏的【开发配置】-【安全设置】输入重定向URL:https://webapi.sunlogin.oray.com/feishu/redirect
注意: 若为私有化部署环境,请联系专属客户经理获取你的重定向URL地址。

(2)点击左侧导航栏的 【开发配置】->【事件与回调】 ,在加密策略界面获取 【Encrypt Key】 。在步骤4中需将 【Encrypt Key】 填入向日葵管理平台中。(若为空则自定义编辑或重置后复制)

(3)点击左侧导航栏的【开发配置】->【权限管理】 ,按照下图指引,配置应用权限,配置权限如下,勾选后点击 <批量开通>

分类 权限
通讯录 获取通讯录基本信息
获取部门基础信息
获取通讯录部门组织架构信息
获取用户基本信息
获取用户组织架构信息
获取用户邮箱信息
获取用户受雇信息
获取用户 user ID
获取用户手机号
企业信息 获取企业信息
消息与群组 以应用的身份发消息

(4)为了方便接收向日葵告警通知,请前往【添加应用能力】界面添加机器人。

3. 在管理后台审核发布

(1)点击左侧导航栏【应用发布】-【版本管理与发布】,按照下图指引,创建版本。
企业自建应用若要供企业内其他用户使用,或应用目录应用若要上架飞书应用目录,都必须发布一个版本。
您可以单击 <创建版本> ,进行创建版本。

(2)配置完成后,点击 <申请线上发布> ,申请发布后,则应用状态更新为审核中/已发布(免审核情况)。

(3)企业超级管理员登录飞书管理后台,审核应用。在右侧顶部菜单栏单选择 【管理后台】 ,进入飞书管理后台。

(4)在左侧导航栏选择【工作台】->【应用审核】,选择需审核的应用。

(5)在应用审核页面点击通过。

4. 在向日葵中绑定授权飞书

在向日葵管理平台的【系统管理】->【第三方授权登录】->【飞书授权】中,填入APP IDAPP SecretEncrypt Key,点击【保存】,即可生成请求地址。

进入飞书管理后台 【开发配置】-【事件与回调】 ,在【事件配置】界面将向日葵管理平台生成的请求地址填入到【请求地址】,点击 <保存>

5. 添加事件,实时同步

通过事件订阅,可以满足应用及时响应飞书事件变更的需求,如部门及人员变更时,向日葵均会自动同步信息。

(1)在飞书管理后台【应用功能】->【事件订阅】,点击【添加事件】,按照下图指引,勾选添加相关事件,勾选后点击【确认添加】

添加事件
①部门新建
②部门被删除
③部门信息变化
④员工离职
⑤员工信息变化
⑥员工入职

(2)点击左侧导航栏【应用发布】->【版本管理与发布】,创建版本,自定义填写应用版本号,重新发布应用。

(3)配置完成后,点击 <申请线上发布>

(4)申请发布后,则应用状态更新为已发布。

(5)完成以上操作后,在向日葵管理平台的【帐号体系】-【帐号管理】页面,可查看飞书企业信息。
注意: 若没有自动读取企业组织及成员账号,点击 <同步用户> 进行同步。

飞书授权配置说明至此结束,若有疑问可联系技术人员咨询。