1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
| 11.0 | V1.0.2 |
| 10.0 | V1.0.2 |
1.2 应用场景
本插件为 FineReport 平台提供钉钉扫码登录能力，安装并配置完成后，用户可在 FineReport 平台原生登录页直接使用钉钉扫码完成身份验证，无需输入账号密码，兼顾便捷性与安全性。
2. 使用前提
开始配置前，请确认以下条件已满足：
1）FineReport 服务器可正常访问外网地址 https://oapi.dingtalk.com
2）FineReport 已通过固定 IP 或域名对外提供访问（用于配置钉钉回调地址）
3）FineReport 用户已录入手机号，且与其钉钉账号绑定的手机号完全一致，且各个用户的手机号不重复。
3. 安装插件
4. 配置钉钉应用
4.1 创建钉钉应用
1）使用钉钉管理员账号登录 钉钉开发者平台，在顶部导航中选择「应用开发 > 钉钉应用」。
2）点击「创建应用」，填写应用名称和描述，点击「保存」完成创建。创建成功后，即可进入应用详情页。
4.2 记录钉钉应用凭证
在应用详情页，点击左侧菜单中的「凭证与基础信息」。记录以下两个值备用：
Client ID
Client Secret
4.3 申请所需权限
1）在应用详情页，点击左侧菜单中的「权限管理」。
2）搜索并勾选以下两项权限：
个人手机号信息
通讯录个人信息读取
3）点击「申请权限」，等待权限生效。
4.4 配置回调地址
1）在应用详情页，点击左侧菜单中的「分享设置」。
2）在页面回调地址字段中，填写以下地址（将<ip>和<端口>替换为 FineReport 系统实际的 IP 地址和端口号）：
http://<ip>:<端口>/webroot/decision/plugin/public/com.fr.plugin.ddscan.new.v11/scanLoginNew
3）点击「添加」保存生效。
注： 回调地址中的 IP 或域名必须与 FineReport 系统对外访问地址完全一致，否则扫码后将返回错误。
5. 配置FineReport平台
1）管理员登录FineReport系统，进入「系统管理 > 常规 > 钉钉扫码配置」。
2）填写钉钉扫码相关配置信息，点击「保存」生效
| 钉钉扫码配置 | 说明 |
|---|---|
| 扫码AppID(Client ID) | 必填，4.2节获取的钉钉应用凭证Client ID |
| 扫码app_secret(Client Secret) | 必填，4.2节获取的钉钉应用凭证Client Secret |
| 登录界面启动开关 | 默认启用，即在FineReport平台原生登录页，显示「钉钉扫码登录」入口 |
| 默认扫码登录 | 可选，即在用户登录FineReport平台时，默认登录方式由用户名密码登录，改为钉钉扫码登录 |
| 只保留扫码登录 | 可选，即在用户登录FineReport平台时，只支持钉钉扫码登录，不支持用户名密码登录 |
6. 效果预览
配置完成后，访问FineReport登录页，页面底部将显示钉钉扫码登录入口。使用钉钉 App 扫描二维码，即可完成登录。
7. 注意事项
用户手机号必须一致
钉钉扫码登录通过手机号匹配FineReport平台用户。钉钉账号绑定的手机号与FineReport平台中该用户录入的手机号必须完全相同，否则扫码后将提示登录失败。
不支持内外网同时使用
本插件不支持 FineReport 平台同时在内网和外网环境下使用钉钉扫码登录。
不支持代理服务器
本插件不支持通过钉钉配置的代理服务器进行通信。请确保FineReport系统本身可以直接访问https://oapi.dingtalk.com
新版插件适用范围
由于钉钉扫码接口已于 2024 年 1 月 11 日发生变动，该日期之后创建的扫码应用须使用本插件（钉钉扫码新版）。
2024 年 1 月 11 日之前创建的钉钉应用，请参阅 钉钉扫码（旧版）使用说明。
上一篇：钉钉定时推送消息
