跳转至

能力地图

已实现能力

能力 状态 边界
包内演示站 已实现(demo extra) chatlogin serve、四类真实后端体验、模板游乐场与可复制接入示例;不连接生产数据
托管用户预设 0.2.0 ManagedUsers、每实例 owner/admin/user、默认登录/管理/本人资料 UI/API;需显式采用,不迁移旧账户库
新服务发现与导航 0.2.1 GET {prefix}/api 列出真实操作与能力;AccountMenuUI 复用角色入口,headless 不虚报页面;见新服务接入
npm 前端复用 源码包 @chatarch/chatlogin 0.1.0 无框架 TypeScript 客户端、可选 React 登录/账号菜单;共用默认页协议和 CSS,Python 仍负责认证;见前端接入,registry 发布独立执行
ChatVoice legacy 托管 facade 0.2.0 保留原 accounts / auth_sessions 的 additive 初始化、一次性 owner 采用、metadata-aware 账号匹配和 managed users CRUD;需消费方显式采用
身份与授权 已实现 Principal、Role、401/403、require_role、require_owner;admin 不自动绕过 owner
认证后端 已实现 PasswordBackend 支持一个或多个显式账号;CallbackBackend 接入宿主用户库;AsyncCallbackBackend await 异步上游校验
ChatVoice 兼容后端 已实现(核心包,按需导入) ChatVoiceAuth / ChatVoiceSessionStore;仅现有 ChatVoice schema、固定命名空间与 USER,不建表/迁移,无 ChatVoice/web 依赖
旧密码材料校验 已实现 verify_pbkdf2 可验证宿主已有的 PBKDF2-HMAC-SHA256 salt/digest,不强制改密码
会话 已实现 opaque token、仅存 SHA-256、TTL、轮换、撤销、CSRF secret、公开 purge_expired();内存 store 仅用于测试/演示
SQLite store 已实现 公共 PrivateSQLite + 按实例命名空间的 session store;POSIX 使用可信 0700 目录与真实路径 mode=rw,拒绝不安全的已有数据库/sidecar,不把 fd alias 当作 sidecar 保护
FastAPI adapter 已实现(web extra) 可配置前缀、cookie、Origin/Host、请求体限制、限流、JSON/headless 路由和依赖
默认登录 UI 已实现(ui 或 web extra) ui 仅安装 Jinja2;web 额外安装 FastAPI/Starlette,包内模板/CSS/JS 可从 wheel 读取
Web 依赖兼容门禁 已实现 web/dev 声明 starlette>=0.40,<2.0;兼容性测试覆盖 Starlette 0.x、1.3.1、1.6.0,CI 固定 0.x 与 1.3.x 线路
宿主模板覆盖 已实现 模板目录优先、区块继承、整页 renderer、本地自定义 stylesheet
ChatEnv 命名空间 已实现 保留 ChatLogin typed profile;本版本不新增 API key 字段

接入选择

  1. 新网站且需要应用自管账户:显式采用 ManagedUsers + create_managed_auth,先由操作员 bootstrap 首个 owner。
  2. 新网站且账户仍归宿主:默认 UI + PasswordBackend 或宿主回调即可起步。
  3. 需要自有视觉:保留 FastAPI adapter,替换 LoginUI 的模板目录、模板名或 renderer。
  4. 已有 ChatVoice schema:直接选用 ChatVoiceAuth;如要在同一 legacy schema 上接入用户管理,显式初始化 ChatVoiceManagedStore 并采用一个既有 owner。默认 UI、宿主覆盖和 headless 均可使用。

后端选择:固定/多账号 PasswordBackend;同步宿主库 CallbackBackend;异步宿主库 AsyncCallbackBackend;ChatVoice schema 用现成 ChatVoiceAuth。详见 选择矩阵。

不在当前范围

  • 不提供独立生产登录微服务、SSO、OAuth/邮箱登录或 MFA。托管用户提供实例内账户管理;固定、回调和 ChatVoice adapter 的账户管理仍归宿主。
  • 不接管会议、文件、卡片等业务数据;每个宿主继续定义资源 owner 和 policy。
  • 不把 guest 当成数据库账户;访客体验由宿主显式声明。
  • 不提供万能 ORM 或后端注册中心;ChatVoice 兼容后端来自自有桥接实现,并以旧 schema 合成测试验证。
  • 不把 secret、cookie、CSRF token、Authorization header 或生产凭据写入日志或页面。CSRF 仅通过同源 session/login JSON 交给浏览器,用于受保护写操作。

多用户边界

多账号认证已由账号映射、回调、ChatVoice兼容后端和托管用户预设提供。require_owner只是宿主可复用的归属校验,不是自动数据库行级权限;托管 owner 也不绕过它。不同账号必须返回不同的稳定user_id。见托管用户与A/B实验及责任划分。