内嵌式二维码或新版钉钉扫码登录插件使用说明

收藏

本帖最后由诗仙·1957 于 2025-5-12 17:22 编辑

这与钉钉扫码插件有何不同
商品详情

区别在于，不在依赖在钉钉创建钉钉扫码登录功能，完全不需要这个步骤，钉钉官方也正在逐步取消这个机制。
image.png505060424.png

食用方式：

第1步添加官方js
参考文档
实现登录第三方网站 - 钉钉开放平台
https://g.alicdn.com/dingding/h5-dingtalk-login/0.21.0/ddlogin.js
并添加到设计器
image.png838816833.png

第2步初始化二维码到登录页面，因为登录页面不能使用页面加载时命令，因此采用组件方式构建。
逻辑为：设置变量从表中取值，js命令中获取这个变量的值，并初始化钉钉扫码官方的js sdk控件二维码到指定的单元格中
image.png342306212.png

第3步安装插件，添加一个服务端命令
image.png665729980.png

设置变量从表取值给插件使用，与原来的钉钉扫码插件不同的是这个地方与应用appkey AppSecret 是一致的。也就是应用凭证信息的2个主要信息。

第4步钉钉应用的安全设置---重定向URL（回调域名）与配置信息的url地址要一致
为了其他服务端命令调用，可以将配置信息存到表里面
image.png386960143.png

服务器后台的情况展示
image.png698782348.png

此时就可以实现页面直接内嵌二维码扫码登录，如果不是这个钉钉企业的用户则无法登录，

image.png901719055.png

特别提示：要在手机端登录钉钉应用中直接免登需要注意以下问题
原因：
当前活字格提供的钉钉安全程序在服务器中是要求填写4个码，前面2个是应用的，后面2个是在钉钉后台创建移动扫码登录产生的
由于新版是不需要这2个码的，因此就没有这2个码，所以不填，如果不填就会导致移动端打开应用提示显示空白的。
解决方案是：
按钉钉的文档规则拼接好后填写到钉钉应用后台管理的---网页应用-----应用首页地址 :如下图：
image.png457717589.png

这样设置后才能正常解决移动端点击应用访问空白的问题。这个属于活字格这边旧版规则的问题导致的。只能等待官方出面解决或者适配新版免登。。。

然后来缕一缕思路：
移动端--点击应用---直接访问后台管理设置的---应用首页地址这个地址是什么就打开什么，不会附加任何参数
PC端客户端 ---与移动是一样的。
浏览器直接访问
这3种形式都不会附加参数，为了免登或者扫码，都需要给url传递参数。
这个插件是用于扫码后的解析，拼接地址是为了给钉钉传参告诉二维码扫的是那个企业。
那么问题就是
PC浏览器---打开这个首页--展示二维码或者点击按钮跳拼接地址--扫码或点头像--跳转到插件url---解析参数---查用户token--查用户信息---查本地账户是否存在---登录
移动---打开这个首页（拼接后的地址）---直接就是二维码判断了---扫码或者点头像---跳转到插件url---解析参数---查用户token--查用户信息---查本地账户是否存在---登录

PC客户端 ---与PC浏览器差不多

另外也不引用js，不写js代码采用钉钉的二维码页面更简单，效果也还不错，支持判断当前环境是否登录了钉钉客户端，如果已登录则不需要扫码点击头像就能登录。
这跟在其他网站上登录QQ账户差不多，点击QQ头像就登录了。
使用方式：
活字格内置登录页面加个按钮设置命令为：
image.png672950744.png

这个跟活字格官方的钉钉扫码插件效果类似但不同的地方是新版的能检测客户端是否登录。而不是百分百的扫码。

如果你想在本地直接钉钉登录，调试设计器的功能这种，也是可以，具体做法如图
image.png912776794.png

然后钉钉后台

，为什么不与发布后环境冲突，也可以复制这个服务端命令改个名字，例如ddlocal代表本地登录，ddlogin代表发布后的。
image.png949756774.png

这样就能实现无论是本地调试修改，还是发布后，都能正常钉钉登录
image.png758119506.png

这里显示的url就是刚才设定的本地的回调url。如果本地客户端登录了钉钉，就点一下就登录，不在是百分百的扫码了。这就是新版的好处

活字格工程档案demo及最新版插件加群106929215即可免费获得，有问题请在群里反馈

另外说一个机密信息：
其实活字格的api中有说明
IUserInfos - 活字格V11帮助文档
其中
image.png194748839.png