WeLink免登苍穹配置

栏目:云苍穹知识作者:金蝶来源:金蝶云社区发布:2024-09-23浏览:1

WeLink免登苍穹配置

变更记录

产品版本

更新内容更新日期
V5.0.011初始版本
V7.0.11、一键生成URL地址

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

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

2024年10月

1 简介

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

2 适用版本

金蝶云苍穹【公有云&私有云】 V3.0以上

3 系统路径

V5.0及以下:【系统服务云】→【配置工具】→【第三方应用配置】→【WeLink】
V6.0及以上:【系统服务云】→【第三方服务设置】→【企业协同软件配置】→【WeLink】

4 操作说明

4.1 WeLink端配置

4.1.1 登录管理后台

 1) 使用WeLink管理员账号在welink客户端点击【管理后台】。

2)进入WeLink的管理后台,进入【应用】页签。

4.1.2 创建应用

 1)进入【应用】页签,点击【全部应用】菜单栏,点击【到开放平台创建】超链接。



 2)进入WeLink开放平台,选择【应用开发】页签,在【企业内部应用】点击【轻应用】菜单栏,上传图标,填写【轻应用中文名称】和【轻应用英文名称】,点击【提交】按钮。

3)在【设置首页地址】,点击【前往设置】超链接,然后填写手机端和PC端访问地址。


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

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

获取首页URL地址方法:

  • 拼接PC端URL的格式,如下

 https://xxx.xxxx.xxx/index.html?formId=xxxxx&accountId=xxxxx&apptype=wl&appid=xxxxx

  • 拼接移动端URL的格式,如下

 https://xxx.xxxx.xxx/mobile.html?form=xxx&accountId=xxxxxx&apptype=wl&appid=xxxxxx

  • https://xxx.xxxx.xxx/index.html为苍穹PC端地址,https://xxx.xxxx.xxx/mobile.html为苍穹的移动端地址,其中https://xxx.xxxx.xxx是客户的环境访问地址

  • form为跳转的移动端表单编码,如需跳转PC端表单则参数名为formId

  • accountId为数据中心ID,从MC中获取,如没有拼接此参数,默认跳转第一个数据中心

  • apptype固定值设置为wl

  • appid是轻应用的client_id,可参考4.1.3

4.1.3 获取应用client_id和clientsecret 

在【应用开发】点击【轻应用】,选择【人人差旅基线PG】,点击【基本信息】,查看client_id和client_secret。

4.1.4 申请接口权限

 1)在【接口权限】点击【前往设置】,然后在【身份与鉴权】和【通讯录】,点击【申请授权】,开通身份与鉴权和通讯录的相关接口权限。

身份与鉴权接口权限需要开通:用户登录信息;轻应用鉴权。

通讯录接口权限需要开通:租户详细信息;组织架构信息;用户简单信息;用户详细信息;通讯录同步;用户邮箱信息;用户授权信息。

4.1.5 应用发布

完成应用配置,点击发布版本。

4.2 MC端配置

  • v7.0及以上版本,在苍穹“系统服务云--第三方服务设置--企业协同软件配置--WeLink--新增/编辑界面”配置免登插件,默认“标准”无需配置,如有二开插件,选择“自定义插件”并将插件名填写至右侧输入框中。

  • v6.0及以下版本,请按4.2.1~4.2.3的步骤操作

4.2.1登录MC管理中心

登录MC管理中心,找到对应的租户,点击租户ID进入租户配置界面。

4.2.2 配置免登插件

在租户配置项增加配置项,配置项名称填写authtication.apps,配置项值填写kd.bos.login.thirdauth.app.welink.WeLinkAuthtication,如同时还集成企业微信、WeLink等多个第三方应用,多个插件(配置项值)中间以英文逗号隔开。

配置完成后,点击保存。

4.2.3 发布集群

在集群管理中选择所属集群,点击发布。

4.3 苍穹端配置

使用管理员账号登录苍穹系统,进入WeLink第三方应用配置列表。

V5.0及以下版本菜单路径:【系统服务云】→【配置工具】→【第三方应用配置】→【WeLink】

V6.0及以上版本菜单路径:【系统服务云】→【第三方服务设置】→【企业协同软件配置】→【WeLink

点击【新增】,填写应用ID,应用名称,应用秘钥,获取应用ID和应用秘钥可查看步骤【4.1.3】

4.4.  免登验证

WeLink客户端导航栏,点击【业务】 → 点击苍穹应用,正常打开苍穹页面,则代表免登成功。

注意:若访问时,需登录则代表没有免登成功,请按上述步骤检查。


5 异常日志

仅V7.0及以上版本支持,用户免登失败时,在苍穹“系统服务云--第三方服务设置--企业协同软件配置--WeLink”列表,自动记录异常日志,帮助管理员排查异常配置问题,“日志描述”给出相关错误和指导。

6 常见问题


WeLink免登苍穹配置

变更记录产品版本更新内容更新日期V5.0.011初始版本V7.0.11、一键生成URL地址2、简化免登插件配置路径3、提供用户免登异常日志2024年10月1...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息