飞书免登苍穹配置

变更记录

产品版本

更新内容

更新日期

V5.0.011

初始版本

V7.0.1

1、一键生成URL地址

2、简化免登插件配置路径

3、提供用户免登异常日志

2024年10月

1 简介

本文档介绍苍穹与飞书自建应用的集成，从而轻松实现在飞书客户端和App一键免登苍穹系统，无需输入苍穹账号密码即可登录系统，方便用户处理业务，提升办公效率。

2 适用版本

金蝶云苍穹 V3.0以上

3 系统路径

V5.0及以下：【系统服务云】→【配置工具】→【第三方应用配置】→【飞书】

V6.0及以上：【系统服务云】→【第三方服务设置】→【企业协同软件配置】→【飞书】

4 操作说明

4.1飞书管理中心配置

4.1.1 创建应用

1）使用飞书管理员账号登录飞书管理后台，进入应用管理→开放平台→开发者后台，点击【创建应用】创建企业自建应用

2）填写完创建应用的相关信息后，点击确定创建。

4.1.2 设置主页URL

创建完成后，点击应用进入详情页，点击侧边栏的“添加应用能力”，添加网页应用，配置桌面端主页和移动端主页的URL地址。

v7.0及以上版本，在苍穹“系统服务云--第三方服务设置--企业协同软件配置--飞书--新增/编辑界面”一键生成

v6.0及以下版本，需手动构造

构造主页URL地址方法：

主页URL格式拼接：

https://open.feishu.cn/open-apis/authen/v1/index?redirect_uri={REDIRECT_URI}&app_id={APPID}

苍穹访问地址（示例）：

https://xxxx.com/mobile.html?form=er_mainpage_daily&accountId=666xxx78272&apptype=feishu&flyBookAppId=cli_xxxx138500e

https://xxxx.com/mobile.html为苍穹的移动端地址，
PC端地址则为https://xxxx.com/index.html
form为跳转的移动端表单编码，如需跳转PC端表单则参数名为formId
accountId为数据中心ID，从MC中获取，如没有拼接此参数，默认跳转第一个数据中心
apptype固定值设置为feishu
flyBookAppId为飞书的APP ID，从凭证与基础信息中获取

1）把苍穹访问地址进行urlcode编码(可以在网上搜索urlencode在线编码工具进行编码)：https%3A%2F%2Fxxxx.com%2Fmobile.html%3Fform%3Der_mainpage_daily%26accountId%3D666xxx78272%26apptype%3Dfeishu%26flyBookAppId%3Dcli_xxxx138500e

2）编码后的地址替换链接中的{REDIRECT_URI}：

https://open.feishu.cn/open-apis/authen/v1/index?redirect_uri=https%3A%2F%2Ffeature.kingdee.com%3A1026%2Fpatchcore%2Fmobile.html%3Fform%3Der_mainpage_daily%26accountId%3D666xxx78272%26apptype%3Dfeishu

3）app_id从凭证与基础信息中获取，替换链接中的{APPID}，得到最终的主页URL地址

https://open.feishu.cn/open-apis/authen/v1/index?redirect_uri=https%3A%2F%2Fxxxx.com%2Fmobile.html%3Fform%3Der_mainpage_daily%26accountId%3D666xxx78272%26apptype%3Dfeishu%26flyBookAppId%3Dcli_xxxx138500e&app_id=cli_a0b2xxxx54338900b