演示站与快速开始¶
在线体验:ChatLogin 演示站 · 模板游乐场。这是公开合成账号环境,不连接真实业务数据。
chatlogin serve 从已安装的 ChatLogin wheel 读取并运行产品演示,不依赖源码相对路径。它用于选择认证后端、前端接入方式和 LoginUI 配置,不是共享生产身份服务。
安装与启动¶
默认地址为 http://127.0.0.1:8765/。demo extra 自包含 FastAPI、Starlette、Jinja2 与 Uvicorn;核心包仍不强制安装这些 Web 依赖。
Usage: chatlogin serve [OPTIONS]
Options:
--host TEXT Bind address; loopback by default. [default: 127.0.0.1]
--port INTEGER RANGE TCP port. [default: 8765; 1<=x<=65535]
--origin TEXT Fixed trusted public origin for browser Host/Origin checks.
--managed-demo 运行一次性托管用户演示。
--help Show this message and exit.
如果由反向代理提供 TLS,仍把进程绑定到 loopback,并显式传入浏览器实际访问的可信 origin:
--origin 是固定安全配置,不从 Host、X-Forwarded-Host 或 X-Forwarded-Proto 自动推导。代理、TLS、进程监督和公网限流仍由部署方负责。
托管用户演示¶
默认 chatlogin serve 保持本页所述的四种旧后端演示。要体验新的实例内 owner/admin/user 预设,显式选择:
它创建仅驻留当前进程、须在 shutdown 关闭的 ManagedUsers.in_memory(...),并用真实 bootstrap_owner、authenticate 与 create_user 创建三组公开合成 owner、admin 与 user 账号。首页列出这些刻意公开的凭据、角色边界,以及登录、管理用户、本人资料入口;管理与资料页面仍使用默认 UserAdminUI / UserProfileUI 和受保护 API。它不读取 ChatEnv home/profile、生产账户库或生产会话。GET /health 只含安装版本、mode: "managed-demo" 与 synthetic: true;GET /api/managed-demo/accounts 只含刻意公开的合成值。详见托管用户。
可以实际体验什么¶
开发预览提供公开合成A/B账号,登录页可选择并填入。它们不对应真实账户或客户数据,详见多账号与数据隔离。
| 后端 | 前端 | 入口 | 数据来源 |
|---|---|---|---|
PasswordBackend |
默认 LoginUI |
/demo/password/ |
显式构造的两个独立账号与密码hash |
CallbackBackend |
宿主 renderer 覆盖 |
/demo/callback/ |
本地同步合成回调 |
AsyncCallbackBackend |
ui=None + 自有 HTML/JS |
/experience/async |
本地异步合成回调 |
ChatVoiceAuth |
LoginUI split/dark |
/demo/chatvoice/ |
一次性共享内存 SQLite 旧 schema fixture |
四种模式各自使用 cookie 名与 session namespace。登录成功后的工作区显示安全身份、宿主拥有的合成记录、真实数据归属校验,以及受保护读取、CSRF检查与退出操作。页面与日志不展示 session token、cookie、密码 hash 或 CSRF 值。CSRF 只在同源 session/login JSON 中返回给浏览器以执行安全写操作;会话 token 只通过 HttpOnly Cookie 交付。
模板游乐场在 /templates,预览由实际 LoginUI.render() 生成。它只接受三个色板、两个布局、light/dark/system 与 guest 开关,并生成可复制的精确 Python 配置;不接受任意 HTML 或文件路径。
健康与版本读回:
GET /health -> {"status":"ok","version":"<installed-version>"}
GET /version -> {"version":"<installed-version>"}
多账号与数据隔离¶
A/B隔离实验从 0.1.6 起提供;0.1.5 的认证核心已经支持多账号,但它的演示只公示一个账号。以站点页眉或 chatlogin --version 为准。
| 层次 | 负责方 | 验证方式 |
|---|---|---|
| 多账号认证 | PasswordBackend 映射、同步/异步回调、ChatVoiceAuth 账户库 |
A/B返回不同且稳定的 user_id |
| 用户会话 | ChatLogin会话存储与HttpOnly Cookie | 两个独立浏览器会话互不串号;退出A不影响B |
| 业务数据 | 宿主按可信身份过滤、调用 require_owner |
本人列表/详情/写入成功;持A会话读写B样例返回403,反向相同 |
每个后端演示都有两组公开合成凭据:A为 demo / chatlogin-demo,B为 demo-b / chatlogin-demo-b。登录页选择账号并填入,再点击登录。不要用两个普通标签假装独立用户:它们共享Cookie;并行验证使用普通与无痕窗口,或两个浏览器。
登录后的“用户数据隔离”提供本人读取、本人修改、读取对方、修改对方四个真实API操作。修订号由服务端修改;数据未预先全部下发再由前端隐藏。归属来自服务端 Principal.user_id,不接受客户端指定 owner_id。公开的对方资源ID仅用于合成越权测试,不应成为真实产品的目录枚举接口。
这是应用层逻辑隔离,不是每人独立数据库。ChatVoice宿主也可按 (owner_id, record_id) 查询并对不存在于当前用户空间的详情返回404。登录库不自动隔离会议、文件、下载、后台任务或其他业务表:宿主必须在每个入口执行自己的授权规则。每个真实用户必须拥有稳定且不同的 user_id,不能让多个账号都返回同一Principal。
样例业务记录仅驻留当前演示进程,重启清空;它们没有任何真实业务权限。演示账号公开,所以任何访问者都可主动登录A或B;隔离结论是持A会话不能越权访问B资源,不是对知道B凭据的访问者保密。
演示安全边界¶
- 每个后端最多 16 个有效 session,TTL 为 5 分钟;满载时返回可重试的 HTTP 503,不驱逐其他有效 session。
- Memory 模式仅存在于当前进程;ChatVoice fixture 只存在于当前共享内存 SQLite 生命周期,不写用户 home。
- 认证与私有响应使用
no-store,cookie 为HttpOnly、固定 path、SameSite=Strict,HTTPS origin 时启用Secure。 - 所有浏览器 POST 使用固定同源检查;已有 cookie 的重复登录先读取 session,并携带当前 CSRF 后再轮换。
- 静态资源经
importlib.resources从包内 allowlist 读取,带正确 content type;页面 CSP 不依赖外部 CDN。 - 演示不读取 ChatEnv profile、生产 provider、真实账号数据库或任意 forwarded header。
用于真实项目¶
生产项目应安装 ChatLogin[web],选择自己的 CredentialBackend、SessionStore、固定 origin 和业务授权策略。默认 UI、宿主模板覆盖与 headless 是彼此独立的前端选择,不是 OAuth/短信等认证协议。
- 接入与安全:完整 FastAPI、覆盖模板、headless sequence、回调、ChatVoice schema 与 store 选择。
- 能力地图:当前实现与明确排除项。
- Python 接口树:实际构造签名与 HTTP 路由。
ChatLogin 不提供默认生产密码、OAuth、SSO、MFA、邮件/短信验证码、扫码登录或跨业务身份中心。托管用户只提供实例内账户管理;固定账号、回调和 ChatVoice adapter 仍不提供账号后台。