📑 目录
🔭 概述
Garrison 是一个面向 Rust 生态的身份认证鉴权框架, 提供基于 Token 的会话管理、RBAC 权限模型、axum Web 框架集成等核心能力。
框架采用双抽象层 + 全局单例架构:
- dbnexus 数据库抽象层(SQLite / PostgreSQL / MySQL,由
GarrisonDaotrait 屏蔽后端差异) - oxcache 缓存抽象层(L1 内存 + L2 redis,承载会话与 Token 存储)
- GarrisonManager 全局单例,持有
Arc<GarrisonLogicDefault>(实现了 6 个子 trait:GarrisonCore/SessionLogic/PermissionLogic/TokenLogic/MfaLogic/PasswordLogic),业务方启动时一次性注入依赖即可使用静态 API
适用场景
- Web 应用认证:基于 axum/actix/warp 的 Web 服务需要登录认证、权限校验
- 微服务网关:API 网关层统一鉴权,支持 JWT/OAuth2/API Key 多种协议
- 企业级后台:RBAC 权限模型 + 会话管理 + 审计日志
- 多端 SSO:跨子系统单点登录,ticket 模型 + 一次性消费
✨ 特性
| 特性 | 说明 |
|---|---|
| ⚡ 零运行时开销 | 编译期 inventory::submit! 工厂注册,无反射、无动态加载 |
| 🔒 完整鉴权链 | 登录认证 → 权限校验 → 会话管理 → 路由拦截,开箱即用 |
| 📦 多后端抽象 | GarrisonDao + oxcache + dbnexus,切换存储后端零业务代码改动 |
| 🔧 可插拔扩展 | trait + Default 实现模式,替换任意组件(DAO / 策略 / 逻辑)无需改业务 |
| 🎯 Feature 门控 | 40+ 个特性域独立 feature flag,按需编译减小体积 |
| 📊 高可观测 | tracing 日志 + listener 事件订阅 + prometheus 指标(可选) |
| 🧪 高覆盖 | 3852+ 个测试通过(3787 lib + 65 E2E),95%+ 行覆盖率,clippy 零警告 |
| 🌐 Web 框架适配 | axum/actix/warp 三框架注解式 extractor(CheckLogin / CheckRole / CheckPermission + 过程宏) |
特性域覆盖(0.4.0~0.6.0 协议层与生产能力补齐)
| 特性域 | 状态 | 说明 |
|---|---|---|
| 登录认证 | ✅ 0.1.0 完成 | 基于 Token 的会话管理 |
| 权限认证 | ✅ 0.1.0 完成 | RBAC 权限模型 |
| Session 会话 | ✅ 0.1.0 完成 | 双模会话生命周期管理(Account + Token) |
| 路由拦截鉴权 | ✅ 0.1.0 完成 | axum Web 框架适配 |
| JWT | ✅ 0.2.0 完成 | JSON Web Token 签发与验证(HS256/HS512 + refresh) |
| OAuth2 | ✅ 0.2.0 完成 | 授权码 / 客户端凭证 / 密码模式 + 0.4.0 RefreshToken |
| 单点登录 (SSO) | ✅ 0.2.0 完成 | ticket 模型单点登录(一次性 60s TTL) |
| 微服务网关鉴权 | ✅ 0.2.0 完成 | API 签名 + nonce 防重放 |
| API 接口鉴权 | ✅ 0.2.0 完成 | API Key 生成 / 校验 / 吊销 / 轮换 |
| 临时凭证 | ✅ 0.2.0 完成 | 短期 token + issue/get/revoke/consume |
| TOTP 动态验证码 | ✅ 0.2.0 完成 | RFC 6238 二次验证 |
| Basic 认证 | ✅ 0.2.0 完成 | HTTP Basic Auth (RFC 7617) |
| Digest 认证 | ✅ 0.2.0 完成 | HTTP Digest Auth (RFC 7616) |
| 插件化扩展 | ✅ 0.2.0 完成 | GarrisonPlugin trait + inventory 注册 |
| 事件监听器 | ✅ 0.2.0 完成 / 0.4.2 扩展 | GarrisonListener trait + 15 个事件变体(0.4.2 新增 9 个) |
| OIDC(OpenID Connect) | ✅ 0.4.0 完成 | id_token 签发/验证 + discovery + 三重防重放 |
| OAuth2 Scope Handler | ✅ 0.4.0 完成 | ScopeHandler trait + ScopeRegistry 注册表 |
| SSO Server 独立抽象 | ✅ 0.4.0 完成 | SsoServer trait + CenterIdConverter + SsoChannel |
| AloneCache 多实例隔离 | ✅ 0.4.0 完成 | AloneCache 装饰器 + AloneCacheManager |
| ParameterQuery 参数化查询 | ✅ 0.4.0 完成 | ParameterQuery trait + Builder + async check_permission/check_role |
| ❌ 0.5.2 删除 | LoginId enum(Numeric/String),公开 API 接受 impl Into<LoginId>String/&str |
|
| Repository 层 | ✅ 0.4.2 完成 | 9 个 Repository trait + SqliteRepository(tenant_id 隔离) |
| 密码哈希 | ✅ 0.4.2 完成 | PasswordHasher trait + Argon2/Bcrypt 实现 + 自动识别 |
| 密码登录 | ✅ 0.4.2 完成 | login_with_password 整合 Repository + PasswordHasher |
| 多账户 login_type | ✅ 0.4.2 完成 | get_permission_list_with_type / get_role_list_with_type |
| JWT 三模式 | ✅ 0.4.2 完成 | JwtMode Stateless/Mixin/Simple |
| API Key namespace | ✅ 0.4.2 完成 | garrison:apikey:<namespace>:<key> 多租户隔离 |
| SSO TOCTOU 修复 | ✅ 0.4.2 完成 | GarrisonDao::get_and_delete 原子消费 |
| kickout_by_device | ✅ 0.4.2 完成 | 按设备维度踢出会话 |
| ActixContext 适配器 | ✅ 0.4.2 完成 | actix-web 4 4 件套(ActixContext/Request/Response/Storage) |
| WarpContext 适配器 | ✅ 0.4.2 完成 | warp 0.4 4 件套(WarpContext/Request/Response/Storage) |
| Strategy Registry | ✅ 0.4.2 完成 | 6 个策略 trait + Strategy 注册表 + Manager 集成 |
| 过程宏注解 | ✅ 0.4.2 完成 | #[check_login]/#[check_permission]/#[check_role] 属性宏 |
| OAuth 2.1 PKCE | ✅ 0.4.2 完成 | RFC 7636 S256 方法,旧方法标记 deprecated |
| Token Introspection | ✅ 0.4.2 完成 | RFC 7662 远程 token 状态查询 |
| 多租户隔离 | ✅ 0.5.0 完成 | tenant_id 字段 + task_local! TenantContext + Repository 强制过滤 |
| 社交登录 | ✅ 0.5.0 完成 | 微信扫码 / 支付宝 Provider + SocialBinding 表 |
| 审计日志 | ✅ 0.5.0 完成 | audit_logs 表 + 14 个 listener 事件订阅 + 自动脱敏 |
| RefreshToken Rotation | ✅ 0.5.0 完成 | SHA-256 hash chain + parentTokenHash + 重用检测 |
| 安全防护套件 | ✅ 0.5.0 完成 | 5 个 FirewallStrategy + MaxMindDb 生产后端 |
| 角色层级 | ✅ 0.5.0 完成 | role_hierarchy 表 + TC 预计算 + 登录时缓存权限并集 |
| 决策溯源 | ✅ 0.5.0 完成 | Decision{allowed, reason, errors} + authorize() API |
| Keycloak OIDC RP | ✅ 0.5.0 完成 | KeycloakProvider discovery + JWKS 验签 |
| PostgreSQL 后端 | ✅ 0.5.0 完成 | db-postgres feature + backend-agnostic SQL |
| MySQL 后端 | ✅ 0.5.3 完成 | db-mysql feature + testcontainers 集成测试 |
| 账号安全引擎 | ✅ 0.6.0 完成 | account/ 模块 + Credential SPI + PasswordPolicyEngine + UserLockoutStrategy + AuthenticationFlow DSL |
| remember-me 扩展超时 | ✅ 0.6.1 完成 | remember_me_enabled / remember_me_timeout 配置 + login 参数 |
| Redis 部署模式 | ✅ 0.6.1 完成 | RedisDeploymentMode 枚举(Single/Sentinel/Cluster/MasterSlave) |
| 身份切换 switch_to | ✅ 0.6.1 完成 | switch_to(login_id) 会话身份切换 |
| Token 置换 renew_to_equivalent | ✅ 0.6.1 完成 | 等效 Token 置换(保留会话状态) |
| OAuth2 注解 | ✅ 0.6.1 完成 | Annotation::CheckAccessToken / CheckClientToken |
| 路由分组 group() | ✅ 0.6.1 完成 | GarrisonRouter::group(prefix, annotation, f) |
| 会话过期回调 | ✅ 0.6.1 完成 | SessionExpiryListener trait + add_expiry_listener |
| SAML 2.0 骨架 | ✅ 0.6.1 完成 | SamlProvider trait + DefaultSamlProvider(quick-xml 解析) |
| OIDC RP 骨架 | ✅ 0.6.1 完成 | OidcProvider trait + DefaultOidcProvider(discovery + token exchange) |
| Redis pub/sub SsoChannel | ✅ 0.6.1 完成 | RedisPubSubSsoChannel(PUBLISH/SUBSCRIBE 跨实例通信) |
🏗 架构
graph TD
User["业务代码"] --> Util["GarrisonUtil 静态 API"]
Util --> Manager["GarrisonManager 单例"]
Manager --> Logic["GarrisonLogicDefault"]
Logic --> Session["GarrisonSession"]
Logic --> Strategy["GarrisonPermissionStrategy"]
Session --> Dao["GarrisonDao trait"]
Strategy --> Interface["GarrisonInterface 业务回调"]
Dao --> Oxcache["oxcache (L1 内存 + L2 redis)"]
Dao --> Dbnexus["dbnexus (SQLite)"]
Logic --> Plugin["GarrisonPlugin (inventory)"]
Logic --> Listener["GarrisonListener (inventory)"]
Annotation["axum 注解<br/>CheckLogin / CheckRole / CheckPermission"] --> Logic
Router["GarrisonRouter"] --> Interceptor["GarrisonInterceptor"]
Interceptor --> Util
核心模块说明:
stp/:核心 API(6 个子 trait:GarrisonCore/SessionLogic/PermissionLogic/TokenLogic/MfaLogic/PasswordLogic+GarrisonUtil静态委托 + task_local 上下文)garrison-session:双模会话管理(Account-Session + Token-Session)garrison-strategy:权限校验策略(GarrisonPermissionStrategytrait)garrison-manager:全局单例 + inventory 工厂注册garrison-annotation:axum extractor 注解系统garrison-router:axum Router 包装 + middleware 拦截garrison-dao:GarrisonDaotrait + oxcache / dbnexus 实现
完整架构设计见 docs/ARCHITECTURE.md。
🚀 Quick Start
前置依赖
| 依赖 | 版本 | 说明 |
|---|---|---|
| Rust | >= 1.85 | 工具链(部分 deps 要求 edition2024) |
| cargo | 随 Rust 安装 | 包管理器 |
| libssl-dev | 系统包 | cargo tarpaulin 覆盖率工具需要 |
| pkg-config | 系统包 | cargo tarpaulin 覆盖率工具需要 |
注:运行时无需额外系统依赖,
oxcache与dbnexus均为纯 Rust 实现。
安装
在 Cargo.toml 中添加依赖:
[]
= { = "0.7", = ["web-axum"] }
= { = "1", = ["full"] }
如需启用全部协议层与安全模块:
[]
= { = "0.7", = ["full"] }
最小示例
完整业务场景:初始化管理器 → 执行登录 → 校验登录状态 → 登出。
use Arc;
use *;
use async_trait;
// 1. 业务方实现 GarrisonInterface(提供权限/角色数据)
;
async
预期输出:
登录成功,token = a1b2c3d4e5f6...
axum 集成示例
完整 Web 应用示例见 examples/src/bin/axum_integration.rs(253 行),包含:
GarrisonRouter包装 axum Router- 4 个
route_protected路由(带CheckLogin/CheckRole<AdminRole>/CheckPermission<ReadPerm>注解) - axum middleware 自动从 Authorization header 提取 token 并设置 task_local
examples 已重组为独立 workspace member(
garrison-examplescrate),运行方式:cargo run -p garrison-examples --bin <name> --features full。0.4.0 新增 5 个 example (oidc_handler/scope_handler/sso_server/alone_cache/parameter_query), 完整列表见 examples/README。
⚙️ 配置
GarrisonConfig 支持三级配置源(优先级从高到低):
- 环境变量:
GARRISON_TIMEOUT/GARRISON_ACTIVE_TIMEOUT/GARRISON_TOKEN_NAME等 - toml 配置文件:
garrison.toml(通过GarrisonConfig::load(Some(path))加载) - 代码默认值:
GarrisonConfig::default_config()
核心配置项:
| 字段 | 默认值 | 说明 |
|---|---|---|
timeout |
2592000(30 天) |
会话超时秒数 |
active_timeout |
-1(不启用) |
活跃超时秒数,-1 表示跟随 timeout |
is_share |
false |
同账号多端共享会话 |
is_concurrent |
true |
允许同账号并发登录 |
token_name |
garrison_token |
Cookie / Header 名 |
token_style |
random_64 |
Token 风格(uuid / random_64 / simple / jwt) |
throw_on_not_login |
true |
未登录时抛异常而非返回 false |
支持通过 tokio::sync::watch 实现配置热更新,详见 docs/CONFIGURATION.md。
🎛 特性门控
| 特性 | 默认 | 引入版本 | 说明 |
|---|---|---|---|
backend-embedded |
✅ | 0.7.0 | 内嵌后端模式(进程内认证,委托 GarrisonManager) |
backend-remote |
❌ | 0.7.0 | 远程后端适配器(通过 HTTP 调用远程 Auth Server) |
backend-kit |
❌ | 0.7.0 | trait-kit typestate DI 构建 |
auth-server |
❌ | 0.7.0 | 独立认证服务器(含 sdforge 声明式路由 + TLS) |
abac |
❌ | 0.7.0 | 基于 Cedar DSL 的属性访问控制引擎 |
oauth2-server |
❌ | 0.7.0 | 完整 OAuth2 Server 4 端点(authorize/token/revoke/introspect) |
cache-memory |
❌ | 0.1.0 | 内存缓存后端(oxcache 内存层) |
cache-redis |
❌ | 0.1.0 | Redis 缓存后端(oxcache L2) |
db-sqlite |
❌ | 0.1.0 | SQLite 数据库后端(dbnexus + auto-migrate) |
db-postgres |
❌ | 0.5.0 | PostgreSQL 后端 |
db-mysql |
❌ | 0.5.3 | MySQL 后端 |
web-axum |
❌ | 0.1.0 | axum Web 框架适配 |
web-actix |
❌ | 0.4.2 | actix-web Web 框架适配 |
web-warp |
❌ | 0.4.2 | warp Web 框架适配 |
web-waf |
❌ | 0.6.4 | WAF 级 Web 防火墙中间件 |
web-cors |
❌ | 0.6.4 | CORS 跨域中间件 |
web-csrf |
❌ | 0.6.4 | CSRF 防护中间件 |
protocol-jwt |
❌ | 0.2.0 | JWT 签发与验证(HS256/HS512 + refresh) |
protocol-oauth2 |
❌ | 0.2.0 | OAuth2 四种模式(含 RefreshToken) |
protocol-sso |
❌ | 0.2.0 | SSO 单点登录 ticket |
protocol-sign |
❌ | 0.2.0 | API 签名 + nonce 防重放 |
protocol-apikey |
❌ | 0.2.0 | API Key 认证 |
protocol-temp |
❌ | 0.2.0 | 临时凭证 |
protocol-oidc |
❌ | 0.4.0 | OIDC id_token 签发/验证 + discovery |
protocol-zeroize |
❌ | 0.4.2 | 协议层密钥零化(Drop 时清零 secret 字段) |
oauth2-scope-handler |
❌ | 0.4.0 | OAuth2 ScopeHandler 注册表 |
protocol-sso-server |
❌ | 0.4.0 | SSO Server 独立抽象 + CenterIdConverter |
secure-saml |
❌ | 0.5.0 | SAML 2.0 骨架(rsa 签名验证) |
alone-cache |
❌ | 0.4.0 | AloneCache 多 Redis 实例隔离装饰器 |
parameter-query |
❌ | 0.4.0 | ParameterQuery 参数化查询 + Builder |
secure-totp |
❌ | 0.2.0 | TOTP 动态验证码 (RFC 6238) |
secure-sign |
❌ | 0.2.0 | HMAC-SHA256/SHA512 工具 |
secure-httpbasic |
❌ | 0.2.0 | HTTP Basic 认证 (RFC 7617) |
secure-httpdigest |
❌ | 0.2.0 | HTTP Digest 认证 (RFC 7616) |
secure-confusable |
❌ | 0.5.1 | Unicode 同形异义字检测 |
secure-masking |
❌ | 0.6.2 | 敏感数据脱敏(regex 真实脱敏) |
secure-xss |
❌ | 0.6.2 | XSS 防护 |
secure-sanitize |
❌ | 0.6.2 | 通用输入消毒 |
secure-simple-token |
❌ | 0.7.1 | SimpleTokenStyle HMAC-SHA256 签名 |
sms-rate-limit |
❌ | 0.6.2 | SMS 验证码限速 |
account-credential |
❌ | 0.6.0 | 凭证模型 SPI(Argon2/Bcrypt) |
account-credential-zeroize |
❌ | 0.6.0 | 凭证模型 zeroize 扩展 |
account-policy |
❌ | 0.6.0 | 密码策略引擎 |
account-lockout |
❌ | 0.6.0 | 用户锁定策略 |
account-authflow |
❌ | 0.6.0 | AuthenticationFlow DSL |
listener |
❌ | 0.2.0 | 事件监听器(15 个事件变体,0.4.2 扩展) |
tracing-log |
❌ | 0.1.0 | tracing 日志桥接 |
metrics-prometheus |
❌ | 0.3.0 | Prometheus 指标 |
observability-otlp |
❌ | 0.3.0 | OpenTelemetry OTLP 分布式追踪 |
audit-inklog |
❌ | 0.7.0 | inklog 结构化审计日志 |
grpc |
❌ | 0.3.0 | gRPC 鉴权拦截器(tonic::Interceptor) |
annotation-macros |
❌ | 0.4.2 | #[check_login]/#[check_permission]/#[check_role] 过程宏 |
tenant-isolation |
❌ | 0.5.0 | 多租户逻辑隔离 |
social-wechat |
❌ | 0.5.0 | 微信扫码社交登录 |
social-alipay |
❌ | 0.5.0 | 支付宝授权社交登录 |
audit-log |
❌ | 0.5.0 | 审计日志持久化 |
firewall |
❌ | 0.5.0 | 安全防护基础 trait |
firewall-bruteforce |
❌ | 0.5.0 | 暴力破解防护策略 |
firewall-ratelimit |
❌ | 0.5.0 | 限流策略 |
rate-limit-redis |
❌ | 0.6.4 | Redis 限流后端 |
firewall-anomalous |
❌ | 0.5.0 | 异常登录检测 |
firewall-geoip |
❌ | 0.5.0 | GeoIP 策略 |
firewall-ddos |
❌ | 0.5.0 | DDoS 防护策略 |
firewall-waf |
❌ | 0.6.4 | WAF 级防火墙 |
firewall-maxminddb |
❌ | 0.5.3 | MaxMindDb 生产后端 |
anomalous-detector-dual |
❌ | 0.6.2 | 异常登录双引擎检测 |
keycloak-oidc |
❌ | 0.5.0 | Keycloak OIDC RP 集成 |
decision-trace |
❌ | 0.4.2 | 决策溯源 |
authorize-api |
❌ | 0.5.1 | 请求对象式授权 API |
manager-explicit |
❌ | 0.5.1 | 显式 Manager API |
permission-registry |
❌ | 0.5.1 | 权限注册表 |
safe-defaults |
❌ | 0.6.7 | forbid 优先语义(safe-defaults) |
security-alert |
❌ | 0.6.5 | 安全告警系统 |
device-binding |
❌ | 0.6.5 | 设备绑定 |
safe-auth |
❌ | 0.6.5 | 二级认证瞬态标记 |
dynamic-active-timeout |
❌ | 0.6.2 | 动态活跃超时 |
three-tier-cache |
❌ | 0.6.7 | 三层缓存架构 |
login-token-map-persistence |
❌ | 0.6.6 | login_token_map 持久化 |
anonymous-session |
❌ | 0.6.6 | 匿名 Session |
session-search |
❌ | 0.6.6 | 会话搜索 |
tls |
❌ | 0.7.0 | HTTPS/TLS 终止(axum-server rustls) |
miette |
❌ | 0.5.1 | miette 富错误 |
i18n |
❌ | 0.3.0 | 国际化基础层(fluent-rs) |
i18n-icu |
❌ | 0.3.0 | ICU4X 增强层(复数 + 日期 + 数字本地化) |
full |
❌ | — | 聚合所有特性 |
production |
❌ | — | 生产环境推荐组合 |
development |
❌ | — | 开发环境组合 |
📚 API 文档
- 在线文档:https://docs.rs/garrison
- 本地生成:
cargo doc --no-deps --features full --open - 示例代码(独立 workspace member,
cargo run -p garrison-examples --bin <name> --features full):- examples/src/bin/basic_login.rs:完整业务场景(167 行)
- examples/src/bin/axum_integration.rs:完整 Web 应用(253 行)
- examples/src/bin/oidc_handler.rs:OIDC id_token 签发/验证(0.4.0 新增)
- examples/src/bin/scope_handler.rs:ScopeHandler 注册表(0.4.0 新增)
- examples/src/bin/sso_server.rs:SSO Server 独立抽象(0.4.0 新增)
- examples/src/bin/alone_cache.rs:AloneCache 多实例隔离(0.4.0 新增)
- examples/src/bin/parameter_query.rs:ParameterQuery 参数化查询(0.4.0 新增)
- 完整列表见 examples/src/lib.rs 模块声明
🤝 贡献
欢迎所有形式的贡献!请先阅读 贡献指南。
提交 Issue
- 使用 Issue 模板(Bug Report / Feature Request)
- 描述问题时请提供复现步骤与 Rust 版本
提交 PR
- Fork 本仓库
- 创建特性分支:
git checkout -b feat/your-feature - 遵循 Conventional Commits 规范提交
- 确保
cargo test --features full+cargo clippy -- -D warnings通过 - 创建 Pull Request
开发规范
- TDD 工作流:先写接口 → 写测试 → 实现 → 测试通过 → commit
- clippy:零警告(
-D warnings) - 文档:所有 public API 必须有
///文档注释 - 测试串行化:修改全局
GarrisonManager单例的测试需标注#[serial_test::serial]
测试
Garrison 提供三层测试体系:单元测试(3787+ 个 lib)+ E2E 测试(65+ 个,含 API 矩阵 / 性能基线 / 渗透测试)+ doc-tests。
# 单元测试 + 集成测试
# E2E 测试(含 API 矩阵 + 渗透测试,不含 #[ignore] 性能测试)
# 性能基线测试(#[ignore] 默认不跑,需显式触发)
# 一键执行 E2E + 性能 + 渗透 + 生成综合报告
E2E 测试覆盖 API 接口矩阵(happy/errors/boundary/authz_boundary)、性能基线(P99<200ms/1000RPS)、渗透测试(7 类攻击 × N payload),所有 HTTP 交互通过 RecordingClient 抓包到 logs/e2e_http.jsonl,最终由 scripts/e2e_analyze.py 聚合生成 logs/e2e_final_report.md。详细说明详见 E2E / 性能 / 渗透测试。
🗺 路线图
- v0.1.0(2026-06-30)核心基础设施:登录认证 + 权限校验 + 双模会话 + axum 集成
- v0.2.0(2026-07-01)协议与安全层:JWT / OAuth2 / SSO / Sign / API Key / TOTP / Basic / Digest + 插件系统 + 事件监听器
- v0.2.1(2026-07-01)auto-wire 修复 + 协议层边界测试 + examples 工程化重组
- v0.3.0 生态完善与可观测:OpenTelemetry OTLP + gRPC 拦截器 + i18n + metrics-prometheus
- v0.4.0(2026-07-02)0.2.0 协议层遗留 gap 补齐:OIDC / ScopeHandler / SsoServer / AloneCache / ParameterQuery(gap #4 注解系统延后至 0.5.0+)
- v0.4.2(2026-07-05)gap closure:dao 扩展 / strategy-registry / jwt-modes / oauth-2-1 / token-introspection / apikey-namespace / sso-toctou / password-login / 注解宏
- v0.5.0(2026-07-06)生产刚需版:多租户 / 社交登录 / 审计日志 / Token Rotation / 安全防护 / 角色层级 / 决策溯源 / Keycloak OIDC RP / PostgreSQL
- v0.5.2(2026-07-08)架构重构:GarrisonLogic trait 拆分为 6 个子 trait + LoginId 迁移到 String
- v0.5.3(2026-07-09)功能补全:oxcache 升级 / stp 完整拆分 / MySQL 后端 / Firewall MaxMindDb
- v0.6.0(2026-07-09)账号安全引擎:account/ 模块 + Credential SPI + PasswordPolicyEngine + AuthenticationFlow DSL + remember-me / Redis 部署模式 / switch_to / SAML 2.0 / OIDC RP / Redis pub/sub SsoChannel
- v0.7.0(2026-07-17)微服务架构 + ABAC/Cedar + OAuth2 Server:backend-remote / Auth Server / ABAC 引擎 / OAuth2 Server 4 端点 + 架构加固 + 依赖优化
- v0.7.1(2026-07-21)安全修复 + 架构加固:21 项安全修复(secure-simple-token、SimpleTokenStyle 防伪造、OIDC aud 数组兼容、switch_to 账户会话清理、session corrupt-json 健壮性等)
- v1.0.0 稳定版:API 冻结 + 性能基准 + 生产案例
完整规划见 docs/ROADMAP.md。
📄 许可证
本项目基于 Apache-2.0 许可证开源。
为何选择 Apache-2.0 而非 MIT:Apache-2.0 包含专利授权条款,更适合企业级框架使用。
🙏 致谢
- Sa-Token:Java 生态的认证鉴权框架,为本项目早期领域建模提供参考
- axum:tokio 团队出品的 Rust Web 框架
- oxcache:Rust 多级缓存库(L1 内存 + L2 redis)
- dbnexus:Rust 数据库抽象层(SQLite / PostgreSQL / MySQL)
- inventory:David Tolnay 的编译期插件注册库