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