Skip to content

RBAC:登录缓存、会话与权限边界 ​

RBAC 当前实现集中在独立项目 UI/ColorVision.Rbac/,并由 ColorVision/BuiltInModules.cs 注册到主程序。账户、角色、权限、会话和审计使用本地 SQLite;用户中心的流程统计另读配置的业务数据库。它不是 Engine 层统一安全内核,也不是远程身份平台。

当前缓存恢复和失败处理存在未修复的授权限制:缓存字段完整不等于会话有效,无缓存时的初始化权限仍为 Administrator。本页如实记录这些限制,不将其包装为安全默认值或新增授权入口的设计建议;全局粗粒度权限与细粒度 RBAC 的关系见安全边界。

先查什么 ​

现象第一检查点
登录后权限不对当前全局权限来自初始化缓存、密码登录还是自动登录;缓存字段是否完整不代表会话仍有效
管理窗口打不开窗口按 Authorization.Instance.PermissionMode > PermissionMode.Administrator 拒绝;数值较小代表较高权限,不是登录校验
细权限判断异常PermissionChecker 缓存、用户角色、角色权限关联
Session 登录失败RbacManagerConfig.SessionToken、AuthService.LoginBySessionTokenAsync、会话过期/撤销和用户启停状态
新权限保存后不生效PermissionManagerWindow 是否调用 InvalidateAllCache()
用户看不到角色UserRoleEntity、RoleEntity、软删除/启用状态
审计缺记录AuditLogService 调用点;当前不是覆盖全业务的统一审计总线

初始化链路 ​

  1. RbacManager 构造创建默认 %AppData%/ColorVision/Config/;DirectoryPath 和 SqliteDbPath 均为可设置属性,不能把默认路径当作不可覆盖的部署约束。
  2. 打开或创建本地 SQLite 数据库,默认是该目录的 Rbac.db。
  3. 通过 SqlSugar CodeFirst 初始化 RBAC 实体表。
  4. 初始化 AuthService、UserService、RoleService、PermissionService、AuditLogService、SessionService 和 PermissionChecker。
  5. 缺少内置管理员角色或用户时创建它们,并维护角色关联;这不是只在整个应用首次启动时运行一次的空库检查。
  6. 写入预置权限,并把全部权限分配给 admin 角色。
  7. 根据缓存 DTO 的结构检查同步全局权限;没有通过结构检查的缓存时设为 Administrator,不执行会话认证。

构造还创建 SessionCleanupService,5 分钟后首次调用清理,然后每小时运行;当前清理是将过期会话标记为撤销,不是删除账户,也不会同步清空 RbacManagerConfig.LoginResult。后台清理异常被捕获。取得单例、打开登录或管理窗口都不能当成无文件/数据库副作用的检查方法。

结构有效的缓存恢复、密码登录成功和 Session 恢复成功时,同时把用户 ID 的 invariant 字符串同步到 Authorization.SubjectId;无有效初始化缓存时清空该标识。它只为共享策略提供当前主体上下文,不写入 Authorization 配置,也不改变上述缓存/会话验证规则。缓存恢复本身也会写入这个 ID,因此标识非空不能作为会话已经验证的证据。

服务职责与注册 ​

入口当前责任
AuthService / IAuthServiceLoginAndGetDetailAsync 校验密码并构造登录结果;LoginBySessionTokenAsync 校验会话再重新读取用户。没有注册或创建会话接口
RegisterWindow.BtnRegister_Click调用 UserService.CreateUserAsync;实现位于 Services/IUserService.cs,不是 Services/UserService.cs
LoginWindow.CompleteLogin调用 SessionService.CreateSessionAsync,再保存缓存并更新全局权限
SessionService创建、校验、撤销会话与标记过期会话;这些调用可能读写本地数据库
PermissionChecker按用户角色与权限码查询并缓存结果,不验证当前 SessionToken
RbacManager / 管理窗口组合服务、同步缓存权限并在部分入口做粗粒度检查,不代表每个公开服务方法都经过统一授权拦截

普通用户创建及登录时补建详情显式使用 PermissionMode.User;UserDetailEntity 默认也是 User,UserDetailDto 默认是 Guest。内置管理员引导显式写入 SuperAdministrator,不能据此推断普通 DTO 或导入用户应默认高权限。新增注册、导入或提权路径仍须核对受控授权入口,不能把当前缓存检查当作授权证明。

当前实体 ​

实体表说明
UserEntitysys_user用户名、密码哈希、启用状态、软删除状态
UserDetailEntitysys_user_detailPermissionMode、联系方式、组织信息、头像、备注
RoleEntitysys_role角色基本信息
PermissionEntitysys_permission权限码,如 user.create、role.assign_permissions、audit.view
RolePermissionEntitysys_role_permission角色到权限码的关联
SessionEntitysys_sessionSessionToken、设备、IP、创建/过期/活跃/撤销状态
AuditLogEntitysys_audit_log用户、动作、明细、时间、IP

