接入飞书登录
配置飞书企业自建应用
步骤 1:在飞书开放平台创建一个企业自建应用
创建完毕,在开发者后台可以看到新创建的应用:
步骤 2:获取 App ID 和 App Secret
点击该应用,可进入飞书应用详情界面,点击凭证与基础信息,可以获得应用凭证 App ID 和 App Secret:
步骤 3:添加重定向 URL和 IP 白名单
点击安全设置:
- 添加重定向URL:
格式为:<协议>://<域名>:<端口>/user/auth/oauth/redirect
例如:
https://myhost.io/user/auth/oauth/redirect
- 添加 IP 白名单
输入私有化部署所在服务器的 IP 后点击添加:
步骤 4:应用申请权限
点击权限管理,可以选择开通该应用所需申请的权限:
- 获取用户基本信息
- 获取用户邮箱
- 获取用户手机号
- 获取用户 user ID
- 以应用身份读取通讯录
- 获取企业信息
设置完权限,需要发布应用最新版本。
步骤 5:发布应用
- 点击版本管理与发布->创建版本:
- 填写应用版本号(格式如
1.0.0
)和更新说明,设置可用范围,最后点击保存:
- 保存之后,点击申请线上发布:
- 提交申请后,企业管理员会进行审核,审核结果会通过飞书和开发者后台发送给您。
配置码匠中飞书登录参数
- 飞书自建应用成功发布后,进入码匠配置目录:
cd majiang/stacks/configuration/
- 修改 docker.env 文件内容:
vim stacks/configuration/docker.env
编辑飞书登录参数:
LOGIN_CHANNEL_FEISHU=true
OAUTH_FEISHU_CLIENT_ID=新建应用的 App ID
OAUTH_FEISHU_CLIENT_SECRET=新建应用的 App Secret
- 保存修改后,重启码匠应用:
docker restart majiang
效果展示
以上配置完成后,您的飞书企业中的成员可以在登录界面选择飞书,然后以企业成员的身份授权登录码匠。