Dante Cloud 2.7.5.3 全新适配 “SAS” 0.4.0 版本-你53-代码开源技术分享

Dante Cloud 是一款企业级微服务架构和服务能力开发平台。首个全面拥抱 Spring Authorization Server 的版本，基于 Spring Authorization Server 0.4.0、Spring Boot 2.7.5、Spring Cloud 2021.0.5、Spring Cloud Alibaba 2021.0.4.0、Nacos 2.1.2 等最新版本开发的多租户系统，遵循 SpringBoot 编程思想，高度模块化和可配置化。具备服务发现、配置、熔断、限流、降级、监控、多级缓存、分布式事务、工作流等功能

平台定位

构建成熟的、完善的、全面的，基于 OAuth2.1 的、前后端分离的微服务架构解决方案。
面向企业级应用和互联网应用设计开发，既兼顾传统项目的微服务化，又满足互联网应用开发建设、快速迭代的使用需求。
平台架构使用微服务领域及周边相关的各类新兴技术或主流技术进行建设，是帮助快速跨越架构技术选型、研究探索阶段的利器。
代码简洁规范、结构合理清晰，是新技术开发应用的典型的、综合性案例，助力开发人员对新兴技术的学习和掌握。

[1]、为什么更名为 Dante Cloud

Dante Cloud (但丁)，原项目名称 Eurynome Cloud，很多朋友都反映名字太长、读起来拗口、不容易记等问题。因此在加入 Dromara 开源社区之际，将名字进行了变更。

Dante，即但丁・阿利基耶里 (公元 1265 年 – 公元 1321 年)，13 世纪末意大利诗人，现代意大利语的奠基者，欧洲文艺复兴时代的开拓人物之一，以长诗《神曲》(原名《喜剧》) 而闻名，后来一位作家叫薄伽丘将其命名为神圣的喜剧。

他被认为是中古时期意大利文艺复兴中最伟大的诗人，也是西方最杰出的诗人之一，最伟大的作家之一。恩格斯评价说：“封建的中世纪的终结和现代资本主义纪元的开端，是以一位大人物为标志的，这位人物就是意大利人但丁，他是中世纪的最后一位诗人，同时又是新时代的最初一位诗人”

更名为 Dante Cloud，寓意本项目会像恩格斯对但丁的评价一样，在行业变革的时期，可以成为一款承上启下，助力企业信息化建设变革的产品。

[2]、本次更新内容

