本文介绍如何实现网页应用在飞书客户端内的免登操作,在用户打开网页应用时,弹出授权登录页面,授权通过后直接完成登录操作。通过本教程你可以了解到网页应用授权登录的完整流程。
免登流程
网页应用免登为网页应用提供了获取当前登录用户的飞书身份的能力,网页应用免登流程如下:
- 步骤一:获取用户登录预授权码。
- 步骤二:使用预授权码获取user_access_token。
- 步骤三:获取用户信息并完成登录。
- 步骤四:刷新已过期的user_access_token。
相关接口
- 获取授权码接口文档 https://open.feishu.cn/document/common-capabilities/sso/api/obtain-oauth-- code
- 获取 user_access_token 接口文档https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/authentication-management/access-token/get-user-access-token
- 获取用户信息并完成登录
https://open.feishu.cn/document/server-docs/authentication-management/login-state-management/get?appId=cli_a7e8f5389f7c100d - 刷新 user_access_token接口文档 https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/authentication-management/access-token/refresh-user-access-token
准备工作
开始本教程操作之前,你需要完成以下准备工作。
注册成为飞书的开发者- 创建企业用户或加入飞书企业租户。
步骤一:创建你的应用
在本步骤,你将创建一个企业自建应用并开启网页应用能力。
操作步骤
1.登录飞书开发者后台。
2.在开发者后台首页,单击 创建企业自建应用,然后填写应用名称和应用描述,单击 创建。
3.在左侧导航栏单击进入 测试企业和人员 页面,单击 创建测试企业,填写 测试企业名称、手机号、验证码,单击 确认创建。
为了满足开发测试阶段频繁变更配置的需求,飞书开放平台提供了测试企业与人员功能。在开发阶段,推荐开发者使用测试版应用,此版本中涉及的权限和配置变更都会直接生效,无需管理员审核,客户端的测试也将在测试租户进行。在所有的开发测试完成之后,切换、手动同步到正式版应用,仅提交一次审核即可,大大加速了开发效率,也降低了对管理员的打扰。
4.在创建完成的测试企业操作栏,单击 关联应用,即可为当前应用自动生成测试版本。
5.左侧导航栏,单击应用名称右侧的切换图标并选择 切换至测试版本。
6.在测试应用中,单击添加应用能力,添加网页应用能力。
步骤二:启动你的服务
该步骤可以省略,保证你的网站服务正常即可!
步骤三:配置网页应用访问地址
在本步骤,你将在开发者后台配置网页应用的桌面端主页和移动端主页。
操作步骤
打开开发者后台,进入应用详情页。
在 网页应用 页面,修改 网页配置,桌面端主页 和 移动端主页 都填写为步骤二中获取的临时内网访问地址。例如,在本文中为http://10.4.143.108:3000
。
正式上线时,此处配置主页地址需为 公网地址 。为了快速体验接入流程,本示例中暂时先使用本地环境。
单击进入 安全设置 页面,添加 重定向 URL 和 H5可信域名,地址为服务端访问地址加斜杠,本文设置为 http://10.4.143.108:3000/
。
说明:
- 为了飞书客户端内网页应用的安全可信,仅可信域名内的 H5 可以调用 JSAPI 获取数据,因此需要为应用配置可信域名。
- 重定向URL的末尾需要有斜杠(/)。
步骤四:开启API权限
在本步骤,你将在开发者后台配置开启需要调用API接口的权限。
操作步骤
打开开发者后台,进入应用详情页。
在 开发配置 栏目下,单击进入 权限管理 页面,开启对应的API权限和数据权限。
步骤四:发布应用
在本步骤,你将在完成以上步骤后,发布你应用才能生效。
操作步骤
在 应用发布 栏目下,单击进入 版本管理与发布 页面,创建一个新的发布版本即可。