1. 概述

本产品提供了飞书集成的能力，目前仅私有部署版本支持飞书集成功能。通过飞书后台的配置可以实现本产品与飞书用户的打通，实现飞书扫码登录。

通过在飞书开发者后台和产品后台的配置，即可实现飞书集成功能，具体操作步骤如下：

2.飞书开放平台配置

2.1 在飞书开放平台创建应用

（1）登录飞书开放平台https://open.feishu.cn/app ，进入创建应用页面；

（2）点击创建应用，在创建应用页面，选择企业自建应用，并填写应用名称和应用描述，点击确定创建；

（3）在企业自建应用列表中，点击目标应用，进入应用详情页面；

（4）在应用详情页面，点击左侧导航栏的凭证与基础信息，在应用凭证区域获取App ID和App Secret。在基础信息区域上传应用图标。特别注意：应用凭证这两个参数将填写至产品管理后台！

2.2 在飞书中配置自建应用

（1）点击左侧导航栏的安全设置，进行应用安全的配置。配置应用安全时，您需要在重定向URL中添加用于登录验证的URL和用于用户绑定的URL。

URL的配置格式为：私有部署地址+/dash/login1

例如：https://xxx.yyy.com/dash/login1

（2）点击左侧导航栏的权限管理，进行应用权限的配置。需要参考以下权限进行配置：

• 获取用户的user ID
• 获取用户基本信息
• 获取用户企业信息
• 获取用户组织架构信息
• 获取部门基础信息
• 获取用户组信息
• 以应用身份访问通讯录
• 以应用身份读取通讯录
• 获取用户邮箱信息
• 获取用户手机号
• 获取用户雇佣信息
• 搜索用户

（3）点击左侧导航栏的应用发布-版本管理与发布，创建版本。

（4）在版本详情页面，配置以下参数，点击保存。

（5）配置完成后，点击申请发布。

申请发布后，应用状态更新为审核中。

2.3 在管理后台审核并配置应用

超级管理员登录管理后台，审核应用。

（1）在顶部菜单栏中选择管理后台，进入飞书管理后台；

（2）在飞书管理后台左侧导航栏中选择工作台-应用审核，在应用审核页面点击通过；

确保应用的可用成员为[全部成员]

3. 产品后台配置

3.1 进行飞书相关配置

在产品管理后台的设置页面，可以对飞书集成的开启进行控制。若要使用飞书登录，首先在[飞书集成设置]下打开集成开关，其次填写集成配置信息的两个参数：App ID和App Secret。

开启飞书集成开关：

填写配置信息：

3.2 用户与飞书账号的匹配

（1）扫码登录

开启飞书扫码登录开关，在产品扫码登录界面可以看到飞书登录入口。

（2）账号自动匹配

• 开启自动创建账号后，用户使用飞书登录时，如果账号不存在则会自动创建账号。
• 开启自动绑定账号后，用户使用飞书登录时，如果账号存在但还未绑定，则自定绑定账号。

开启自动创建账号和自动绑定账号开关，用户首次使用飞书登录后，在[企业域管理-人员信息]页面的人员列表可以看到已匹配用户的基本信息，且该用户下次即可使用飞书免密登录。

（3）账号手动匹配

对于部分用户，管理员可手动[设置飞书匹配]，通过飞书用户的手机号、姓名或者邮箱与产品用户进行匹配，匹配完成后的用户可以直接使用飞书账号免密登录。