主要更新
- [升级] Spring Authorization Server 版本升级至 0.4.0
- [重构] 按照 Spring Authorization Server 0.4.0 最新代码结构和 API 用法，重构认证授权相关代码。
其它更新
- [新增] 新增 Token Settings 授权码模式 Code 有效时间字段。
- [优化] OAuth2 Application 中 accessTokenTimeToLive、refreshTokenTimeToLive、authorizationCodeTimeToLive 属性的默认值，修改为与 Spring Authorization Server TokenSettings 一致。
- [优化] 优化数据库初始化脚本中的初始数据，与 Spring Authorization Server 0.4.0 最新代码适配
- [优化] 优化分布式微服务 Session 共享配置。解决 Session 共享在 Gateway 中，出现注入重复导致无法启动问题。
- [升级] 升级 Antisamy XSS 攻击防护规则脚本。
依赖更新
- [升级] antisamy 版本升级至 1.7.2
- [升级] springdoc 版本升级至 1.6.13
- [升级] minio 版本升级至 8.4.6
- [升级] fastjson2 版本升级至 2.0.19
- [升级] Hutool 版本升级至 5.8.10
- [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.633
- [升级] alipay-sdk-java 版本升级至 4.34.52.ALL
友情提示
- 本次更新涉及核心数据的修改，详情参见在线文档升级指南章节

[3]、Dante Cloud 2.7.X 特点

一、前端

未使用任何流行开源模版，使用全新技术栈，完全纯 “手写” 全新前端工程。
借鉴参考流行开源版本的使用和设计，新版前端界面风格和操作习惯尽量与当前流行方式统一。
充份使用 Typescript 语言特性，解决大量类型校验问题，尽可能规避 “any” 式的 Typescript 编程语言使用方式。
充份使用 Composition Api 和 Hooks 等 Vue3 框架新版特性进行代码编写。
充份利用 Component、Hooks 以及 Typescript 面向对象等特性，抽取通用组件和代码，尽可能降低工程重复代码。
对较多 Quasar 基础组件和应用功能组件进行封装，以方便代码的统一修改维护和开发使用。
对生产模式下，对基于 Vite3 的工程打包进行深度性能优化。
提供以 docker-compose 方式，对工程生产代码进行容器化打包和部署。
支持密码模式、授权码模式、手机短信模式、第三方社会化等多种登录模式。

二、后端

基于 Spring Authorization Server 深度定制和扩展:

基于 Spring Authorization Server 和 Spring Data JPA 实现多租户系统架构，支持 Database 和 Schema 两种模式。
基于 Spring Data JPA，重新构建 Spring Authorization Server 基础数据存储代码，替代原有 JDBC 数据访问方式，破除 Spring Authorization Server 原有数据存储局限，扩展为更符合实际应用的方式和设计。
基于 Spring Authorization Server，在 OAuth 2.1 规范基础之上，增加自定义 Resource Ownership Password (密码) 认证模式，以兼容现有基于 OAuth 2 规范的、前后端分离的应用，支持 Refresh Token 的使用。
基于 Spring Authorization Server，在 OAuth 2.1 规范基础之上，增加自定义 Social Credentials (社会化登录) 认证模式，支持手机短信验证码、微信小程序、基于 JustAuth 的第三方应用登录，支持 Refresh Token 的使用。
扩展 Spring Authorization Server 默认的 Client Credentials 模式，实现 Client Credentials 模式支持 Refresh Token 的使用。
扩展 Spring Authorization Server 默认的 Client Credentials 模式，实现真正的使用 Scope 权限对接口进行验证。增加客户端 Scope 的权限配置功能，并与已有的用户权限体系解耦
支持 Spring Authorization Server Authorization Code PKCE 认证模式
支持 Spring Authorization Server 的标准的 JWT Token 加密校验方式外，新增基于自定义证书的 JWT Token 加密校验方式，可通过配置动态修改。
支持 Opaque Token (不透明令牌) 格式及校验方式，将低 JWT Token 被捕获解析的风险。可通过修改配置参数，设置默认 Token 格式是采用 Opaque Token 格式还是 JWT Token 格式。
全面支持 OpenID Connect (OIDC) 协议，系统使用时可根据使用需求，通过前端开关配置，快速切换 OIDC 模式和传统 OAuth2 模式
深度扩展 Authorization Code、Resource Ownership Password、Social Credentials 几种模式，全面融合 IdToken、Opaque Token、JWT Token 与现有权限体系，同时提供 IdToken 和自定义 Token 扩展两种无须二次请求的用户信息传递方式，减少用户信息的频繁请求。
自定义 Spring Authorization Server 授权码模式登录认证页面和授权确认页面，授权码模式登录采用数据加密传输。支持多种验证码类型，暂不支持行为验证码。
基于 JetCache 的多级缓存支持，实现自定义 Spring Data JPA 二级缓存，有效解决 Spring Cache 查询缓存更新问题。
全面整合 @PreAuthorize 注解权限与 URL 权限，通过后端动态配置，无须在代码中配置 Spring Security 权限注解以及权限方法，即可实现接口鉴权以及权限的动态修改。采用分布式鉴权方案，规避 Gateway 统一鉴权的压力以及重复鉴权问题
采用分布式服务独立鉴权方案，Spring Security @PreAuthorize 的权限注解、权限方法以及 URL 权限，通过后端动态配置后，实时动态分发至对应服务。
OAuth2 UserDetails 核心数据支持直连数据库获取和 Feign 远程调用两种模式。OAuth2 直连数据库模式性能更优，Feign 访问远程调用可扩展性更强。可通过配置动态修改采用策略方式。
基于自定义 Session，混合国密 SM2 (非对称) 和 SM4 (对称加密) 算法，实现秘钥动态生成加密传输。利用 “一人一码机制”，实现密码模式登录数据进行动态加密传输。配合 OAuth2 Client 验证，保护接口调用和前后端数据传输的合理性及安全性。

[4]、界面预览

图片[1]-Dante Cloud 2.7.5.3 全新适配 “SAS” 0.4.0 版本-你53-代码开源技术分享图片[2]-Dante Cloud 2.7.5.3 全新适配 “SAS” 0.4.0 版本-你53-代码开源技术分享图片[3]-Dante Cloud 2.7.5.3 全新适配 “SAS” 0.4.0 版本-你53-代码开源技术分享图片[4]-Dante Cloud 2.7.5.3 全新适配 “SAS” 0.4.0 版本-你53-代码开源技术分享

Dromara 开源社区

一、社区愿景

让每一位开源爱好者，体会到开源的快乐。

二、社区官网

https://dromara.org 是 Dromara 开源社区官方网站。

三、成员项目

图片[5]-Dante Cloud 2.7.5.3 全新适配 “SAS” 0.4.0 版本-你53-代码开源技术分享

Dante Cloud 的下载地址：点击下载

详细功能说明

(1) 统一安全认证中心

功能	说明
OAuth2.0 安全认证	支持 OAuth2.0 授权码模式、隐式授权码模式（简单模式）、密码模式和客户端模式四种登录模式
JWT Token 令牌	采用 JWT 对 OAuth2 Token 进行加密
自定义 OAuth2 页面	自定义 OAuth2 login、confirm、error 页面，提升系统使用用户体验。可结合自身需求进行修改。
OAuth2 登录验证码	OAuth2 登录增加验证码保护，支持 gif、中文、算数等类型，可通过配置进行修改以及是否显示验证码控制
OAuth2 登录数据加密传输	基于 AES 对 OAuth2 登录数据进行动态加密传输，可通过配置对表单参数名进行动态配置，提升系统安全性
RBAC 权限管理	采用自研的 RBAC 权限体系，支持 OAuth2 Scope 权限管理
User、Client 数据策略访问	支持 OAuth2 UserDetails、ClientDetails 数据直连数据库和 Feign 两种数据获取策略模式，OAuth2 直连数据库性能更优，Feign 访问数据服务独立可动态扩展。可通过配置动态修改具体采用哪种策略
手机短信验证码注册和登录	支持通过手机验证码登录认证，与平台为统一体系，统一返回 OAuth2 Token，支持服务接口鉴权。
第三方系统社交注册和登录	基于 JustAuth 实现第三方系统社交登录认证，，与平台为统一体系，统一返回 OAuth2 Token，支持服务接口鉴权，。所有 JustAuth 支持的第三方系统均支持。
微信小程序注册和登录	支持微信小程序登录认证，与平台为统一体系，统一返回 OAuth2 Token，支持服务接口鉴权。
其它注册和登录	采用策略模式对外部登录和注册进行支持，目前未支持的登录，可参考标准，动态扩展，即可支持。
权限鉴权	基于 RBAC 模型，以角色为核心，无须配置 Security 权限注解，支持 URL 粒度的鉴权和用户权限的动态配置，

(2) 统一服务访问网关

功能	说明
网关动态路由	基于 Gateway 和 Nacos 实现服务网关动态路由，无须增加任何配置，即可支持服务的发现与路由
网关服务鉴权	服务网关集成部分权限认证功能，提升系统安全性，降低平台压力
网关服务限流	基于 Sentinel 实现服务的限流，支持基于 Gateway Filter 的自定义限流
动态文档聚合	网关动态 Swagger 文档聚合，使用 Swagger 3.0，支持 Knife4j 增强。不同环境访问控制
统一跨域处理	基于 Gateway 实现统一跨域处理
统一错误处理	平台统一错误处理，支持自定义错误码体系
自定义动态路由	支持基于 DB 的动态路由管理与路由规则配置

(3) 微服务架构支撑

功能	说明
服务注册发现	基于 Nacos 实现服务的注册与发现。
服务负载均衡	Spring Cloud Netflix 停止维护，使用 Spring Cloud Loadbalancer 全面替换 Ribbon，
服务熔断降级	整合 OpenFeign 和 Sentinel，从熔断降级、系统负载保护、热点防护等多个维度来保障微服务的稳定性
统一配置中心	基于 Nacos 搭建的统一配置中心，使用 MySQL8，支持配置文件自动导入和关键信息加密，可根据文件夹名称自动分组配置。
统一日志中心	采用 TCP 直连的方式采集和发送日志，集成 Skywalking TraceID 实现日志聚合及 ELK 日志分析。通过 @EnableXXX 注解开启或关闭日志采集功能。
分布任务调度	极简集成 xxl-job，支持分布式任务调度功能
分布事务处理	集成 Seata，支持分布式事务，无代码侵入，灵活便捷
分布对象存储	支持 Minio 分布式对象存储。同时，集成阿里云 OSS，可通过 @EnableXXX 注解开启或关闭功能。

(4) 微服务运行监控

功能	说明
服务调用链监控	集成 Skywalking 进行服务调用链的监控，调用链监控深度可延伸至 Undertow、数据库、Redis
应用吞吐量监控	集成 Skywalking 进行应用吞吐量监控
熔断、降级监控	集成 Sentinel 进行服务的熔断、降级监控
微服务状态监控	集成 Spring Boot Admin 进行服务运行状态的监控

(5) 数据自动化处理

功能	说明
数据模型初始化	RBAC、OAuth2 部分核心表、Camunda 数据表，在初始部署过程中为自动化创建
核心应用数据初始化	RBAC、OAuth2 等核心数据，在初始部署过程中为自动化导入
URL 权限数据动态汇总	自动扫描 URL 接口作为权限汇总存入系统，根据 URL 相关信息生成唯一 ID，多次导入数据不会重复。可通过配置动态开启或修改扫描内容
Yml 配置自动导入	服务所需使用的配置文件，可自动根据文件夹进行分组并导入到 Nacos 中。

(6) 服务开发支撑

功能	说明
通用 CRUD 封装	各种类型的代码生成器较多，结合实际应用使用效果来看，代码生成器在实际开发中使用频率低于理想预期。因此，没有考虑提供代码生成器，而是对常规的 CRUD 进行了多层次的封装，使定制化服务的开发更加便捷。
自研两级缓存封装	使用 JetCache 实现本地、Redis 两级缓存。结合 CRUD 操作，自研数据缓存的封装，支持分页及简单条件查询缓存数据的动态更新，规避 Spring Cache 等缓存创建 Key 繁琐和分页数据无法更新的问题
多类型数据库支持	默认采用 postgresql 数据库，支持 MySQL、Oracle、H2 等多种关系型数据库，无须修改代码可动态切换。数据层同时支持 Spring Data Jpa 和 Mybatis
多消息队列支持	适配 RabbitMQ 和 Kafka，默认使用 Kafka，支持消息总线 (Spring Cloud Bus)
多种服务调用方式	默认采用 OpenFeign 进行服务间调用，支持 RestTemplate 和 OkHttps
共享式多环境切换	共享式、统一化多环境配置模式，Yml、Docker 均采用此方式配置，避免类似的服务配置、Dockerfile 配置导出复制和修改的问题
多团队开发管理	支持多团队开发，可针对各个团队开发服务，进行单独的授权配置。
注解模型模块模式	除必要依赖逻辑以及强注入顺序要求的模块采用 Spring SPI（spring.factories）机制外，其它功能模块均采用 @EnableXXX 注解编程模型，可选择性进行控制是否开启对应模块，减少不必要的依赖注入和启动。
代码打包记录查询	对代码编译信息进行记录，可查询代码版本以及编译时间等相关信息，方便运维人员更好的掌握代码信息。

(7) 信息发送集成

功能	说明
微信小程序订阅消息	支持微信小程序订阅消息发送。提供订阅消息模版工厂，可根据自身业务需求，编写少量代码既可以拓展支持新订阅消息模版。
极光消息推送集成	集成极光消息推送，对极光后台 API 进行封装，封装度高、调用方便，可快速与自定义业务需求整合，通过 @EnableXXX 注解开启或关闭。
环信消息集成	集成环信 IM 和消息推送，使用更加便捷，可在应用中根据自定义需求快速整合和拓展 IM，发送手机推送消息。通过 @EnableXXX 注解开启或关闭。
多通道 SMS 集成	集成阿里、百度、中国移动、华为、京东、极光、网易、七牛、腾讯、又拍、云片等平台短信发送通道。可通过配置动态选择具体使用通道。支持多模版定义以及模版参数顺序控制

(8) 内容审核集成

功能	说明
阿里云内容审核	集成阿里云内容审核，支持文本、图片、音频、视频、网页内容审核，支持同步审核、异步审核、异步 Callback 方式审核通过 @EnableXXX 注解开启或关闭。
微信小程序内容审核	集成微信小程序内容审核，支持文本、图片、音频内容审核，支持同步、异步审核。通过 @EnableXXX 注解开启或关闭。
百度证照识别	集成百度证照审核，支持营业执照、身份证 OCR 识别。通过 @EnableXXX 注解开启或关闭。
天眼查企业信息查询	集成天眼查企业信息查询。通过 @EnableXXX 注解开启或关闭。

[2]、技术栈和版本说明

（1）Spring 全家桶及核心技术版本

组件	版本
Spring Boot	2.7.2
Spring Cloud	2021.0.3
Spring Cloud Alibaba	2021.0.1.0
Spring Boot Admin	2.7.3
Spring Authorization Server	0.3.1
Nacos	2.1.0
Sentinel	1.8.3
Seata	1.3.0

（2）所涉及的相关的技术：

JSON 序列化：Jackson & FastJson
消息队列：Kafka 适配 RabbitMQ，支持消息总线 (Spring Cloud Bus)
数据缓存：JetCache + Redis （两级缓存）
数据库： Postgresql，MySQL，Oracle …
前端实现：Vue + Vuetify（单体版 Vue + Vuetify + Typescript + 模块化）
持久层框架： Spring Data Jpa & Mybatis
API 网关：Gateway
服务注册 & 发现和配置中心: Nacos
服务消费：OpenFeign & RestTemplate & OkHttp3
负载均衡：Spring Cloud Loadbalancer
服务熔断 & 降级 & 限流：Sentinel
分布式事务：Seata
服务监控：Spring Boot Admin
链路跟踪：Skywalking
文件服务：阿里云 OSS/Minio
数据调试：p6spy
日志中心：ELK
日志收集：Logstash Logback Encoder，Skywalking

（3）前端工程技术栈

– Vue3
– Vite3
– Pinia
– Typescript
– Quasar2
– Vue-Router 4
– Vueliate

[3]、版本号说明

本系统版本号，分为四段。

第一段和第二段，与 Spring Boot 版本对应，根据采用的 Spring Boot 版本变更。例如，当前采用 Spring Boot 2.4.6 版本，那么就以 2.4.X.X 开头
第三段，表示系统功能的变化
第四段，表示系统功能维护及优化情况

[4]、工程结构

dante-cloud
├── configurations -- 配置文件脚本和统一Docker build上下文目录
├── dependencies -- 工程Maven顶级依赖，统一控制版本和依赖
├── module -- 依赖组件半成品拼装工程
├    ├── dante-module-common -- Module 相关模块公共辅助代码组件
├    ├── dante-module-security -- Security 相关配置代码模块组件
├    ├── dante-module-upms-logic -- UPMS 基础管理及共享代码模块组件
├    └── dante-module-upms-rest -- UPMS 基础管理接口模块组件
├── packages -- 基础核心Starter
├    ├── authorization-spring-boot-starter -- OAuth2 认证基础Starter，主要用于 UAA 认证服务器以及单体版 Dante Cloud
├    └── service-spring-boot-starter -- 平台接入应用服务通用 Starter
├── platform -- 平台核心服务
├    ├── dante-cloud-gateway -- 服务网关
├    ├── dante-cloud-monitor -- Spring Boot Admin 监控服务
├    ├── dante-cloud-upms -- 统一权限管理系统服务
├    └── dante-cloud-uaa -- 账户管理和统一认证模块
├── services -- 平台业务服务
├    ├── dante-cloud-bpmn-ability -- 工作流服务
├    ├── dante-cloud-bpmn-logic -- 工作流基础代码包
├    ├── dante-cloud-cmdb-ability -- 简约CMDB管理服务
└──  └── dante-cloud-cmdb-logic -- 简约CMDB基础代码包