【对接方案】活字格应用和钉钉集成

活字格提供了很多开放性的功能来和其他系统做对接，和钉钉集成也不在话下。其实活字格应用和钉钉集成论坛或帮助手册已经有许多格友们和官方分享的内容了，这个贴子主要是对相关资源做一个整合，方便大家统一查看。

第一节 课程介绍

第二节 用户认证集成——第三方用户集成

大纲：

• 第三方用户集成的适用场景
• 第三方用户集成的主要集成步骤
• 在集成过程中可能会遇到的一些问题以及对应的解决方案
  

视屏资料：
钉钉集成-第三方用户.fgcc (614.5 KB, 下载次数: 445)

2023-6-29 22:14 上传

点击文件名下载附件

第三节 用户认证集成——第三方用户集成+扫码登录

大纲：

• 第三方用户集成+扫码登录集成方式的适用场景
• 第三方用户集成+扫码登录集成方式的主要集成步骤
• 利用扫码登录实现本地调试钉钉第三方集成的应用
• 在集成过程中可能会遇到的一些问题以及对应的解决方案
  

视屏资料：
钉钉集成-第三方用户+扫码登录.fgcc (846.06 KB, 下载次数: 421)

2023-6-29 22:14 上传

点击文件名下载附件

第四节 用户认证集成——普通认证+钉钉单点登录

大纲：

• 普通认证+钉钉单点登录集成方式的使用场景
• 普通认证+钉钉单点登录主要的集成步骤
• 在集成过程中可能会遇到的一些问题以及对应的解决方案
  

视频资料：
钉钉集成-普通认证+钉钉单点登录.fgcc (722.19 KB, 下载次数: 468)

2023-6-29 22:14 上传

点击文件名下载附件
钉钉登录包.zip (7.02 KB, 下载次数: 478)

2023-8-7 11:40 上传

点击文件名下载附件

常见问题汇总（持续更新...）

Q：服务管理控制台第三方安全提供程序同步用户失败，提示 60020-IP 地址不在白名单内？

A：这个需要在钉钉管理控制台，对应应用的开发管理里去配置下活字格应用所在服务器的外网 IP 地址（获取服务器外网 IP 地址可以百度一下），如下：


Q：服务管理控制台第三方安全提供程序同步用户失败，提示 600011-没有调用该接口的权限？

A：这个需要在钉钉管理控制台需要在钉钉工作台给对应应用的权限管理下开启权限，可以选择将全部的个人权限和通讯录权限全部开启：

PS：活字格服务管理控制台当钉钉第三方安全提供程序同步用户失败时，我们点击同步状态里的叹号图标就能看到更多错误信息，方便我们定位问题。

Q：在钉钉控制台访问应用时一直白屏，卡在授权页？
A：这个原因往往是应为钉钉扫码登录授权未配置或配置错误，即第三方安全提供程序里的 AppId 和 AppSecret 未配置或未配置正确，配置方法可参考上面视频第二节的内容。

Q：钉钉控制台访问应用出现网络不给力（手机），页面加载失败（PC）？

A：这往往是由于我们活字格应用不能够正常访问，活字格在钉钉里应用的授权地址或扫码登录的授权地址未配置正确导致的。这时候我们首先需要去排查一下活字格应用是否能够正常访问。可以出问题的同环境，通过浏览器访问下我们的活字格应用，看应用是否能够正常显示登录界面。或者去钉钉开放平台去检查一下应用配置的首页地址集扫码登录的回调地址是否和活字格应用的访问地址一致，详细配置方法可参考上面视频第二节的内容。

Q：扫码页面跳转未授权，提示 url 参数和应用配置的回调域名不匹配？

A：这个往往是在钉钉扫码登录的授权里回调域名配置和实际跳转的不一致导致的，可以将上述报错的 URL 复制，配置到钉钉工作台扫码登录回调域名，配置方法可参考上面视频第二节的内容。


Q：第三种集成模式（普通认证+钉钉单点登录）下，要在活字格管理控制台创建用户名为钉钉 UserID 的用户，如果活字格这边已经有相关的内建用户，能不能新建用户就能实现钉钉单点登录呢？

A：第三种集成模式中，因为要支持钉钉单点登录，所以活字格这一侧需要知道钉钉的 UserID。除了新建用户名为钉钉 UserID 的用户外，还支持将 UserID 放到用户自定义属性中，这样就可以在已有用户的自定义属性维护 UserID，也能够做到单点登录。做到这一点需要在上面钉钉登录包 config.json 里添加自定义属性名，如下：

然后在活字格服务管理控制台将钉钉的 UserID 配置到已有用户的自定义属性（DingDingUserID，和配置文件里配置的熟悉名称保持一致）中即可，比如：


Q：如果应用做了网络代理的话，造成外网访问应用端口与内网访问应用端口不相同，需要使用下方的登录包，在InnerPort属性中填写发布时的内网端口即可