项目简介
本项目致力于集成钉钉的免登能力,打通企业OA系统与钉钉账号。用户可直接使用钉钉账号登录企业内部系统。项目包含前端和后端两个模块,前端采用Vue构建,后端运用Spring Boot构建。
项目的主要特性和功能
前端功能
- 接入钉钉JSAPI获取authCode。
- 录入用户信息。
后端功能
- 使用authCode获取access_token。
- 使用access_token获取用户信息。
- 处理用户登录和绑定逻辑。
安装使用步骤
1. 开发环境准备
- 需有一个钉钉注册企业,若无则可创建:https://oa.dingtalk.com/register_new.htm#/
- 成为钉钉开发者,参考文档:https://open.dingtalk.com/document/org/become-a-dingtalk-developer
- 登录钉钉开放平台后台创建一个H5应用: https://open-dev.dingtalk.com/#/index
- 配置应用:
- 配置开发管理,参考文档:https://open.dingtalk.com/document/org/configure-orgapp
- 配置相关权限,参考文档:https://open.dingtalk.com/document/orgapp-server/address-book-permissions
2. 下载项目
下载本项目的源码文件。
3. 启动项目
3.1 脚本启动(推荐)
- Linux系统:
shell ./dingBoot-linux.sh start {项目名} {端口号} {appKey} {appSecret} {agentId} {corpId}
- Mac系统:
shell ./dingBoot-mac.sh start {项目名} {端口号} {appKey} {appSecret} {agentId} {corpId}
- Windows系统:
shell ./dingBoot-windows.bat {项目名} {端口号} {appKey} {appSecret} {agentId} {corpId}
3.2 手动启动
- 配置应用参数,修改后端
application.yml
文件。 - 启动Spring Boot应用(运行
Application.java
)。 - 启动内网穿透工具,配置应用访问链接、发布应用。
4. 页面展示
输入信息,自动绑定当前钉钉账号。
5. 参考文档
- 获取微应用免登授权码:https://open.dingtalk.com/document/orgapp-client/obtain-the-micro-application-logon-free-authorization-code
- 获取企业内部应用access_token:https://open.dingtalk.com/document/orgapp-server/obtain-orgapp-token
- 获取用户信息:https://open.dingtalk.com/document/orgapp-server/obtain-the-userid-of-a-user-by-using-the-log-free
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】