登录链路 ​

RbacManager.IsUserLoggedIn() 仅调用 IsValidLoginResult:用户 ID 大于 0、用户名非空、详情的 UserId 与用户 ID 相同。它不检查 SessionToken、到期/撤销、数据库中的用户启用/删除状态,甚至不使用 RememberMe。初始化从这种缓存恢复权限也不等于认证成功;不能新增“该方法返回 true 就已安全登录”的假设。

密码登录走 AuthService.LoginAndGetDetailAsync:查询启用且未软删除的用户,调用 PasswordHasher 校验,必要时升级旧密码格式,再构造用户详情与角色。LoginWindow 对用户名与密码相同的输入会要求先修改密码;该窗口规则不能扩写为所有服务调用者都会强制执行。

CompleteLogin 无论是否勾选“记住我”都会创建会话,并写入 LoginResult、SessionToken 和全局 PermissionMode,随后调用配置保存。RememberMe=false 只关闭下次登录窗口的自动登录选择并清空 SavedUsername,不等于没有创建或保存会话。会话默认有效期为 24 小时;显式调用者可以传入其他期限。

自动登录的三个结果 ​

只有登录窗口初始化发现 RememberMe=true 且 token 非空,才调用 TryAutoLogin;RbacManager 构造本身不会走这条认证路径。

分支代码实际行为
LoginBySessionTokenAsync 成功检查会话存在、未撤销、未过期及用户启用/未删除;更新 LastActivityAt,重新加载详情和角色。窗口更新 LoginResult、SavedUsername、全局权限并请求配置保存;不轮换 token,也不延长 ExpiresAt
返回 null窗口只清空 SessionToken、关闭 RememberMe 并请求保存;没有清空 LoginResult、当前 SubjectId 或重置全局权限,旧缓存身份和权限可能继续存在
抛异常TryAutoLogin 的 catch 只让输入框获得焦点,继续手动登录;不保证凭据、缓存或权限已清理

这两种失败分支是当前未修复限制,不是“失败自动降权”的实现。SessionService.ValidateSessionAsync 也是另一接口:它检查会话并可能标记过期会话为撤销、更新活动时间,但不重新查询用户启停状态;不能把它与 AuthService.LoginBySessionTokenAsync 的完整行为混同。

登出与保存不是一项事务 ​

RbacManagerWindow.BtnLogout_Click 经确认后先尝试撤销当前 token,再尝试写审计;两处异常都被吞掉。随后清空 LoginResult、SessionToken、SavedUsername 和当前 Authorization.SubjectId,关闭 RememberMe,把当前全局权限设为 Guest,调用配置保存并重新显示登录窗口。重新登录可再次改变权限;本地状态清空不能证明数据库会话已成功撤销。

登出当下的 Guest 与下次无结构有效缓存时初始化的 Administrator 是两条不同分支,不能承诺登出后重启仍保持 Guest。配置保存调用也不能替代对落盘结果的验证,保存层边界见配置、恢复与保存。

权限检查 ​

层级当前入口说明
粗粒度Authorization.Instance.PermissionMode、AccessControl.Evaluate/Demand/Check(...)Common 动作策略默认兼容角色层级;RBAC 管理窗口仍有自身的角色检查,这些判断本身没有验证登录或会话
细粒度PermissionChecker查询用户角色和角色权限,带过期时间和 LRU 缓存

当前系统是粗细两层并存。IAccessPolicy 提供宿主可替换的动作/资源决策点,默认仍读取全局角色;PermissionChecker 的数据库权限码结果不会自动接入该策略。需要受管身份时应由宿主明确桥接会话和权限来源,不能仅凭 SubjectId 或缓存 DTO 字段齐全认定已认证。不要把 PermissionMode 写成已经被 RBAC 完全替换,也不要把权限码写成已覆盖全产品所有入口。

PermissionChecker 的缓存期限为 5 分钟,最多缓存约 1000 个用户并按访问时间淘汰。当前数据库查询从 UserRole/RolePermission 连接 Permission,过滤权限自身的启用/删除状态,但不在该查询中核验用户或角色的启停/删除状态。权限管理窗口保存后调用 InvalidateAllCache();其他修改路径不能仅因数据库已更新就假定所有缓存已失效。

可见窗口 ​

窗口用途
LoginWindow登录和 Session 恢复
RegisterWindow注册用户
ChangePasswordWindow修改密码
UserManagerWindow用户列表、角色查看、启停、删除、重置密码
PermissionManagerWindow按角色分配权限,保存后清权限缓存
RbacManagerWindowRBAC 总入口和当前登录状态

用户窗口外观 ​

