使用手册 / 第三方登录配置 / 钉钉扫码登录

钉钉扫码登录

配置钉钉扫码登录，允许用户通过钉钉账号登录 WLN.WIKI。

前置条件

  • 拥有钉钉开发者账号
  • 已创建钉钉应用
  • 获取到 AppKey 和 AppSecret

创建钉钉应用

  1. 访问钉钉开放平台：https://open.dingtalk.com
  2. 登录钉钉开发者后台
  3. 创建应用，选择「H5微应用」
  4. 在应用详情页获取 AppKey 和 AppSecret
  5. 配置回调域名：你的 WLN.WIKI 域名
钉钉应用配置截图

钉钉应用配置截图

配置 WLN.WIKI

步骤一：填写钉钉应用信息

  1. 登录 WLN.WIKI 管理员账户
  2. 进入【站点管理】->【第三方登录】
  3. 找到「钉钉登录」配置项
  4. 填写以下信息：
    • AppKey：钉钉应用的 AppKey
    • AppSecret：钉钉应用的 AppSecret
  5. 开启「启用钉钉登录」开关
  6. 点击保存
钉钉登录配置截图

钉钉登录配置截图

钉钉免登配置

如果需要在钉钉客户端内自动登录（免登），还需要配置以下内容：

  1. 在钉钉应用中添加「企业内工作台」权限
  2. 配置应用首页地址为 WLN.WIKI 地址
  3. 在 WLN.WIKI 中开启「钉钉免登」选项

登录流程

配置完成后，用户可以通过以下方式登录：

PC 端扫码登录

  1. 用户访问 WLN.WIKI 登录页面
  2. 点击「钉钉登录」按钮
  3. 页面显示钉钉二维码
  4. 用户使用钉钉 APP 扫码确认
  5. 登录成功，跳转到首页

钉钉客户端免登

  1. 用户在钉钉客户端打开 WLN.WIKI 应用
  2. 系统自动识别钉钉用户身份
  3. 自动完成登录

首次使用钉钉登录的用户，系统会自动创建账户并关联钉钉身份。

常见问题

扫码后提示授权失败

检查钉钉应用的回调域名是否正确配置，确保与 WLN.WIKI 域名一致。

免登不生效

确认钉钉应用已添加企业内工作台权限，并且用户在企业通讯录中。