企培版 - 飞书自建应用设置
本文档用于指导您在飞书开放平台创建自建应用,并完成与在线课程平台的登录对接配置。
👉 传送门:飞书开放平台
创建自建应用
- 访问飞书开发平台 ,点击右上角 登录 ,使用飞书管理员账号登录。
- 登录后,点击 创建企业自建应用
- 填入相关信息,完成应用的基础创建。
获取应用信息
- 在应用详情页左侧导航栏,点击 凭证与基础信息
- 在页面中可看到:App ID 和 App Secret
- 将相关参数填写到课程平台对应的飞书配置项中。
添加应用能力
在应用详情页,点击左侧 应用能力 → 添加应用能力,添加 网页应用
在配置页中,分别填写 桌面端主页 和 移动端主页 的 URL
桌面端主页 :用户从 PC 端飞书工作台点击应用时打开的地址,配置如下:
https://{your-domain.com}/sso/feishu
移动端主页 :用户从移动端飞书工作台点击应用时打开的地址,配置如下:
https://{your-domain.com}/h5/#/pages/sso/feishu
注意: 请将 {your-domain.com} 替换成自己的域名。
安全配置
在左侧导航栏选择 安全设置 ,添加 重定向URL 和 H5可信域名
需要添加的重定向地址如下:
- https://{your-domain.com}/sso/feishu
- https://{your-domain.com}/oauth/feishu/callback
- https://{your-domain.com}/h5/ (末尾带 "/")
需要添加的H5可信域名如下:
- https://{your-domain.com}
配置权限
为了让课程平台能够获取飞书部门和用户的基本信息,需要申请对应权限。
左侧导航栏点击 权限管理,搜索并开通以下常用权限:
| 权限名称 | 权限代码 |
|---|---|
| 获取通讯录基本信息 | contact:contact.base:readonly |
| 获取部门基础信息 | contact:department.base:readonly |
| 获取通讯录部门组织架构信息 | contact:department.organize:readonly |
| 获取用户组信息 | contact:group:readonly |
| 获取用户基本信息 | contact:user.base:readonly |
| 获取用户组织架构信息 | contact:user.department:readonly |
| 获取用户邮箱信息 | contact:user.email:readonly |
| 获取用户 user ID | contact:user.employee_id:readonly |
| 通过手机号或邮箱获取用户 ID | contact:user.id:readonly |
| 获取用户手机号 | contact:user.phone:readonly |
版本管理与发布
自建应用只有发布后才能在租户内正式使用。
- 左侧导航栏点击 版本管理与发布
- 点击 创建版本 ,填写相关信息。
- 点击 保存 ,然后点击 申请发布
本文系原创,转载请注明出处
评论已关闭