cykj/hzdyjs

0 Fork 0

Files

T

zlwu 0ed820d7ce 提交代码

2025-08-02 21:06:47 +08:00

5.4 KiB

Raw Blame History

MinIO安全后端实现变更记录

📅 变更信息

变更时间: 2025-01-27 16:00:00
变更类型: 安全加固 - 后端实现
影响范围: 文件存储系统后端
变更人员: 系统管理员

🔧 后端代码实现

1. 新增文件访问控制器 ✅

文件: backend/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysFileAccessController.java

功能:

提供安全的文件访问接口
实现预签名URL机制
支持单个和批量文件访问
区分下载和预览操作
完整的权限检查和日志记录

主要接口:

GET /resource/file/access/{ossId} - 获取文件临时访问URL
POST /resource/file/access/batch - 批量获取文件临时访问URL
GET /resource/file/download/{ossId} - 获取文件下载URL
GET /resource/file/preview/{ossId} - 获取文件预览URL

2. 更新OSS服务接口 ✅

文件: backend/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/ISysOssService.java

新增方法:

checkFileAccessPermission(Long ossId) - 检查文件访问权限
logFileAccess(Long ossId, Long userId, String accessType, String ipAddress, String userAgent) - 记录文件访问日志
getFileAccessUrl(Long ossId, Integer expireSeconds) - 获取文件临时访问URL

3. 更新OSS服务实现 ✅

文件: backend/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysOssServiceImpl.java

实现内容:

基础权限检查逻辑（文件存在性验证）
访问日志记录（目前为日志输出，后续可扩展为数据库记录）
预签名URL生成和权限验证

4. 更新现有OSS控制器 ✅

文件: backend/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysOssController.java

改进:

在现有下载方法中添加权限检查
添加访问日志记录
增强安全性，防止未授权访问

5. 创建实体类 ✅

文件:

backend/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/domain/SysFilePermission.java - 文件权限实体
backend/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/domain/SysFileAccessLog.java - 文件访问日志实体

用途: 为后续的权限管理和访问审计功能提供数据模型

6. 创建前端API ✅

文件: web/src/api/system/file.ts

功能:

提供安全的文件访问API
支持单个和批量文件操作
包含安全下载和预览方法
完整的错误处理

7. 更新下载工具 ✅

文件: web/src/plugins/download.ts

改进:

更新现有的oss()方法使用新的安全机制
新增secureOss()方法提供更安全的下载
使用预签名URL替代直接文件访问

🔐 安全机制

权限检查流程

用户身份验证: 检查用户是否已登录
文件存在性验证: 确认文件在数据库中存在
权限验证: 检查用户是否有权限访问该文件
预签名URL生成: 生成临时有效的访问URL
访问日志记录: 记录所有文件访问行为

预签名URL机制

有效期: 默认300秒（5分钟）
安全性: 临时有效，过期自动失效
权限控制: 基于用户身份和文件权限
访问追踪: 完整的访问日志记录

📊 技术实现细节

后端安全特性

✅ 身份验证: 基于Sa-Token的用户身份验证
✅ 权限控制: 文件访问权限检查
✅ 访问日志: 完整的访问行为记录
✅ IP追踪: 记录访问者IP地址
✅ 用户代理: 记录浏览器信息
✅ 错误处理: 完善的异常处理机制

前端安全特性

✅ 安全API: 使用预签名URL访问文件
✅ 权限验证: 前端调用前进行权限检查
✅ 错误处理: 友好的错误提示
✅ 加载状态: 显示文件访问进度

🚀 实施效果

安全性提升

消除直接访问风险: 文件不再通过HTTP直接访问
临时访问控制: 预签名URL具有时效性
权限验证: 每次访问都进行权限检查
访问追踪: 完整的访问行为记录

兼容性保证

向后兼容: 现有接口保持兼容
渐进式升级: 可以逐步迁移到新机制
错误处理: 完善的错误处理机制

⚠️ 注意事项

1. 数据库配置

需要执行 script/minio-security-implementation.sql 更新数据库配置
将OSS配置的访问策略改为PRIVATE

2. MinIO配置

需要将MinIO bucket策略改为private
确保预签名URL功能正常工作

3. 前端适配

现有前端代码需要逐步迁移到新的安全API
建议优先更新文件下载和预览功能

4. 性能考虑

预签名URL生成会增加少量延迟
建议适当缓存权限检查结果
监控文件访问性能

📈 后续计划

第一阶段：基础安全加固（已完成）

✅ 后端安全接口实现
✅ 预签名URL机制
✅ 基础权限检查
✅ 访问日志记录

第二阶段：权限管理完善（计划中）

🔄 实现基于角色的文件权限控制
🔄 添加文件权限管理界面
🔄 实现细粒度权限控制

第三阶段：监控审计（计划中）

🔄 文件访问监控大屏
🔄 异常访问告警
🔄 访问统计分析

📝 备注: 本次变更完成了MinIO安全加固的后端核心实现，为前端安全改造奠定了基础。建议在测试环境充分验证后再部署到生产环境。

5.4 KiB Raw Blame History