ChatLogin 0.2.0__tar.gz → 0.2.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {chatlogin-0.2.0 → chatlogin-0.2.1}/CHANGELOG.md +6 -0
- {chatlogin-0.2.0/src/ChatLogin.egg-info → chatlogin-0.2.1}/PKG-INFO +4 -2
- {chatlogin-0.2.0 → chatlogin-0.2.1}/README.en.md +3 -1
- {chatlogin-0.2.0 → chatlogin-0.2.1}/README.md +3 -1
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/capability-map.en.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/capability-map.md +1 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/index.en.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/index.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/integration.en.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/integration.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/interface-tree.en.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/interface-tree.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/managed-users.en.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/managed-users.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/quickstart.en.md +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/quickstart.md +2 -0
- chatlogin-0.2.1/docs/service-onboarding.en.md +84 -0
- chatlogin-0.2.1/docs/service-onboarding.md +99 -0
- chatlogin-0.2.1/examples/managed_service.py +59 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/mkdocs.yml +2 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1/src/ChatLogin.egg-info}/PKG-INFO +4 -2
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/SOURCES.txt +8 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/__init__.py +1 -1
- chatlogin-0.2.1/src/chatlogin/account_ui.py +59 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/managed.html +1 -5
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/fastapi.py +39 -1
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/managed_demo.py +7 -10
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/managed_web.py +32 -2
- chatlogin-0.2.1/src/chatlogin/web/assets/account-menu.css +16 -0
- chatlogin-0.2.1/src/chatlogin/web/templates/chatlogin/account-menu.html +10 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/templates/chatlogin/profile.html +2 -1
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/templates/chatlogin/users.html +2 -1
- chatlogin-0.2.1/tests/code-tests/test_onboarding_acceptance.py +67 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_packaging_imports.py +2 -2
- chatlogin-0.2.1/tests/code-tests/test_service_onboarding.py +149 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_version.py +1 -1
- {chatlogin-0.2.0 → chatlogin-0.2.1}/DEVELOP.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/LICENSE +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/MANIFEST.in +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/chatvoice-managed.en.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/chatvoice-managed.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/cli-tree.en.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/cli-tree.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/demo.en.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/docs/demo.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/examples/demo_fastapi.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/examples/quickstart_fastapi.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/pyproject.toml +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/setup.cfg +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/dependency_links.txt +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/entry_points.txt +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/requires.txt +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/ChatLogin.egg-info/top_level.txt +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/backends/__init__.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/backends/chatvoice.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/backends/chatvoice_managed.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/cli.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/config.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/credentials.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/__init__.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo-login.css +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo-login.js +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo.css +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/assets/demo.js +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/headless.html +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/home.html +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/templates.html +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/demo_site/templates/workspace.html +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/identity.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/managed.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/paths.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/private_sqlite.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/security.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/sessions.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/sqlite.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/ui.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/user_ui.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/__init__.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/login.css +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/login.js +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/users.css +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/assets/users.js +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/src/chatlogin/web/templates/chatlogin/login.html +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/cli-tests/README.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/README.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_async_credentials.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_chatvoice_backend.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_chatvoice_managed_backend.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_core.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_core_guards.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_multiuser.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_release_contract.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_site.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_demo_ux.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_http_guards.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_live_login_service.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_concurrency.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_demo.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_form_safety.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_integration.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_journal_race.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_plugin.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_read_snapshot.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_sessions.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_ui.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_users.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_managed_web.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_origin_mount.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_packaging_demo.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_scaffold_contract.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_session_purge.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_sqlite_security.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_storage_platform.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_ui_contract.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/code-tests/test_web.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/conftest.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/mock-cli-tests/README.md +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_cli.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_docs_deployment.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_managed_cli.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_managed_docs.py +0 -0
- {chatlogin-0.2.0 → chatlogin-0.2.1}/tests/test_paths_cli.py +0 -0
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
+
## 0.2.1 — 2026-10-14
|
|
4
|
+
|
|
5
|
+
- 新增 Host 校验、no-store 的 `GET {prefix}/api`,按真实路由和可信 ASGI mount 发现操作、页面和能力;headless 不声明页面。
|
|
6
|
+
- 新增可组合 `AccountMenuUI` 齿轮/链接片段、scoped CSS 和角色感知导航;默认用户管理、本人资料和 managed demo 宿主页复用。
|
|
7
|
+
- 新增无默认生产账号的新服务 factory 示例与中英文接入说明;保持既有请求、CSRF、Origin、角色和 URL 契约。
|
|
8
|
+
|
|
3
9
|
## 0.2.0 — 2026-10-11
|
|
4
10
|
|
|
5
11
|
- 新增应用显式采用的 managed users 接入面:首个 owner 的环境变量 bootstrap、`ManagedUsers` / `create_managed_auth` 指引、owner/admin/user 角色矩阵,以及默认登录、用户管理和本人资料路由说明。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: ChatLogin
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.1
|
|
4
4
|
Summary: Reusable authentication, sessions, and login templates for Python-backed websites.
|
|
5
5
|
Author-email: ChatArch <1073853456@qq.com>
|
|
6
6
|
License-Expression: MIT
|
|
@@ -105,7 +105,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
|
|
|
105
105
|
|
|
106
106
|
核心包不要求网站采用包内页面。已有静态 HTML/原生 JS 的网站可以只挂载 JSON 路由,继续保留原登录入口和用户数据库;标准库 HTTP 宿主也可以只使用 `LoginUI` 渲染登录页。
|
|
107
107
|
|
|
108
|
-
## 托管用户(0.2.
|
|
108
|
+
## 托管用户(0.2.1)
|
|
109
|
+
|
|
110
|
+
新服务可通过 `GET {prefix}/api` 发现真实注册路由,并把 `AccountMenuUI` 齿轮/链接菜单放进宿主页;完整 factory、`/admin` 前缀、headless 与自有模板示例见[新服务接入](docs/service-onboarding.md)。这不是跨服务 SSO。
|
|
109
111
|
|
|
110
112
|
需要应用内 owner/admin/user、登录页、本人资料和用户管理时,新消费者显式采用 `ChatLogin>=0.2.0,<0.3.0`,并使用 `ManagedUsers` 与 `create_managed_auth`。第一个 owner 必须由操作员执行 `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY` 创建;KEY 是环境变量名,绝不把密码放进 argv。它只允许空实例首次初始化,没有迁移、`--force` 或默认生产凭据。见[托管用户指南](docs/managed-users.md)。
|
|
111
113
|
|
|
@@ -59,7 +59,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
|
|
|
59
59
|
|
|
60
60
|
The core package does not require adopting the packaged page. An existing static HTML/vanilla-JS site can mount only JSON routes and retain its current entry page and user database; a standard-library HTTP host can use `LoginUI` for rendering without installing FastAPI.
|
|
61
61
|
|
|
62
|
-
## Managed Users (0.2.
|
|
62
|
+
## Managed Users (0.2.1)
|
|
63
|
+
|
|
64
|
+
New services can discover registered routes through `GET {prefix}/api` and embed the `AccountMenuUI` gear/links fragment. See [New Service Onboarding](docs/service-onboarding.en.md) for a complete factory, `/admin` prefix, headless and host-template options. This is not cross-service SSO.
|
|
63
65
|
|
|
64
66
|
For an application-owned owner/admin/user directory, login, profile, and user management, new consumers explicitly adopt `ChatLogin>=0.2.0,<0.3.0` with `ManagedUsers` and `create_managed_auth`. An operator creates the first owner with `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY`; KEY is an environment-variable name, never a password in argv. Bootstrap works only for an empty instance and has no migration, `--force`, or default production credential. See [Managed Users](docs/managed-users.en.md).
|
|
65
67
|
|
|
@@ -59,7 +59,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
|
|
|
59
59
|
|
|
60
60
|
核心包不要求网站采用包内页面。已有静态 HTML/原生 JS 的网站可以只挂载 JSON 路由,继续保留原登录入口和用户数据库;标准库 HTTP 宿主也可以只使用 `LoginUI` 渲染登录页。
|
|
61
61
|
|
|
62
|
-
## 托管用户(0.2.
|
|
62
|
+
## 托管用户(0.2.1)
|
|
63
|
+
|
|
64
|
+
新服务可通过 `GET {prefix}/api` 发现真实注册路由,并把 `AccountMenuUI` 齿轮/链接菜单放进宿主页;完整 factory、`/admin` 前缀、headless 与自有模板示例见[新服务接入](docs/service-onboarding.md)。这不是跨服务 SSO。
|
|
63
65
|
|
|
64
66
|
需要应用内 owner/admin/user、登录页、本人资料和用户管理时,新消费者显式采用 `ChatLogin>=0.2.0,<0.3.0`,并使用 `ManagedUsers` 与 `create_managed_auth`。第一个 owner 必须由操作员执行 `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY` 创建;KEY 是环境变量名,绝不把密码放进 argv。它只允许空实例首次初始化,没有迁移、`--force` 或默认生产凭据。见[托管用户指南](docs/managed-users.md)。
|
|
65
67
|
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Capability Map
|
|
2
2
|
|
|
3
|
+
ChatLogin 0.2.1 adds truthful `GET {prefix}/api` discovery and `AccountMenuUI` role-aware host navigation; headless does not advertise pages. See [New Service Onboarding](service-onboarding.en.md).
|
|
4
|
+
|
|
3
5
|
## Implemented Capabilities
|
|
4
6
|
|
|
5
7
|
| Capability | Status | Boundary |
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
| --- | --- | --- |
|
|
7
7
|
| 包内演示站 | 已实现(`demo` extra) | `chatlogin serve`、四类真实后端体验、模板游乐场与可复制接入示例;不连接生产数据 |
|
|
8
8
|
| 托管用户预设 | `0.2.0` | `ManagedUsers`、每实例 owner/admin/user、默认登录/管理/本人资料 UI/API;需显式采用,不迁移旧账户库 |
|
|
9
|
+
| 新服务发现与导航 | `0.2.1` | `GET {prefix}/api` 列出真实操作与能力;`AccountMenuUI` 复用角色入口,headless 不虚报页面;见[新服务接入](service-onboarding.md) |
|
|
9
10
|
| ChatVoice legacy 托管 facade | `0.2.0` | 保留原 `accounts` / `auth_sessions` 的 additive 初始化、一次性 owner 采用、metadata-aware 账号匹配和 managed users CRUD;需消费方显式采用 |
|
|
10
11
|
| 身份与授权 | 已实现 | `Principal`、`Role`、401/403、`require_role`、`require_owner`;admin 不自动绕过 owner |
|
|
11
12
|
| 认证后端 | 已实现 | `PasswordBackend` 支持一个或多个显式账号;`CallbackBackend` 接入宿主用户库;`AsyncCallbackBackend` await 异步上游校验 |
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# ChatLogin Documentation
|
|
2
2
|
|
|
3
|
+
**0.2.1 new-service path:** [Complete factory, account discovery, and gear/links navigation](service-onboarding.en.md).
|
|
4
|
+
|
|
3
5
|
ChatLogin makes the backend security contract for website login reusable in Python while leaving presentation under host control. Use the packaged page, override templates/CSS, or keep an existing HTML/vanilla-JS frontend and use the headless JSON API.
|
|
4
6
|
|
|
5
7
|
Site entry: <https://arch.gh.wzhecnu.cn/ChatLogin/en/>
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Integration and Security Boundaries
|
|
2
2
|
|
|
3
|
+
For the 0.2.1 read-only `GET {prefix}/api`, role-aware navigation, and composable menu, see [New Service Onboarding](service-onboarding.en.md). Discovery is not a session endpoint; retain the existing `GET /session` and CSRF/Origin contract.
|
|
4
|
+
|
|
3
5
|
Start with the [complete quick integration](quickstart.md). To explore the components first, install `ChatLogin[demo]` and run `chatlogin serve`; see [Demo](demo.md).
|
|
4
6
|
|
|
5
7
|
## Choose an Integration Level
|
|
@@ -67,6 +67,8 @@ This is an explicit application-account preset; it does not migrate fixed-accoun
|
|
|
67
67
|
|
|
68
68
|
## Embeddable Managed-user Plugin
|
|
69
69
|
|
|
70
|
+
0.2.1: `FastAPIAuth` and `ManagedAuth` expose `api_discovery(request)`, `navigation_from_request(request)`, and `render_account_menu(request, ui=None)`; optional `chatlogin.account_ui.AccountMenuUI(mode="gear" | "links", template_dirs=None, template_name=..., renderer=None)` renders the fragment. Discover HTTP operations through `GET {prefix}/api`; see [New Service Onboarding](service-onboarding.en.md).
|
|
71
|
+
|
|
70
72
|
`create_managed_auth(..., pages=True)` mounts default pages and APIs; `pages=False` mounts APIs only and preserves the host frontend. See [plugin integration](managed-users.md#plugin).
|
|
71
73
|
|
|
72
74
|
## Built-in Optional ChatVoice Backend
|
|
@@ -67,6 +67,8 @@ chatlogin.managed_web
|
|
|
67
67
|
|
|
68
68
|
## 可内嵌托管用户插件
|
|
69
69
|
|
|
70
|
+
0.2.1:`FastAPIAuth` 与 `ManagedAuth` 增加 `api_discovery(request)`、`navigation_from_request(request)`、`render_account_menu(request, ui=None)`;可选 UI 类 `chatlogin.account_ui.AccountMenuUI(mode="gear" | "links", template_dirs=None, template_name=..., renderer=None)`。HTTP 操作见 `GET {prefix}/api` 和[新服务接入](service-onboarding.md)。
|
|
71
|
+
|
|
70
72
|
`create_managed_auth(..., pages=True)` 挂载默认页面与接口;`pages=False` 只挂载接口,保留宿主前端。详见[插件集成](managed-users.md#plugin)。
|
|
71
73
|
|
|
72
74
|
## 内建可选 ChatVoice 后端
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Managed Users
|
|
2
2
|
|
|
3
|
+
For a complete new-service factory, account menu and read-only route discovery, see [New Service Onboarding](service-onboarding.en.md). The 0.2.0 managed-user behavior remains compatible.
|
|
4
|
+
|
|
3
5
|
This page describes the managed-users preset provided by `0.2.0`. New adopters should explicitly require `ChatLogin>=0.2.0,<0.3.0`. Existing fixed-account, callback, and ChatVoice-compatible integrations do not need to change. A legacy ChatVoice consumer's `<0.2` dependency remains unaffected unless it deliberately adopts managed users or the ChatVoice legacy-schema managed facade.
|
|
4
6
|
|
|
5
7
|
## Choose the Right Entry Point
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# 托管用户
|
|
2
2
|
|
|
3
|
+
完整新服务 factory、菜单和只读路由发现见[新服务接入](service-onboarding.md);本页的 0.2.0 托管能力与行为保持兼容。
|
|
4
|
+
|
|
3
5
|
本页说明 `0.2.0` 提供的托管用户预设。新接入方应显式声明 `ChatLogin>=0.2.0,<0.3.0`;已使用固定账号、回调或 ChatVoice 兼容后端的应用不必改变。ChatVoice 既有消费者的 `<0.2` 依赖保持不受影响,只有主动采用托管用户或 ChatVoice legacy schema 托管 facade 时才升级和接入。
|
|
4
6
|
|
|
5
7
|
## 先选择合适的入口
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Integrate Your Own Project
|
|
2
2
|
|
|
3
|
+
For discovery and host-page navigation, start with [New Service Onboarding](service-onboarding.en.md): a complete factory, `/admin` prefix, gear/links menu, and headless options.
|
|
4
|
+
|
|
3
5
|
<div class="grid cards" markdown>
|
|
4
6
|
|
|
5
7
|
- **New FastAPI host**: copy the complete application below and perform a real login.
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# New-service onboarding: one account HTTP contract
|
|
2
|
+
|
|
3
|
+
ChatLogin 0.2.1 mounts an account plugin **inside each service**. One `create_managed_auth` provides login, sessions, profile and user management. Choose a gear menu, ordinary links or a host frontend without copying authentication. This is not shared-cookie SSO, a central identity service or generic CRUD for arbitrary external account providers.
|
|
4
|
+
|
|
5
|
+
## An end-to-end new service
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
python -m pip install "ChatLogin[web]==0.2.1" uvicorn
|
|
9
|
+
chatlogin users bootstrap operator --instance my-service --password-env MY_SERVICE_BOOTSTRAP_PASSWORD
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
Provide the bootstrap variable through a protected process environment first. The CLI receives its name, never a password value. No production account is created automatically. Save the [complete factory](https://github.com/ChatArch/ChatLogin/blob/main/examples/managed_service.py) as `auth_app.py`, then create `app.py`:
|
|
13
|
+
|
|
14
|
+
```python
|
|
15
|
+
import os
|
|
16
|
+
from auth_app import create_app
|
|
17
|
+
from chatlogin.account_ui import AccountMenuUI
|
|
18
|
+
|
|
19
|
+
app = create_app(
|
|
20
|
+
instance="my-service",
|
|
21
|
+
origin=os.environ["MY_SERVICE_ORIGIN"],
|
|
22
|
+
prefix="/auth", # /admin is another deployment prefix, not a permission grant
|
|
23
|
+
menu_ui=AccountMenuUI(mode="gear", language="en"),
|
|
24
|
+
allow_insecure_loopback=os.environ.get("MY_SERVICE_ALLOW_LOOPBACK") == "1",
|
|
25
|
+
)
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Production uses the actual fixed HTTPS browser origin; the host owns TLS and reverse proxying:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
MY_SERVICE_ORIGIN=https://service.example.com python -m uvicorn app:app --host 127.0.0.1 --port 8765
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
For explicit local development only:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
MY_SERVICE_ORIGIN=http://127.0.0.1:8765 MY_SERVICE_ALLOW_LOOPBACK=1 python -m uvicorn app:app --host 127.0.0.1 --port 8765
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Open the homepage → Account settings → Login. Owners/admins can open management; members have their own profile. `/private` uses `auth.current_user`; `/operator` requires explicit admin/owner roles. Business-resource ownership still belongs to the host: roles do not bypass `require_owner` or ACLs.
|
|
41
|
+
|
|
42
|
+
The factory closes a store it creates during ASGI shutdown. An injected service is caller-owned and must be closed by the caller, so one host cannot destroy another host's shared in-process service. Synthetic in-memory users are only explicit test fixtures, not production defaults or an automatic migration.
|
|
43
|
+
|
|
44
|
+
## A discoverable API root
|
|
45
|
+
|
|
46
|
+
`GET /auth/api` returns `version` (installed package), `schema_version=1` (discovery format), actual `{method, path}` `operations`, available `pages` and `login`/`managed_users`/`profile` `capabilities`. With `/admin`, the root is `/admin/api`. URLs include trusted ASGI mount metadata, not forwarded-prefix headers.
|
|
47
|
+
|
|
48
|
+
Host checking and `no-store` apply. Discovery reveals no account directory, Cookie, CSRF, credentials or state paths. It advertises provided capabilities, not actor permissions. Fixed/callback backends do not claim managed-user administration; headless mode advertises no pages. This operation directory is not a complete request/response schema or an OAuth endpoint.
|
|
49
|
+
|
|
50
|
+
| Method and relative path | JSON / result | Authorization |
|
|
51
|
+
| --- | --- | --- |
|
|
52
|
+
| `GET /api` | Discovery | Trusted Host, anonymous allowed |
|
|
53
|
+
| `GET /session` | authenticated, user, csrf_token | Trusted Host; anonymous gets 200 |
|
|
54
|
+
| `POST /login` | username, password, optional next | Same-origin; existing session needs CSRF |
|
|
55
|
+
| `POST /logout` | Revoke session | Current session, Origin, CSRF |
|
|
56
|
+
| `GET /api/users?offset=0&limit=100` | Safe metadata list, limit≤100 | Owner/admin within policy scope |
|
|
57
|
+
| `POST /api/users` | username, password, optional display_name/role; 201 | Owner/admin; only owner grants admin |
|
|
58
|
+
| `GET /api/users/{user_id}` | Safe metadata | Object-scoped owner/admin |
|
|
59
|
+
| `PATCH /api/users/{user_id}` | Allowed display_name/role/enabled combination | Object policy, Origin, CSRF |
|
|
60
|
+
| `DELETE /api/users/{user_id}` | deleted | Object policy, Origin, CSRF; never delete owner |
|
|
61
|
+
| `POST /api/users/{user_id}/password` | new_password | Object policy, Origin, CSRF |
|
|
62
|
+
| `GET /api/profile` | Own profile | Current user |
|
|
63
|
+
| `PATCH /api/profile` | display_name | Self, Origin, CSRF |
|
|
64
|
+
| `POST /api/profile/password` | current_password, new_password | Self, Origin, CSRF; invalidate old sessions |
|
|
65
|
+
| `POST /api/owner/transfer` | target_user_id, current_password, confirm_username | Owner reauthentication, Origin, CSRF, atomic handoff |
|
|
66
|
+
|
|
67
|
+
Use browser `credentials: 'same-origin'`, read current CSRF from `/session` and send `X-CSRF-Token` for writes. Never persist credentials, Cookie or CSRF in browser storage, URLs or logs. Common errors: 400 invalid request/Host; 401 unauthenticated; 403 policy/Origin/CSRF; 404 missing object; 409 conflict; 413 oversized body; 429 rate limit; 503 controlled capacity/service failure. The operation catalog supplements this contract and host OpenAPI; it does not replace request/response schemas.
|
|
68
|
+
|
|
69
|
+
## Gear, links and DIY
|
|
70
|
+
|
|
71
|
+
```python
|
|
72
|
+
from chatlogin.account_ui import AccountMenuUI
|
|
73
|
+
|
|
74
|
+
menu = await auth.render_account_menu(request) # Chinese-first native details
|
|
75
|
+
menu = await auth.render_account_menu(request, ui=AccountMenuUI(mode="links", language="en"))
|
|
76
|
+
menu = await auth.render_account_menu(
|
|
77
|
+
request, ui=AccountMenuUI(template_dirs=["templates"], template_name="account/menu.html")
|
|
78
|
+
)
|
|
79
|
+
navigation = await auth.navigation_from_request(request) # host-owned rendering
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Host HTML containing current identity must also set `Cache-Control: no-store`; never share-cache an account menu. Navigation resolves the actual current session. Anonymous visitors see login; members see profile; admins/owners also see management. Changes invalidate stale sessions. The native vertical gear popover needs no JavaScript initialization, has scoped CSS and inherits host typography/theme. Default rendering escapes identity/labels and validates local links; trusted custom renderers own HTML safety. Sign-out remains the existing CSRF-protected POST, not a GET link.
|
|
83
|
+
|
|
84
|
+
`pages=False` retains JSON APIs without packaged HTML/assets and produces no fake empty settings control. Host frontends use the same HTTP contract. `LoginUI`, `UserAdminUI` and `UserProfileUI` remain separately replaceable; never patch site-packages. Existing account providers retain their own lifecycle unless an explicit managed adapter exists. A unified HTTP contract is not a shared account database or cross-site SSO. See [Managed Users](managed-users.en.md) and [Integration and Security](integration.en.md).
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# 新服务接入:统一账号 HTTP 契约
|
|
2
|
+
|
|
3
|
+
ChatLogin 0.2.1 把账号接口和页面作为**每个服务自己的插件**挂载。一次 `create_managed_auth` 可得到登录、会话、本人资料和用户管理;宿主选择齿轮、普通链接或自有前端,不复制认证实现。这不是共享 Cookie 的 SSO、集中身份服务或任意外部用户库的通用 CRUD。
|
|
4
|
+
|
|
5
|
+
## 从空服务到可登录页面
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
python -m pip install "ChatLogin[web]==0.2.1" uvicorn
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
先在受保护的进程环境中提供 `MY_SERVICE_BOOTSTRAP_PASSWORD`,再初始化空实例。命令行只接收变量名,不接收密码值;没有生产默认账号或自动注册。
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
chatlogin users bootstrap operator --instance my-service --password-env MY_SERVICE_BOOTSTRAP_PASSWORD
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
把 [完整 factory](https://github.com/ChatArch/ChatLogin/blob/main/examples/managed_service.py) 保存为 `auth_app.py`,再建立 `app.py`:
|
|
18
|
+
|
|
19
|
+
```python
|
|
20
|
+
import os
|
|
21
|
+
from auth_app import create_app
|
|
22
|
+
from chatlogin.account_ui import AccountMenuUI
|
|
23
|
+
|
|
24
|
+
app = create_app(
|
|
25
|
+
instance="my-service", # 与 bootstrap 相同
|
|
26
|
+
origin=os.environ["MY_SERVICE_ORIGIN"],
|
|
27
|
+
prefix="/auth", # 也可 /admin;不影响角色策略
|
|
28
|
+
menu_ui=AccountMenuUI(mode="gear"),
|
|
29
|
+
allow_insecure_loopback=os.environ.get("MY_SERVICE_ALLOW_LOOPBACK") == "1",
|
|
30
|
+
)
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
部署使用浏览器真正访问的固定 HTTPS origin,由宿主负责 TLS/反代:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
MY_SERVICE_ORIGIN=https://service.example.com python -m uvicorn app:app --host 127.0.0.1 --port 8765
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
仅在本机开发时显式开启 loopback HTTP:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
MY_SERVICE_ORIGIN=http://127.0.0.1:8765 MY_SERVICE_ALLOW_LOOPBACK=1 python -m uvicorn app:app --host 127.0.0.1 --port 8765
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
打开首页 → 齿轮“账号设置” → 登录;owner/admin 登录后可进入用户管理,普通用户只进入本人资料。示例还提供 `/private` 的 `auth.current_user` 和 `/operator` 的明确角色依赖。业务数据仍需 `require_owner` 或宿主 ACL,admin/owner 不自动读取他人的业务记录。
|
|
46
|
+
|
|
47
|
+
factory 自建的 store 在 ASGI shutdown 关闭。测试或共享同进程服务可显式注入 `users`;注入对象由调用方拥有并负责关闭,不因一个宿主退出而被销毁。它不会迁移既有账户或读取演示默认凭据。
|
|
48
|
+
|
|
49
|
+
## 统一的 API 发现入口
|
|
50
|
+
|
|
51
|
+
`GET /auth/api` 返回 `version`(安装包版本)、`schema_version=1`(发现格式)、`operations`(实际注册的 HTTP 方法和路径)、`pages`(存在的页面)和 `capabilities`(login/managed_users/profile)。`prefix="/admin"` 时入口为 `/admin/api`;可信 ASGI mount 也计入 URL,忽略任意 forwarded-prefix 头。
|
|
52
|
+
|
|
53
|
+
发现接口验证 Host、返回 `no-store`,不返回用户目录、Cookie、CSRF、凭据或 state 路径。它描述**功能是否提供**,不代表当前用户有权限。固定账号/callback 不虚报用户管理;`pages=False` 的页面表为空。
|
|
54
|
+
|
|
55
|
+
### 默认 HTTP 契约
|
|
56
|
+
|
|
57
|
+
以下路径均相对 `/auth`(或宿主选择的前缀)。会话身份由服务端解析,绝不从请求的 actor/role 字段获得管理员权限。
|
|
58
|
+
|
|
59
|
+
| 方法与路径 | JSON/结果 | 权限 |
|
|
60
|
+
| --- | --- | --- |
|
|
61
|
+
| `GET /api` | 发现信息 | 可信 Host,可匿名 |
|
|
62
|
+
| `GET /session` | authenticated、user、csrf_token | 可信 Host;匿名也返回 200 |
|
|
63
|
+
| `POST /login` | username、password、可选 next | 同源;已有会话还需当前 CSRF |
|
|
64
|
+
| `POST /logout` | 撤销会话 | 登录、同源、CSRF |
|
|
65
|
+
| `GET /api/users?offset=0&limit=100` | 安全用户列表;limit≤100 | owner/admin,范围由后端策略限制 |
|
|
66
|
+
| `POST /api/users` | username、password、可选 display_name/role;201 | owner/admin;只有 owner 可授予 admin |
|
|
67
|
+
| `GET /api/users/{user_id}` | 用户安全元数据 | owner/admin 的可管理范围 |
|
|
68
|
+
| `PATCH /api/users/{user_id}` | display_name、role、enabled 的合法组合 | 对象级权限、同源、CSRF |
|
|
69
|
+
| `DELETE /api/users/{user_id}` | deleted | 对象级权限、同源、CSRF;禁止删 owner |
|
|
70
|
+
| `POST /api/users/{user_id}/password` | new_password | 对象级权限、同源、CSRF |
|
|
71
|
+
| `GET /api/profile` | 本人用户资料 | 当前登录用户 |
|
|
72
|
+
| `PATCH /api/profile` | display_name | 本人、同源、CSRF |
|
|
73
|
+
| `POST /api/profile/password` | current_password、new_password | 本人、同源、CSRF;旧会话失效 |
|
|
74
|
+
| `POST /api/owner/transfer` | target_user_id、current_password、confirm_username | owner 复验、同源、CSRF、原子交接 |
|
|
75
|
+
|
|
76
|
+
浏览器 `credentials: 'same-origin'`,从 `/session` 读取当前 CSRF,在写操作 `X-CSRF-Token` 头发送;不要把密码、Cookie 或 CSRF 写入 localStorage、URL 或日志。常见错误为 400(非法请求/Host)、401(未认证)、403(权限/Origin/CSRF)、404(对象不存在)、409(状态冲突)、413(体上限)、429(限流)、503(受控容量/服务不可用)。发现目录不是完整请求/响应 Schema,也不替代上述契约和宿主 OpenAPI。
|
|
77
|
+
|
|
78
|
+
## 齿轮、普通链接与 DIY
|
|
79
|
+
|
|
80
|
+
```python
|
|
81
|
+
from chatlogin.account_ui import AccountMenuUI
|
|
82
|
+
|
|
83
|
+
# 宿主 async GET handler 内;request 为真实 FastAPI Request。
|
|
84
|
+
menu = await auth.render_account_menu(request) # 中文、原生齿轮浮层
|
|
85
|
+
menu = await auth.render_account_menu(request, ui=AccountMenuUI(mode="links"))
|
|
86
|
+
menu = await auth.render_account_menu(request, ui=AccountMenuUI(language="en"))
|
|
87
|
+
# 自有模板或可信 renderer:
|
|
88
|
+
menu = await auth.render_account_menu(
|
|
89
|
+
request, ui=AccountMenuUI(template_dirs=["templates"], template_name="account/menu.html")
|
|
90
|
+
)
|
|
91
|
+
# 完全 DIY:只拿安全导航信息,自行渲染。
|
|
92
|
+
navigation = await auth.navigation_from_request(request)
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
宿主承载当前身份的 HTML 响应也需设置 `Cache-Control: no-store`,不要由 CDN 或共享缓存保存用户菜单。导航从真实当前 session 解析 identity/role/links/assets_path;改密、禁用或角色变化后旧会话不继续提供管理入口。菜单不依赖 JS 初始化;CSS 仅作用于自身,并继承宿主字体和 ChatLogin 色板。默认片段自动转义身份/标签并验证本地链接,renderer 的 HTML 安全由可信宿主负责。退出仍是现有页面中的受 CSRF 保护 POST,不提供 GET 退出链接。
|
|
96
|
+
|
|
97
|
+
`pages=False` 保留 JSON API、没有默认 HTML/assets;默认菜单也不生成假的空设置按钮。自有前端按同一 HTTP 契约工作。`LoginUI`、`UserAdminUI`、`UserProfileUI` 保持独立模板/renderer 覆盖,安装位置不应被手动修改。
|
|
98
|
+
|
|
99
|
+
已有用户库应选择 [适配路径](integration.md):callback 只认证,不自动接管账户生命周期;ChatVoice legacy schema 使用明确保留式 adapter。统一 HTTP 契约不等于统一账号库、共享 Cookie 或跨站 SSO。
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
"""New-service factory; no production accounts or credentials are generated."""
|
|
2
|
+
from contextlib import asynccontextmanager
|
|
3
|
+
from html import escape
|
|
4
|
+
|
|
5
|
+
from fastapi import Depends, FastAPI, Request
|
|
6
|
+
from fastapi.responses import HTMLResponse
|
|
7
|
+
|
|
8
|
+
from chatlogin import Role
|
|
9
|
+
from chatlogin.account_ui import AccountMenuUI
|
|
10
|
+
from chatlogin.managed_web import create_managed_auth
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
def create_app(*, instance: str, origin: str, prefix: str = "/auth", users=None,
|
|
14
|
+
pages: bool = True, allow_insecure_loopback: bool = False,
|
|
15
|
+
menu_ui: AccountMenuUI | None = None) -> FastAPI:
|
|
16
|
+
owns_users = users is None
|
|
17
|
+
auth = create_managed_auth(instance, origin=origin, prefix=prefix, users=users,
|
|
18
|
+
pages=pages, allow_insecure_loopback=allow_insecure_loopback)
|
|
19
|
+
|
|
20
|
+
@asynccontextmanager
|
|
21
|
+
async def lifespan(_app):
|
|
22
|
+
try:
|
|
23
|
+
yield
|
|
24
|
+
finally:
|
|
25
|
+
if owns_users:
|
|
26
|
+
auth.users.close()
|
|
27
|
+
|
|
28
|
+
app = FastAPI(lifespan=lifespan)
|
|
29
|
+
app.state.chatlogin_auth = auth
|
|
30
|
+
app.include_router(auth.router)
|
|
31
|
+
|
|
32
|
+
@app.get("/", response_class=HTMLResponse)
|
|
33
|
+
async def home(request: Request):
|
|
34
|
+
menu = await auth.render_account_menu(request, ui=menu_ui)
|
|
35
|
+
navigation = await auth.navigation_from_request(request)
|
|
36
|
+
assets = escape(str(navigation["assets_path"]), quote=True)
|
|
37
|
+
styles = (f'<link rel="stylesheet" href="{assets}/login.css">'
|
|
38
|
+
f'<link rel="stylesheet" href="{assets}/users.css">') if assets else ""
|
|
39
|
+
response = HTMLResponse(
|
|
40
|
+
'<!doctype html><html lang="zh-CN"><head><meta charset="utf-8">'
|
|
41
|
+
'<meta name="viewport" content="width=device-width, initial-scale=1">'
|
|
42
|
+
f'<title>新服务接入示例</title>{styles}</head><body class="chatlogin-page">'
|
|
43
|
+
'<main class="chatlogin" data-appearance="system"><section class="chatlogin__panel">'
|
|
44
|
+
'<header class="chatlogin-users__header"><h1>示例服务</h1>'
|
|
45
|
+
f'{menu}</header><p class="chatlogin__subtitle">本页复用 ChatLogin 登录、账号与用户管理入口。</p>'
|
|
46
|
+
'</section></main></body></html>')
|
|
47
|
+
response.headers["Cache-Control"] = "no-store"
|
|
48
|
+
response.headers["Content-Security-Policy"] = "default-src 'self'; style-src 'self'; base-uri 'none'; frame-ancestors 'none'"
|
|
49
|
+
return response
|
|
50
|
+
|
|
51
|
+
@app.get("/private")
|
|
52
|
+
async def private(principal=Depends(auth.current_user)):
|
|
53
|
+
return principal.as_dict()
|
|
54
|
+
|
|
55
|
+
@app.get("/operator")
|
|
56
|
+
async def operator(principal=Depends(auth.roles(Role.ADMIN, Role.OWNER))):
|
|
57
|
+
return {"user_id": principal.user_id}
|
|
58
|
+
|
|
59
|
+
return app
|
|
@@ -43,6 +43,7 @@ plugins:
|
|
|
43
43
|
快速接入: Quick Integration
|
|
44
44
|
演示站与快速开始: Demo and Quick Start
|
|
45
45
|
托管用户: Managed Users
|
|
46
|
+
新服务接入: New Service Onboarding
|
|
46
47
|
ChatVoice legacy schema 集成: ChatVoice Legacy Schema Integration
|
|
47
48
|
markdown_extensions:
|
|
48
49
|
- admonition
|
|
@@ -71,6 +72,7 @@ nav:
|
|
|
71
72
|
- 快速接入: quickstart.md
|
|
72
73
|
- 接入与安全: integration.md
|
|
73
74
|
- 托管用户: managed-users.md
|
|
75
|
+
- 新服务接入: service-onboarding.md
|
|
74
76
|
- ChatVoice legacy schema 集成: chatvoice-managed.md
|
|
75
77
|
- 命令与接口:
|
|
76
78
|
- CLI 树: cli-tree.md
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: ChatLogin
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.1
|
|
4
4
|
Summary: Reusable authentication, sessions, and login templates for Python-backed websites.
|
|
5
5
|
Author-email: ChatArch <1073853456@qq.com>
|
|
6
6
|
License-Expression: MIT
|
|
@@ -105,7 +105,9 @@ chatlogin serve --host 127.0.0.1 --port 8765 --origin https://login.example.com
|
|
|
105
105
|
|
|
106
106
|
核心包不要求网站采用包内页面。已有静态 HTML/原生 JS 的网站可以只挂载 JSON 路由,继续保留原登录入口和用户数据库;标准库 HTTP 宿主也可以只使用 `LoginUI` 渲染登录页。
|
|
107
107
|
|
|
108
|
-
## 托管用户(0.2.
|
|
108
|
+
## 托管用户(0.2.1)
|
|
109
|
+
|
|
110
|
+
新服务可通过 `GET {prefix}/api` 发现真实注册路由,并把 `AccountMenuUI` 齿轮/链接菜单放进宿主页;完整 factory、`/admin` 前缀、headless 与自有模板示例见[新服务接入](docs/service-onboarding.md)。这不是跨服务 SSO。
|
|
109
111
|
|
|
110
112
|
需要应用内 owner/admin/user、登录页、本人资料和用户管理时,新消费者显式采用 `ChatLogin>=0.2.0,<0.3.0`,并使用 `ManagedUsers` 与 `create_managed_auth`。第一个 owner 必须由操作员执行 `chatlogin users bootstrap USERNAME --instance NAME --password-env KEY` 创建;KEY 是环境变量名,绝不把密码放进 argv。它只允许空实例首次初始化,没有迁移、`--force` 或默认生产凭据。见[托管用户指南](docs/managed-users.md)。
|
|
111
113
|
|
|
@@ -24,7 +24,10 @@ docs/managed-users.en.md
|
|
|
24
24
|
docs/managed-users.md
|
|
25
25
|
docs/quickstart.en.md
|
|
26
26
|
docs/quickstart.md
|
|
27
|
+
docs/service-onboarding.en.md
|
|
28
|
+
docs/service-onboarding.md
|
|
27
29
|
examples/demo_fastapi.py
|
|
30
|
+
examples/managed_service.py
|
|
28
31
|
examples/quickstart_fastapi.py
|
|
29
32
|
src/ChatLogin.egg-info/PKG-INFO
|
|
30
33
|
src/ChatLogin.egg-info/SOURCES.txt
|
|
@@ -33,6 +36,7 @@ src/ChatLogin.egg-info/entry_points.txt
|
|
|
33
36
|
src/ChatLogin.egg-info/requires.txt
|
|
34
37
|
src/ChatLogin.egg-info/top_level.txt
|
|
35
38
|
src/chatlogin/__init__.py
|
|
39
|
+
src/chatlogin/account_ui.py
|
|
36
40
|
src/chatlogin/cli.py
|
|
37
41
|
src/chatlogin/config.py
|
|
38
42
|
src/chatlogin/credentials.py
|
|
@@ -63,10 +67,12 @@ src/chatlogin/demo_site/templates/managed.html
|
|
|
63
67
|
src/chatlogin/demo_site/templates/templates.html
|
|
64
68
|
src/chatlogin/demo_site/templates/workspace.html
|
|
65
69
|
src/chatlogin/web/__init__.py
|
|
70
|
+
src/chatlogin/web/assets/account-menu.css
|
|
66
71
|
src/chatlogin/web/assets/login.css
|
|
67
72
|
src/chatlogin/web/assets/login.js
|
|
68
73
|
src/chatlogin/web/assets/users.css
|
|
69
74
|
src/chatlogin/web/assets/users.js
|
|
75
|
+
src/chatlogin/web/templates/chatlogin/account-menu.html
|
|
70
76
|
src/chatlogin/web/templates/chatlogin/login.html
|
|
71
77
|
src/chatlogin/web/templates/chatlogin/profile.html
|
|
72
78
|
src/chatlogin/web/templates/chatlogin/users.html
|
|
@@ -101,10 +107,12 @@ tests/code-tests/test_managed_sessions.py
|
|
|
101
107
|
tests/code-tests/test_managed_ui.py
|
|
102
108
|
tests/code-tests/test_managed_users.py
|
|
103
109
|
tests/code-tests/test_managed_web.py
|
|
110
|
+
tests/code-tests/test_onboarding_acceptance.py
|
|
104
111
|
tests/code-tests/test_origin_mount.py
|
|
105
112
|
tests/code-tests/test_packaging_demo.py
|
|
106
113
|
tests/code-tests/test_packaging_imports.py
|
|
107
114
|
tests/code-tests/test_scaffold_contract.py
|
|
115
|
+
tests/code-tests/test_service_onboarding.py
|
|
108
116
|
tests/code-tests/test_session_purge.py
|
|
109
117
|
tests/code-tests/test_sqlite_security.py
|
|
110
118
|
tests/code-tests/test_storage_platform.py
|
|
@@ -32,7 +32,7 @@ from .security import LoginRateLimiter, require_csrf, safe_next
|
|
|
32
32
|
from .sessions import IssuedSession, MemorySessionStore, Session, SessionManager, SessionStore, StoreFull
|
|
33
33
|
from .sqlite import SQLiteSessionStore
|
|
34
34
|
|
|
35
|
-
__version__ = "0.2.
|
|
35
|
+
__version__ = "0.2.1"
|
|
36
36
|
__all__ = [
|
|
37
37
|
"__version__", "AccessDenied", "Principal", "Role", "require_admin", "require_owner", "require_role", "require_user",
|
|
38
38
|
"AsyncCallbackBackend", "AsyncCredentialBackend", "CallbackBackend", "CredentialBackend",
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
"""Optional, host-composable account navigation fragment."""
|
|
2
|
+
from __future__ import annotations
|
|
3
|
+
|
|
4
|
+
from dataclasses import dataclass
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
from typing import Callable, Mapping, Sequence
|
|
7
|
+
|
|
8
|
+
from jinja2 import ChoiceLoader, Environment, FileSystemLoader, PackageLoader, select_autoescape
|
|
9
|
+
|
|
10
|
+
from .user_ui import _template_dirs, _template_name
|
|
11
|
+
from .ui import _local_url
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
@dataclass(frozen=True)
|
|
15
|
+
class AccountMenuUI:
|
|
16
|
+
mode: str = "gear"
|
|
17
|
+
language: str = "zh-CN"
|
|
18
|
+
template_dirs: Sequence[str | Path] | None = None
|
|
19
|
+
template_name: str = "chatlogin/account-menu.html"
|
|
20
|
+
renderer: Callable[[Mapping[str, object]], str] | None = None
|
|
21
|
+
|
|
22
|
+
def __post_init__(self) -> None:
|
|
23
|
+
if self.mode not in {"gear", "links"}:
|
|
24
|
+
raise ValueError("mode must be gear or links")
|
|
25
|
+
if self.language not in {"zh-CN", "en"}:
|
|
26
|
+
raise ValueError("language must be zh-CN or en")
|
|
27
|
+
_template_name(self.template_name)
|
|
28
|
+
object.__setattr__(self, "template_dirs", _template_dirs(self.template_dirs, ()))
|
|
29
|
+
if self.renderer is not None and not callable(self.renderer):
|
|
30
|
+
raise TypeError("renderer must be callable")
|
|
31
|
+
|
|
32
|
+
def render(self, context: Mapping[str, object]) -> str:
|
|
33
|
+
data = dict(context)
|
|
34
|
+
for link in data.get("links", ()):
|
|
35
|
+
_local_url(link["url"], "account link")
|
|
36
|
+
if data.get("assets_path"):
|
|
37
|
+
_local_url(data["assets_path"], "assets_path")
|
|
38
|
+
data["mode"] = self.mode
|
|
39
|
+
labels = ({"login": "登录", "profile": "我的账号", "users": "用户管理"}
|
|
40
|
+
if self.language == "zh-CN" else
|
|
41
|
+
{"login": "Login", "profile": "My profile", "users": "Manage users"})
|
|
42
|
+
data["links"] = [dict(link, label=labels.get(link.get("key"), link["label"]))
|
|
43
|
+
for link in data.get("links", ())]
|
|
44
|
+
data["settings_label"] = "账号设置" if self.language == "zh-CN" else "Account settings"
|
|
45
|
+
if data.get("role") == "guest":
|
|
46
|
+
data["identity"] = "访客" if self.language == "zh-CN" else "Guest"
|
|
47
|
+
if self.renderer is not None:
|
|
48
|
+
html = self.renderer(data)
|
|
49
|
+
if not isinstance(html, str):
|
|
50
|
+
raise TypeError("renderer must return trusted HTML as a string")
|
|
51
|
+
return html
|
|
52
|
+
if not data["links"]:
|
|
53
|
+
return ""
|
|
54
|
+
loaders = []
|
|
55
|
+
if self.template_dirs:
|
|
56
|
+
loaders.append(FileSystemLoader([str(path) for path in self.template_dirs]))
|
|
57
|
+
loaders.append(PackageLoader("chatlogin.web", "templates"))
|
|
58
|
+
environment = Environment(loader=ChoiceLoader(loaders), autoescape=select_autoescape(("html", "xml"), default=True))
|
|
59
|
+
return environment.get_template(self.template_name).render(**data)
|
|
@@ -35,11 +35,7 @@
|
|
|
35
35
|
<li>User can view and change only its own profile and password.</li>
|
|
36
36
|
</ul>
|
|
37
37
|
</section>
|
|
38
|
-
|
|
39
|
-
<a id="managed-demo-login" href="{{LOGIN_URL}}">Login</a>
|
|
40
|
-
<a id="managed-demo-users" href="{{USERS_URL}}">Manage users</a>
|
|
41
|
-
<a id="managed-demo-profile" href="{{PROFILE_URL}}">My profile</a>
|
|
42
|
-
</nav>
|
|
38
|
+
{{ACCOUNT_MENU}}
|
|
43
39
|
</main>
|
|
44
40
|
</body>
|
|
45
41
|
</html>
|