From 1179623e25593bb82ad219510ef6c40a4ff448fb Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 12 Jun 2026 14:56:10 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E6=B5=8B=E8=AF=95=E6=9C=8D?= =?UTF-8?q?=20API=20=E6=96=87=E6=A1=A3=E7=AB=99=E7=99=BB=E5=BD=95=E6=94=B9?= =?UTF-8?q?=20Gitea=20=E8=B4=A6=E5=8F=B7=20SSO(=E7=99=BB=E5=BD=95=E4=B8=80?= =?UTF-8?q?=E6=AC=A130=E5=A4=A9=E5=85=8D=E7=99=BB=E5=BD=95)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- ...API文档站登录改Gitea账号SSO-环境变更-全员.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 changelogs-v2/2026-06/12_测试服API文档站登录改Gitea账号SSO-环境变更-全员.md diff --git a/changelogs-v2/2026-06/12_测试服API文档站登录改Gitea账号SSO-环境变更-全员.md b/changelogs-v2/2026-06/12_测试服API文档站登录改Gitea账号SSO-环境变更-全员.md new file mode 100644 index 0000000..8776c1c --- /dev/null +++ b/changelogs-v2/2026-06/12_测试服API文档站登录改Gitea账号SSO-环境变更-全员.md @@ -0,0 +1,25 @@ +# 【环境变更·全员】测试服 API 文档站(doc.html)登录改 Gitea 账号 SSO——登录一次 30 天免登录 + +> 站点:https://api.test.1814.love:9443/doc.html | 生效:2026-06-12 | 无 PR(测试服 nginx + oauth2-proxy 配置变更,不涉及业务代码) +> 已端到端实测:Gitea 登录→授权→文档加载→二次访问纯 Cookie 免登录 + +## ⚠️ 关键说明 + +1. **文档站专用账号(hulalv)停用**:访问 doc.html 不再弹浏览器账号密码框,改为跳转 Gitea 登录页,**用你自己的 Gitea(git.1814.love)账号登录**。 +2. **浏览器已登录 Gitea 的话全程无感**:直接跳回文档页,一个键都不用按。 +3. **首次使用会出现一次「授权 knife4j-api-docs-sso 访问您的帐户?」确认页**:点「应用授权」即可,每个账号只出现这一次。 +4. **登录一次 30 天免登录**(Cookie 有效期 720h,期间自动静默续期),浏览器重启也不用重新登录。 +5. **API 调用本身零影响**:/admin/、/mp/、/v3/ 等接口的认证方式不变,仅 doc.html、/webjars/、/v2/api-docs、/swagger-resources 四个文档路径换了认证。 + +## 1. 行为对照 + +| 场景 | 旧 | 新 | +|---|---|---| +| 打开 doc.html | 浏览器弹 Basic Auth 框,输文档专用账号 | 跳 Gitea 登录页(已登录 Gitea 则无感直进) | +| 浏览器重启后 | 重新弹框输密码 | Cookie 30 天内免登录 | +| 账号管理 | 共享一个 hulalv 账号 | 各自 Gitea 账号(cz/liutao/mmg/wx/yst 均可用) | + +## 2. 遇到问题 + +- 跳转后 Gitea 登录不上:确认用的是 git.1814.love 的账号密码(忘记密码可在 Gitea 页面重置)。 +- 登录后报错或循环跳转:联系 wx(服务端 oauth2-proxy 日志可查)。