项目简介
本项目是基于Spring Boot和Vue3构建的统一认证平台,名为ETScaffold。它依据OAuth 2.1和OpenID Connect 1.0规范提供认证服务,具备多租户管理和全面的权限系统,适用于有统一认证和权限管理需求的应用场景。
项目的主要特性和功能
- 统一认证服务:支持OAuth 2.1和OpenID Connect 1.0规范,保障认证服务的安全性。
- 多租户管理:采用多租户架构,满足不同租户的独立认证需求。
- 全面的权限系统:提供细粒度的权限控制,增强系统的安全性与可控性。
- 前后端分离:后端使用Spring Boot框架,前端运用Vue3 + TypeScript,实现高效的前后端分离开发。
- 自定义异常处理:提供多种自定义异常处理机制,确保系统在异常情况下的稳定性和可维护性。
- API客户端封装:封装管理中心API客户端,方便与管理中心交互,获取登录状态、用户信息和用户权限等。
安装使用步骤
后端环境
- 配置文件:
修改
application-dev.yml
文件,配置oauth - server地址和管理中心后端地址。 示例配置:yaml oauth-server: http://zj.etena.cn:19001 etcloud-server: http://zj.etena.cn/etcloud
- 启动后端应用:
运行
ETScaffoldSystemApplication
类,启动Spring Boot应用。
前端环境
- 配置文件:
修改
.env.development
文件,配置后台接口全路径地址和OAuth2单点登录信息。 示例配置:VITE_GLOB_DOMAIN_URL=http://localhost:8080/etscaffold-system VITE_OAUTH2_URI=http://zj.etena.cn:19001/oauth2/authorize VITE_OAUTH2_LOGOUT_URI=http://zj.etena.cn:19001/oauth2/logout VITE_OAUTH2_CLIENTID=1Xl53T3UEdDwxd3_TcyUF VITE_OAUTH2_SCOPE=all openid profile VITE_OAUTH2_REDIRECTURI=http://localhost:4100/oauth2/authorized
- 基础环境安装:
安装Node.js和pnpm。
示例命令:
bash node -v npm -v npm install pnpm -g pnpm -v
- 启动项目:
进入前端项目目录,安装依赖并启动项目。
示例命令:
bash cd etscaffold-vue3 pnpm install pnpm dev
- 访问系统:
访问地址:
http://localhost:4100/
用户名/密码:cmcc/123
接口文档
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】