飞书集成常见问题

1、飞书如何集成苍穹进行免登？

根据社区贴 https://vip.kingdee.com/knowledge/specialDetail/228892721203874816?category=228893083373702400&id=238758427345172736&productLineId=29 进行配置。

飞书免登逻辑（图中第三方app指的是飞书）：

2、飞书免登失败跳转到登录页问题如何排查？

（1）去monitor检查authtication.apps属性的值，该值表示第三方应用免登的插件

（2）使用第三方应用免登的插件去查monitor日志，根据日志排查问题。

比较常见的问题：

• 苍穹（星瀚）端未配置appsecret

• 飞书端未配置重定向url与可信ip

3、飞书提示请求非法如何解决？

飞书有个步骤是校验链接的合法性，校验的步骤如下：

（1）从请求链接中获取app_id，如下图

（2）根据app_id获取配置的重定向url

（3）请求链接与重定向url中的链接是否匹配，不匹配则报错

了解他报错的原理之后就很好修改了：

（1）检查飞书配置的链接中是否含有app_id，app_id是否有误。

（2）检查飞书配置的重定向url是否跟配置的首页链接匹配。

（3）推荐配置的链接有：

• 应用移动端首页链接https://xxxxxx.com/mobile.html

• 应用PC首页端链接https://xxxxxx.com/index.html

• 待办链接https://xxxxxx.com/integration/yzjShareOpen.do

4、飞书如何集成苍穹待办？

（1）拼接正确的待办链接

https://xxxx.com/integration/yzjShareOpen.do?formId=wf_approvalpage_bac&mb_formId=wf_approvalpagemobile_bac&pkId=1835048614024470528&src=wf&accountId=1803805919843303424&activityId=1835048714897484800&tId=1835048716801697792&apptype=feishu&lang=zh_CN&flyBookAppId=应用appid

（2）将待办链接进行编码（URLEncode）

https://xxxx.com/integration/yzjShareOpen.do%3FformId%3Dwf_approvalpage_bac%26mb_formId%3Dwf_approvalpagemobile_bac%26pkId%3D1835048614024470528%26src%3Dwf%26accountId%3D1803805919843303424%26activityId%3D1835048714897484800%26tId%3D1835048716801697792%26apptype%3Dfeishu%26lang%3Dzh_CN%26flyBookAppId%3D%E5%BA%94%E7%94%A8appid

（3）将待办链接拼接在飞书单点登录地址后面

https://open.feishu.cn/open-apis/authen/v1/index?app_id={应用id}&redirect_uri=https://xxxx.com/integration/yzjShareOpen.do%3FformId%3Dwf_approvalpage_bac%26mb_formId%3Dwf_approvalpagemobile_bac%26pkId%3D1835048614024470528%26src%3Dwf%26accountId%3D