# 茶席的统一sso系统

**Repository Path**: tea-mat/chaxi-sso

## Basic Information

- **Project Name**: 茶席的统一sso系统
- **Description**: 尝试使用一个系统接入大部分可以自行搭建的系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Chaxi SSO System (统一通行证系统)
===============================

项目概述
--------
Chaxi SSO 是一个统一通行证系统，旨在为多个应用和服务提供集中化的身份验证和授权服务。该系统允许用户使用一组凭证访问所有相互信任的应用程序，从而提升用户体验和安全性。

核心功能
---------
- 用户身份验证（登录、注册、注销）
- 基于 JWT 的令牌生成与验证
- 用户权限管理
- 服务注册与管理
- 第三方服务集成支持

技术栈
-------
- **后端**: Node.js + Express + MongoDB + Mongoose + Passport.js + JWT
- **前端**: （未在代码结构中体现，但根据 README.md 推测可能使用现代前端框架）
- **安全**: 使用 Bcrypt 加密用户密码，JWT 用于安全令牌管理

项目结构
---------
- `backend/config/passport.js`: Passport.js 配置，包含 JWT 与本地策略
- `backend/middleware/auth.js`: JWT 认证中间件
- `backend/middleware/adminAuth.js`: 管理员身份验证中间件
- `backend/models/Service.js`: 服务模型定义
- `backend/models/User.js`: 用户模型定义，包含 Bcrypt 和 JWT 处理

快速开始
---------

### 安装依赖

#### 安装后端依赖
```bash
cd backend
npm install
```

#### 安装前端依赖（如适用）
```bash
cd frontend
npm install
```

### 启动开发服务器

#### 启动后端服务
```bash
cd backend
npm run dev  # 使用 nodemon 启动开发服务器
```

#### 启动前端服务（如适用）
```bash
cd frontend
npm run serve  # 或根据前端框架使用相应命令
```

第三方服务集成
---------------
项目支持第三方服务的集成，通过 `Service` 模型进行管理。开发者可以扩展集成逻辑以支持 OAuth、OpenID 等协议。

开发计划
---------
- 实现完整的用户角色与权限系统
- 增加多因素认证（MFA）
- 支持 OAuth2 和 OpenID Connect 协议
- 提供 RESTful API 文档（如 Swagger）
- 增加前端管理界面

许可证
-------
该项目使用 MIT 许可证。请参阅 [LICENSE](LICENSE) 文件以获取详细信息。