DM-ROW 接口文档

Appearance

安全防护措施 ​

**本文引用的文件** - [AuthorizationServerConfig.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/config/AuthorizationServerConfig.java) - [CustomUserDetailsServiceImpl.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/CustomUserDetailsServiceImpl.java) - [PasswordAuthenticationProvider.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/password/PasswordAuthenticationProvider.java) - [CustomAuthenticationSuccessHandler.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/handler/CustomAuthenticationSuccessHandler.java) - [CustomeAuthenticationFailureHandler.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/handler/CustomeAuthenticationFailureHandler.java) - [FilterIgnoreProperties.java](file://lemes-cloud/lemes-framework/lemes-framework-core/src/main/java/com/lenovo/lemes/framework/core/config/FilterIgnoreProperties.java) - [SysLoginController.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/controller/SysLoginController.java) - [SysUserClient.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/feign/SysUserClient.java) - [CustomOAuth2AccessTokenGenerator.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/CustomOAuth2AccessTokenGenerator.java) - [CustomOAuth2RefreshTokenGenerator.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/CustomOAuth2RefreshTokenGenerator.java) - [CustomOAuth2TokenCustomizer.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/CustomOAuth2TokenCustomizer.java) - [AuthExceptionEntryPoint.java](file://lemes-cloud/lemes-framework/lemes-framework-auth/src/main/java/com/lenovo/lemes/framework/auth/exception/AuthExceptionEntryPoint.java) - [CustomAccessDeniedHandler.java](file://lemes-cloud/lemes-framework/lemes-framework-auth/src/main/java/com/lenovo/lemes/framework/auth/exception/CustomAccessDeniedHandler.java) - [OAuth2EndpointUtils.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/util/OAuth2EndpointUtils.java) - [BCryptPasswordEncoder.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/config/AuthorizationServerConfig.java) - [OpaqueTokenIntrospector.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/config/AuthorizationServerConfig.java) - [DelegatingOAuth2TokenGenerator.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/config/AuthorizationServerConfig.java) - [OAuth2AuthorizationService.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/password/PasswordAuthenticationProvider.java) - [OAuth2TokenGenerator.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/password/PasswordAuthenticationProvider.java) - [OAuth2Authorization.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/password/PasswordAuthenticationProvider.java) - [OAuth2AccessTokenAuthenticationToken.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/password/PasswordAuthenticationProvider.java) - [UsernamePasswordAuthenticationToken.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/password/PasswordAuthenticationProvider.java) - [AuthenticationManager.java](file://lemes-cloud/lemes-auth/src/main/java/com/lenovo/lemes/auth/security/password/PasswordAuthenticationProvider.java) - [ResultData.java](file://lemes-cloud/lemes-framework/lemes-framework-core/src/main/java/com/lenovo/lemes/framework/core/util/ResultData.java)

目录 ​

  1. 引言
  2. 项目结构
  3. 核心组件
  4. 架构总览
  5. 详细组件分析
  6. 依赖分析
  7. 性能考虑
  8. 故障排查指南
  9. 结论
  10. 附录

引言 ​

本文件面向安全工程师，系统化梳理 DeviceMate 项目的 Web 应用安全防护体系，覆盖认证授权、CSRF 防护、XSS 防护、SQL 注入防护、点击劫持防护、输入验证机制、接口安全（限流、频率控制、IP 白名单/黑名单、请求签名）、会话安全（会话固定、超时、并发控制、劫持防护）、网络安全（HTTPS 强制、CORS、HSTS、安全 Cookie）、安全扫描工具集成（OWASP ZAP、Burp Suite、SonarQube）以及安全事件响应流程。文档以代码为依据，结合架构图与流程图，帮助快速落地与持续改进。

项目结构 ​

DeviceMate 的后端采用微服务与网关架构，认证授权由独立模块负责，前端通过网关访问后端服务。与安全直接相关的关键位置如下：

  • 认证授权模块（lemes-auth）：OAuth2 授权服务器配置、用户加载、令牌生成与定制、认证成功/失败处理器。
  • 框架层（lemes-framework）：统一异常入口、访问拒绝处理、忽略路径配置、通用返回体。
  • 网关层（lemes-gateway）：路由与安全前置（可在此处集中配置 CORS、HSTS、安全头、限流等）。
  • 业务服务（lemes-service-dm-*）：具体业务接口，需遵循统一安全策略。

图表来源

章节来源

核心组件 ​

  • OAuth2 授权服务器配置：集中定义令牌端点转换器、认证提供者、资源服务器、忽略路径、异常与访问拒绝处理、CSRF 关闭与 frameOptions 禁用等。
  • 用户加载与认证：通过 Feign 客户端加载用户详情，构建自定义 UserDetails，并交由认证管理器完成密码校验。
  • 令牌生成与定制：自定义访问令牌与刷新令牌生成器，注入用户信息到令牌声明中。
  • 统一返回体与异常处理：认证成功/失败输出统一 JSON 结构；资源服务器异常入口与访问拒绝处理确保前后端一致的错误语义。

章节来源

架构总览 ​

下图展示认证授权链路与关键安全组件交互：

图表来源

详细组件分析 ​

CSRF 攻击防护 ​

  • 授权服务器已显式关闭 CSRF（见授权链路配置），并禁用内嵌页面渲染（frameOptions）。该策略适用于无状态令牌场景，但需确保前端不依赖同源表单提交，且所有敏感操作均通过令牌鉴权。
  • 建议：在网关层对特定表单类接口启用额外防护（如一次性令牌或 SameSite Cookie），并在前端严格校验来源域名。

章节来源

XSS 跨站脚本防护 ​

  • 令牌与错误响应通过统一 JSON 返回体输出，避免在 HTML 中直接拼接动态内容；前端渲染应使用安全的模板引擎或框架内置转义。
  • 建议：在网关层统一设置 Content-Security-Policy 头，限制脚本来源与内联脚本执行；对富文本输入进行白名单过滤与转义。

章节来源

SQL 注入防护 ​

  • 认证与用户查询通过 Feign 客户端调用，建议在服务端使用 ORM 的参数化查询或命名参数绑定，避免字符串拼接 SQL。
  • 建议：对所有数据库访问层启用参数化查询与最小权限原则；对敏感字段加密存储（如密码）。

章节来源

点击劫持防护 ​

  • 授权服务器已禁用 frameOptions，可能降低点击劫持风险，但需在网关层统一设置 X-Frame-Options 或 CSP 的 frame-ancestors 策略。
  • 建议：在网关层为所有响应添加 X-Frame-Options: DENY 或 CSP: frame-ancestors 'none'。

章节来源

输入验证机制 ​

  • 参数校验：密码模式认证提供者对授权范围与客户端类型进行校验，防止越权与非法授权类型。
  • 数据类型验证：用户名/密码参数通过认证管理器进行类型与格式校验。
  • 长度限制与特殊字符过滤：建议在网关层对请求体与查询参数设置长度上限与白名单过滤（仅允许字母数字与必要符号），并在服务端对关键字段进行二次校验。
  • 建议：引入参数校验注解（如 JSR-303）与全局异常处理，统一拦截非法参数。

章节来源

接口安全防护 ​

  • API 限流与请求频率控制：建议在网关层基于 IP/客户端维度实现令牌桶/漏桶算法限流；对/oauth/token 端点单独限流。
  • IP 白名单/黑名单：在网关层对来源 IP 进行黑白名单过滤，阻断异常来源。
  • 请求签名验证：对关键接口启用签名（时间戳+随机数+参数排序+密钥哈希），网关层校验签名后放行。
  • 建议：结合分布式缓存实现限流与签名去重，避免重复请求。

章节来源

会话安全机制 ​

  • 会话固定攻击防护：采用无状态令牌模型，不使用传统 Session，避免会话固定风险。
  • 会话超时设置：通过自定义令牌生成器设置访问令牌与刷新令牌有效期，建议访问令牌短期（如 15-30 分钟），刷新令牌较长（如 7 天）。
  • 并发会话控制：可在令牌定制器中加入并发会话数量限制与互斥策略，拒绝新登录覆盖旧令牌。
  • 会话劫持防护：令牌传输必须走 HTTPS；令牌存储于 HttpOnly Cookie 或安全存储；对敏感操作要求二次校验（如短信/邮箱验证码）。

章节来源

网络安全防护 ​

  • HTTPS 强制使用：在网关层强制 443 端口与 TLS1.2+，禁用弱加密套件；对证书进行自动续期与监控。
  • CORS 跨域配置：在网关层统一配置允许来源、方法、头与凭据；对生产环境严格限定来源。
  • HSTS 安全头设置：在网关层为 HTTPS 响应添加 Strict-Transport-Security 头，提升抗降级攻击能力。
  • 安全 Cookie 配置：在网关层统一设置 SameSite、Secure、HttpOnly 属性，防止 XSS 与 CSRF。

章节来源

安全扫描工具集成 ​

  • OWASP ZAP：在 CI/CD 流水线中集成 ZAP 扫描，对登录、令牌刷新、用户管理等关键路径进行自动化扫描。
  • Burp Suite：用于手动渗透测试与 API 接口深度扫描，重点关注认证绕过、参数注入与敏感信息泄露。
  • SonarQube：开启安全规则集（如 OWASP Top 10、CWE），对认证模块与用户查询接口进行静态扫描与告警。

章节来源

安全事件响应机制 ​

  • 安全告警：对认证失败、异常登录、频繁限流触发、签名失败等事件进行日志采集与告警。
  • 应急处置：冻结受影响账户、撤销相关令牌、临时封禁来源 IP、回滚可疑变更。
  • 漏洞修复流程：发布补丁、更新令牌策略、加强输入校验与限流策略，并进行回归测试与渗透验证。

章节来源

依赖分析 ​

认证链路关键依赖关系如下：

图表来源

章节来源

性能考虑 ​

  • 令牌生成与序列化：自定义令牌生成器与声明定制应避免重型计算，优先使用轻量声明与高效序列化。
  • 认证链路：认证提供者与用户加载应尽量减少远程调用次数，必要时引入本地缓存与异步刷新。
  • 限流与熔断：网关层限流策略应具备滑动窗口与突发处理能力，避免对正常流量造成过大影响。

故障排查指南 ​

  • 认证失败：检查用户名/密码是否正确、客户端授权类型是否匹配、作用域是否越权；查看认证失败处理器日志。
  • 令牌无效：确认令牌有效期、签名与声明是否被篡改；检查资源服务器配置与透明代理设置。
  • 跨域问题：核对网关 CORS 配置与前端请求头；确保预检请求通过。
  • 限流触发：检查来源 IP 与速率阈值；确认是否误伤正常用户。

章节来源

结论 ​

DeviceMate 的认证授权模块已采用无状态令牌模型并具备基础安全配置。建议在网关层补齐 CORS、HSTS、安全 Cookie、限流与签名策略，并完善输入验证、XSS 与点击劫持防护。通过持续集成安全扫描与事件响应流程，可显著提升整体安全性与合规性。

附录 ​

  • 忽略路径配置：用于开放无需鉴权的静态资源或健康检查接口，需定期审计。
  • 统一返回体：确保前后端一致的错误语义与调试信息。

章节来源