[Bug] 插件页面以 URL query 传递页面会话令牌(asset_token),凭据随访问日志与 Referer 扩散
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 42/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- python
- Lĩnh vực
- backend-api-design, security
Hướng nghiên cứu
Start with astrbot/dashboard/services/plugin_page_service.py and astrbot/dashboard/plugin_page_auth.py to trace asset token creation, TTL configuration, and scope checks; then inspect the plugin v1 route dependencies and the panel code that adds asset_token to request URLs. The issue identifies reducing and configuring the TTL as a minimal fix, while removing credentials from URLs or adding page scoped refresh would touch more paths. Done means the credential exposure is reduced as described and the permitted routes remain scoped to the plugin page.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
问题描述
面板加载插件页面时,把「页面会话令牌(asset_token)」以 URL query 参数下发:
GET /api/plugin/page/bridge-sdk.js?asset_token=<JWT>&theme=lightGET /api/v1/plugins/<plugin_name>/views/<view_path>/?asset_token=<JWT>&theme=light
该令牌为独立签发,不与登录会话共用同一枚 JWT:payload 含 token_type=plugin_page_asset、purpose=page_session、plugin_name、page_name、locale、iat、exp;但仍与登录会话共用同一 jwt_secret 签名。有效期由常量决定,当前 PLUGIN_PAGE_ASSET_TOKEN_TTL_SECONDS = 7 * 24 * 60 * 60,即整 7 天(astrbot/dashboard/services/plugin_page_service.py:26)。
作用域:astrbot/dashboard/plugin_page_auth.py 的 is_scope_valid() 仅在请求路径以 /api/plugin/page/bridge-sdk.js 开头时放行,其余路径一律拒绝该类令牌(源码注释:every other path rejects scoped asset tokens);插件 v1 路由另由其路由依赖做 scope 校验。因此该令牌不能调用通用 /api/v1/*。
因为凭据出现在 URL 里,它仍会被多处被动留存:
- 反向代理 / CDN 访问日志:nginx 默认
log_format含"$request",query 原样落盘(实测一个日志轮转周期内 6 条完整令牌); - 浏览器历史、书签、「复制链接分享」;
- Referer:插件页面引用任何第三方资源(外链图片、字体、统计 SDK)时,完整 URL 随 Referer 外发;
- 排障截图 / 工单附件。
这些渠道的持有者可在有效期内用该令牌访问被 scope 允许的路由(bridge SDK 与该插件页面对应的 v1 路由),但不足以接管面板会话。
期望行为:
- 凭据不进入 URL / Referer / 访问日志;若因 webview 无法为静态资源请求设置 Authorization 头而必须走 query,应改为作用域受限的短期令牌——绑定单个插件页面、TTL 分钟级、可配置;
- 若一次性改造面较大,最小改动为把 TTL 从 7 天压到分钟级并支持配置;
- 长驻页面场景建议采用「短 TTL + 按页面 scope 刷新」的两层设计,而不是把单个令牌寿命拉长到 7 天。
参考:CWE-598(Use of GET Request Method With Sensitive Query Strings)。
如何复现?
- 部署 AstrBot 并登录面板(开启 TOTP 亦可,不影响复现);
- 安装任意带自定义页面的插件,在面板中打开该插件页面;
- 打开浏览器开发者工具 → Network,筛选
bridge-sdk.js或views/请求:可见 URL 上的asset_token为完整 JWT(三段式,eyJhbGciOiJIUzI1NiIsInR5cCI6…开头); - 作用域核对:该 token 对
/api/plugin/page/bridge-sdk.js及该插件页面对应的 v1 路由有效,对通用/api/v1/*会被 scope 校验拒绝。因此本 issue 的关注点是「凭据进 URL 与 TTL 过长」,不涉及会话接管; - 查看反向代理访问日志(或 CDN 日志),可见同一 URL 连同 token 被完整记录。
AstrBot 版本
v4.29.4-18-gf926af99e
操作系统
Linux
部署方式
源码部署(Python 3.14),由宝塔/GMSSH 的 Python 项目管理器托管进程,Nginx 反向代理 127.0.0.1:6185,HTTPS via 域名
使用的消息平台适配器
QQ官方机器人(WebSocket)
错误日志
本问题不是运行时异常,没有 traceback / Debug 栈;证据形态是反向代理访问日志中的请求行。下行为脱敏示例(JWT 与客户端 IP 已置换):
x.x.x.x - - [10/Nov/2026:15:51:52 +0800] "GET /api/plugin/page/bridge-sdk.js?asset_token=<JWT_REDACTED_eyJhbGciOi…len≈200>&theme=light HTTP/1.1" 200 2246 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …"
x.x.x.x - - [14/Nov/2026:14:00:47 +0800] "GET /api/v1/plugins/<plugin>/views/<path>/?asset_token=<JWT_REDACTED>&theme=light HTTP/1.1" 200 7205 "-" "Mozilla/5.0 …"
同一轮转周期内共 6 条(2026-11-10 至 2026-11-15)。
另外说明:在自建运维脚本(非 AstrBot 本体)的运行日志中曾检出 5 条登录会话 JWT,原因是该脚本把登录响应整体打印;属第三方脚本问题,已自行修复并轮换了 jwt_secret,与 AstrBot 无关。
出于安全考虑,公开 issue 中不提交真实 token 与完整日志;如需完整样本可私密提供。
辅助信息
No response
检查清单
- 我已在 Issue 列表 中搜索过相关问题仍无法解决,或该问题从未被报告过。
- 我已尝试过禁用所有插件,排除了可能是因插件导致的问题。
- 我报告的问题与 AstrBot 本体相关,而非在报告某一插件的问题。
- 我已阅读并同意本项目的贡献者行为准则。
- (可选) 我愿意提交 PR 以帮助修复该问题。
注:本正文已于 2026-11-17 按源码修正,原描述及撤回说明见下方评论。
- Ngôn ngữ chính
- Python
- Star
- 46.9k
- Fork
- 3.6k
- Merge trung bình
- 1 ngày 6 giờ
- Pull request đã merge (30 ngày)
- 136
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của AstrBotDevs/AstrBot
-
[Bug] Sending a Telegram message chain twice duplicates mentionsCó thể đã có người làm @123XieC đã nhận 5 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
AstrBotDevs/AstrBot#11125 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Bug] Telegram album debounce exceeds the maximum waitCó thể đã có người làm @123XieC đã nhận 5 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
AstrBotDevs/AstrBot#11123 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
AstrBotDevs/AstrBot#11034 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Bug] OpenAI-compatible Gemini 工具 schema const 导致 400Có thể đã có người làm @arccat-114 đã nhận 26 ngày trước. Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
AstrBotDevs/AstrBot#10720 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Bug] Discord slash command sync aborts with KeyError when a plugin handler is defined in a submoduleCó thể đã có người làm @yuexia5 đã nhận 31 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
AstrBotDevs/AstrBot#10626 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của AstrBotDevs/AstrBot
Issue tương tự
-
scverse link in README is brokenĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 61/100
scverse/infercnvpy#238 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
skrub-data/skrub#2442 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
due_at is one hour late on the autumn DST change day (real-time delta added to a zoneinfo datetime)Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
open-feature/python-sdk-contrib#482 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 94/100
warlock20/StartWithA#443 ·
Maintainer thường phản hồi trong vòng 1 ngày