Skip to content

飞书(企业内部应用)

平台集成飞书后可以实现:飞书单点登录、组织信息同步、飞书API调用,等诸多能力

1.创建内部应用

使用飞书管理员账号登录飞书开放平台,并创建企业内部应用

创建完成示例

注意

图中红色标注区域为后续配置所需的凭据信息

  • 标记1:自建应用ID
  • 标记2:自建应用秘钥

2.配置事件与回调

2.1 获取凭据

点击侧边栏的事件与回调 → 加密策略,并生成Encrypt Key

注意

图中红色标注区域为后续配置所需的凭据信息

  • 标记1:加密密钥
  • 标记2:验证令牌

2.2 绑定飞书

创建内部应用获得到的凭据,配置到以下位置

配置事件与回调获得到的凭据,配置到以下位置

点击完成

2.3 事件配置

点击上方的点击查看回调地址,复制回调地址后将其配置到下方的请求地址,并添加指定事件

特别说明

  • 订阅类型必须为应用身份(否则无法获取到部门/成员数据)
  • 修改事件配置,需要发布新版本且审核通过后才能生效
  • 绑定飞书后,回调地址将在1分钟内生效(重启服务可以立即生效)

3.添加网页应用

点击侧边栏添加应用能力,并选择添加网页应用

添加网页应用后,将专属登录链接配置到:桌面端主页 / 移动端主页

提示

飞书用户可以通过飞书工作台访问当前添加的网页应用

4.权限配置

需要配置以下权限,以生效对应权限的功能

提示

除下方列出的两项权限外,其余权限均为必填配置项;以下两项权限仅在使用三方审批相关功能时需开启

  • 查看、创建、更新、删除三方审批定义相关信息
  • 查看、创建、更新、删除三方审批实例相关信息

修改权限配置后,需要发布新版本且审核通过后才能生效

5.安全配置

点击侧边栏安全设置 → 重定向 URL,配置重定向 URL

特别说明

必须配置以下两个重定向 URL,假设根域名为http://192.168.31.88,示例说明如下

  • 电脑端格式:根域名/apaas/redirect

例如:http://192.168.31.88:2020/apaas/redirect

  • 移动端格式:根域名/mobile/redirect

例如:http://192.168.31.88:2020/mobile/redirect

示例如下

6.版本发布于管理

修改了应用权限事件回调等功能后,需要发布版本并通过审核后,应用才能同步更新