UserManagerWindow 使用角色管理与用户列表两个分区,保留角色创建、权限管理、用户搜索及行内账户操作。RbacManagerWindow 使用原生标题栏,按账户资料、运行指标、流程活动和详情组织内容,窗口可调整大小。两个窗口共享 Themes 的更新窗口资源,背景、表格和统计文字随深浅主题变化;外观与布局不改变以下统计范围或账户权限边界。

主窗口右侧 MenuRbacManager 账户入口通过 ColorVision.Solution.Properties.Resources.UserCenter 提供本地化名称,供按钮提示、辅助功能名称及紧凑标题栏“更多”菜单使用;入口命名不改变权限、会话或统计行为。

用户中心统计:本机使用与业务库计数 ​

用户中心允许未登录时打开,账户操作仍走原有登录及权限边界;“云盘”入口不要求账号,打开后关闭模态用户中心并显示独立非模态窗口,便于后台上传时继续使用主程序。云盘复用远程匿名文件中转,与本地 RBAC 身份分离,上传、续传、二维码和过期规则见文件中转。

“激活”入口独立于 RBAC 登录与权限,只在激活窗口内申请许可证、查看设备占用和释放本机。设备绑定和到期规则见许可证激活与设备名额。

这部分不是身份认证审计,也不是当前用户的个人执行历史。UserCenterStatisticsService.QueryAsync 没有用户 ID 筛选,查询当前配置业务数据库的 t_scgd_measure_batch;不要根据“用户中心”标题把结果归属到登录用户。

  • ApplicationUsageTracker.StartSession 在主程序通过单实例处理后记录一次启动并请求保存配置;正常退出的 StopSession 将本次时长累计到 RbacManagerConfig。崩溃、强制结束或保存失败不保证时长落盘。“本次运行”优先取当前进程时长,失败时回退到追踪器起点;总时长为已累计值加当前运行时长。
  • 一条批次记录按一次流程执行尝试计数,result_code = 6 按已完成计数,不等于检测 OK/合格率。该常量对应持久化的 Completed 值,避免 UI 为统计反向依赖 Engine。
  • 累计次数查询全表;活动图查询包含今天在内的最近 364 天(52 周)。Presenter 的“最近”次数与完成率使用其中最近 7 天,平均时长按期间执行次数加权,不是所有窗口都使用同一分母。
  • UserCenterStatisticsPresenter 补齐缺失日期、合并重复日期、约束异常计数并计算完成率与加权平均;页面代码负责绑定展示。数据库未连接或查询失败时返回 IsAvailable=false,本机使用数据和用户资料仍可展示,流程区域标记不可用;失败的空/零结果不能解释为真实零次执行,也不使用模拟记录填充。
  • 页面文案使用 ColorVision.Solution 资源及 UserCenterText 包装;新增资源键应在简体中文、繁体中文和英语资源中保持一致。

打开/刷新用户中心会尝试查询业务库,账户修改、会话撤销与统计查询不是同一种操作。只读代码核验无需启动窗口、连接业务库或访问真实用户数据。

边界 ​

  • 账户认证依赖本地 SQLite 和本地窗口,不依赖外部认证服务器;用户中心流程统计另依赖业务数据库。
  • PermissionMode 仍是很多关键入口的第一道判断。
  • 细粒度权限主要集中在 RBAC 自己的管理窗口和服务层。
  • MFA、证书、IP 白名单、全业务审计总线等能力当前没有落地,不要写进现有能力。

关键文件 ​

任务先看
初始化RbacManager.cs
实体Entity/
登录Services/Auth/AuthService.cs、Loginwindow.xaml.cs
注册与用户服务RegisterWindow.xaml.cs、Services/IUserService.cs
会话Services/SessionService.cs、Services/SessionCleanupService.cs
权限缓存Services/PermissionChecker.cs
用户管理UserManagerWindow.xaml.cs
权限管理PermissionManagerWindow.xaml.cs
本机使用与流程统计ApplicationUsageTracker.cs、Services/UserCenterStatisticsService.cs、RbacManagerWindow.xaml.cs

验证范围与缺口 ​

登录、会话、权限缓存和用户中心数据库需在隔离环境单独验证。

修改相关代码时,应在隔离配置和合成数据库中覆盖:无缓存与结构完整但过期/撤销的缓存、普通用户创建、记住我开关、自动登录成功/null/异常、撤销失败后本地登出、重启后的默认权限,以及统计全表/日期窗口/不可用结果。需要窗口交互或真实数据库时另行取得运行和数据访问授权,不能用生产账号或业务库验证文档。

目标框架、包依赖和版本以 UI/ColorVision.Rbac/ColorVision.Rbac.csproj 为准。README 被打包为 NuGet 包说明;本页与仓库源码不保证随包交付,包使用者须核对对应源码版本。

基于 MIT License 发布。