码匠客服

接入飞书登录

配置飞书企业自建应用

步骤 1:在飞书开放平台创建一个企业自建应用

  1. 您如果没有飞书开发者账号,请先前往飞书开放平台创建。
  2. 登录开发者账号,在开发者后台,点击创建应用
  3. 输入应用名称和应用描述,确定创建

创建完毕,在开发者后台可以看到新创建的应用:

步骤 2:获取 App ID 和 App Secret

点击该应用,可进入飞书应用详情界面,点击凭证与基础信息,可以获得应用凭证 App IDApp Secret

步骤 3:添加重定向 URL和 IP 白名单

点击安全设置:

  1. 添加重定向URL

格式为:<协议>://<域名>:<端口>/user/auth/oauth/redirect

例如:

https://myhost.io/user/auth/oauth/redirect
  1. 添加 IP 白名单

输入私有化部署所在服务器的 IP 后点击添加

步骤 4:应用申请权限

点击权限管理,可以选择开通该应用所需申请的权限:

  • 获取用户基本信息
  • 获取用户邮箱
  • 获取用户手机号
  • 获取用户 user ID
  • 以应用身份读取通讯录
  • 获取企业信息

设置完权限,需要发布应用最新版本。

步骤 5:发布应用

  1. 点击版本管理与发布->创建版本
  1. 填写应用版本号(格式如 1.0.0)和更新说明,设置可用范围,最后点击保存
  1. 保存之后,点击申请线上发布
  1. 提交申请后,企业管理员会进行审核,审核结果会通过飞书和开发者后台发送给您。

配置码匠中飞书登录参数

  1. 飞书自建应用成功发布后,进入码匠配置目录:
cd majiang/stacks/configuration/
  1. 修改 docker.env 文件内容:
vim stacks/configuration/docker.env

编辑飞书登录参数:

LOGIN_CHANNEL_FEISHU=true
OAUTH_FEISHU_CLIENT_ID=新建应用的 App ID
OAUTH_FEISHU_CLIENT_SECRET=新建应用的 App Secret
  1. 保存修改后,重启码匠应用:
docker restart majiang

效果展示

以上配置完成后,您的飞书企业中的成员可以在登录界面选择飞书,然后以企业成员的身份授权登录码匠。