用途:在 ddd4j-boot 服务中选择并集成 Sa-Token、Apache Shiro 或 Spring Security,通过 boot auth 自动配置完成装配。使用前需先用 ddd4j-boot-version-selection 确认维护线。
主要能力:将 ddd4j Subject 契约通过 SubjectProvider 从所选安全框架填充;把认证异常(令牌过期、角色不足)映射到 Web 错误契约;审计请求清理,确保令牌与 Subject 状态不跨池化请求线程泄漏;在具体 Boot 线(2.3–4.1)上配置或覆盖认证默认值(用户 Bean 与 @ConditionalOnMissingBean 默认);验证匿名、有效、过期、角色不足、登出、线程复用等行为矩阵。
使用方式:依据当前目标线的 POM、源码与测试收集证据;比较三种框架后确认最终只装配一个主 SubjectProvider;核对条件装配、默认 Bean 与用户 Bean 覆盖点,确认关闭开关真正跳过装配;运行上下文与行为测试覆盖完整行为矩阵;报告时将配置存在、Bean 创建、行为、CI、发布分开陈述。缺失信息时输出“missing: target line/implementation/configuration; how to provide: supply the POM and acceptance behavior”,并继续安全的只读检查。
适用场景:dd4j-boot 服务的认证实现选型与 Spring Boot 装配、配置覆盖、生命周期与验证、维护线兼容性判断。
限制:不用于修改 Subject 契约或身份模型(改用 ddd4j-auth 或 ddd4j-core);不用于错误响应格式问题(改用 ddd4j-boot-web);不用于通用自动配置机制(改用 ddd4j-boot-autoconfiguration);运行时为 Javalin、Quarkus 或 Spring Cloud 时应使用对应技能;纯 Spring Boot 无 ddd4j 时本技能不适用。不得输出真实令牌或凭据,排障输出必须脱敏。未经授权不得提交或发布。