Smart-SSO 项目使用教程

Smart-SSO 项目使用教程

smart-sso springboot SSO 单点登录，OAuth2实现，支持App登录，支持分布式 项目地址: https://gitcode.com/gh_mirrors/smar/smart-sso

1. 项目的目录结构及介绍

Smart-SSO 项目是一个基于 SpringBoot 和 OAuth2 的单点登录权限认证系统。项目的目录结构如下：

smart-sso
├── smart-sso-demo           # 客户端示例
├── smart-sso-demo-h5        # 前后端分离客户端示例
├── smart-sso-server         # 单点登录权限管理服务端
├── smart-sso-starter        # 依赖装配模块
│   ├── smart-sso-starter-base       # 公用的基础常量、工具、凭证清理机制
│   ├── smart-sso-starter-client     # 客户端依赖包，客户端Token生命周期管理
│   ├── smart-sso-starter-client-redis # 客户端依赖装配，分布式部署场景redis支持
│   ├── smart-sso-starter-server     # 服务端依赖包，服务端凭证生命周期管理
│   └── smart-sso-starter-server-redis # 服务端依赖装配，分布式部署场景redis支持
└── pom.xml                  # 项目依赖管理文件

smart-sso-demo

客户端示例，展示了如何接入单点登录系统。

smart-sso-demo-h5

前后端分离客户端示例，适用于无Cookie模式的前后端分离架构。

smart-sso-server

单点登录权限管理服务端，负责认证和权限管理。

smart-sso-starter

依赖装配模块，包含基础常量、工具类、客户端和服务端的Token生命周期管理等。

2. 项目的启动文件介绍

项目的启动文件位于各个模块的 src/main/java 目录下。

smart-sso-server 的启动文件

位于 smart-sso-server/src/main/java/com/smart/sso/server 目录下的 SmartSsoServerApplication.java。

@SpringBootApplication
public class SmartSsoServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(SmartSsoServerApplication.class, args);
    }
}

smart-sso-demo 的启动文件

位于 smart-sso-demo/src/main/java/com/smart/sso/demo 目录下的 SmartSsoDemoApplication.java。

@SpringBootApplication
public class SmartSsoDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(SmartSsoDemoApplication.class, args);
    }
}

smart-sso-demo-h5 的启动文件

位于 smart-sso-demo-h5/src/main/java/com/smart/sso/demo/h5 目录下的 SmartSsoDemoH5Application.java。

@SpringBootApplication
public class SmartSsoDemoH5Application {
    public static void main(String[] args) {
        SpringApplication.run(SmartSsoDemoH5Application.class, args);
    }
}

3. 项目的配置文件介绍

项目的配置文件通常位于各个模块的 src/main/resources 目录下。

application.properties

这是 SpringBoot 的标准配置文件，用于配置各种属性，如数据库连接信息、端口号等。

# 应用服务端口
server.port=8080

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/smart_sso?useUnicode=true&characterEncoding=utf-8&useSSL=false
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# 其他配置...

application.yml

如果需要更复杂的配置，可以使用 YAML 格式的配置文件。

server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/smart_sso?useUnicode=true&characterEncoding=utf-8&useSSL=false
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver

# 其他配置...

确保配置文件中的设置符合您的项目环境和需求。在项目启动时，SpringBoot 会自动加载这些配置。

smart-sso springboot SSO 单点登录，OAuth2实现，支持App登录，支持分布式 项目地址: https://gitcode.com/gh_mirrors/smar/smart-sso