1. 概述

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

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

2.飞书开放平台配置

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


(1)登录飞书开放平台https://open.feishu.cn/app ,进入创建应用页面;
截屏2022-06-14 15.10.20.png

(2)点击创建应用,在创建应用页面,选择企业自建应用,并填写应用名称和应用描述,点击确定创建;

(3)在企业自建应用列表中,点击目标应用,进入应用详情页面;
page_1.png

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

2.2 在飞书中配置自建应用


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

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

例如:https://xxx.yyy.com/dash/login1
16f8b651175ddf6b.png

(2)点击左侧导航栏的权限管理,进行应用权限的配置。需要参考以下权限进行配置:

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

(3)点击左侧导航栏的应用发布-版本管理与发布,创建版本。
page_1.png

(4)在版本详情页面,配置以下参数,点击保存。
page_1.png

(5)配置完成后,点击申请发布。
page_1.png

申请发布后,应用状态更新为审核中。
page_1.png

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


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

(1)在顶部菜单栏中选择管理后台,进入飞书管理后台;
page_1.png

(2)在飞书管理后台左侧导航栏中选择工作台-应用审核,在应用审核页面点击通过;

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

3. 产品后台配置

3.1 进行飞书相关配置


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

开启飞书集成开关:

填写配置信息:

3.2 用户与飞书账号的匹配


(1)扫码登录

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

(2)账号自动匹配

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

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

(3)账号手动匹配

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