SHA256
forked from course-team/tjhlp-gitea
feat: 登录页改为「统一身份认证」优先 + 独立的「管理员登录」卡片
整文件覆盖 templates/user/auth/signin.tmpl(基线已进 upstream/):
- 第一张卡: 站名 + 说明文字 + 认证源按钮。按钮部分仍复用上游的
{{template "user/auth/external_auth_methods" .}}, 所以换/加认证源不用改模板
- 第二张卡: 「管理员登录」, 正文写明此入口仅管理员与助教使用(本地账号),
同学们请走统一身份认证 —— 避免同学拿学号去试用户名/密码
- 不再渲染 passkey 区块; 表单字段/验证码/忘记密码/记住设备/注册入口保持上游逻辑,
仅去掉 autofocus(避免聚焦到次要卡片), 实测登录与报错提示均正常
配套:
- preview.sh check 增加登录页断言(有管理员卡片、无通行密钥方框), 现 15 项全过
- README 新增 3.4 登录页(含「预览里临时加认证源」的做法)、目录树与已验证清单
This commit is contained in:
+27
-1
@@ -69,6 +69,8 @@ Gitea 把模板 / 语言 / 静态资源都编进了二进制,但读取时走 `as
|
|||||||
| meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 |
|
| meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 |
|
||||||
| 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` |
|
| 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` |
|
||||||
| 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` |
|
| 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` |
|
||||||
|
| 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` |
|
||||||
|
| 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` |
|
||||||
| Logo / favicon | 放 `custom/public/assets/img/{logo,favicon}.svg` 等 | 同上(文件方式) |
|
| Logo / favicon | 放 `custom/public/assets/img/{logo,favicon}.svg` 等 | 同上(文件方式) |
|
||||||
|
|
||||||
> 环境变量规则:`GITEA__<段名>__<键名>`,段名里的 `.` 不能直接写,要编码成
|
> 环境变量规则:`GITEA__<段名>__<键名>`,段名里的 `.` 不能直接写,要编码成
|
||||||
@@ -103,6 +105,7 @@ customization/
|
|||||||
├── custom/ ★ 挂进容器的覆盖层(= $CustomPath 的内容)
|
├── custom/ ★ 挂进容器的覆盖层(= $CustomPath 的内容)
|
||||||
│ ├── templates/home.tmpl 落地页
|
│ ├── templates/home.tmpl 落地页
|
||||||
│ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com)
|
│ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com)
|
||||||
|
│ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要)
|
||||||
│ ├── public/assets/tjhlp/ask-guide.html 静态「提问指南」页(/assets/tjhlp/...)
|
│ ├── public/assets/tjhlp/ask-guide.html 静态「提问指南」页(/assets/tjhlp/...)
|
||||||
│ └── options/locale/locale_zh-CN.json 生成物,已 gitignore
|
│ └── options/locale/locale_zh-CN.json 生成物,已 gitignore
|
||||||
└── preview/ 本地预览(独立 compose,独立端口/数据)
|
└── preview/ 本地预览(独立 compose,独立端口/数据)
|
||||||
@@ -165,6 +168,27 @@ customization/preview/preview.sh reset # 清空预览数据重新来
|
|||||||
- **模板改动仍需重启**(`reload`),这是 Gitea 的既有行为。
|
- **模板改动仍需重启**(`reload`),这是 Gitea 的既有行为。
|
||||||
- 需要 docker 权限;当前 shell 不在 docker 组时脚本会自动改用 `sg docker -c`。
|
- 需要 docker 权限;当前 shell 不在 docker 组时脚本会自动改用 `sg docker -c`。
|
||||||
|
|
||||||
|
### 3.4 登录页
|
||||||
|
|
||||||
|
登录页 `custom/templates/user/auth/signin.tmpl` 的结构是「统一身份认证(第一张卡) +
|
||||||
|
管理员登录(第二张卡)」,认证源那部分直接复用上游的
|
||||||
|
`{{template "user/auth/external_auth_methods" .}}`,所以**换认证源不用改模板**。
|
||||||
|
|
||||||
|
预览实例默认没有配置任何认证源,登录页就只显示管理员卡片。想看到统一身份认证那张卡,
|
||||||
|
临时加一个认证源即可(用完删掉):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 加: 用 github 这类不需要 discovery 的 provider 最省事, 只为看布局
|
||||||
|
sg docker -c "docker exec -u git gitea-preview gitea admin auth add-oauth \
|
||||||
|
--name '高程统一身份认证(测试)' --provider github --key k --secret s"
|
||||||
|
sg docker -c 'docker exec -u git gitea-preview gitea admin auth list' # 看 ID
|
||||||
|
sg docker -c 'docker exec -u git gitea-preview gitea admin auth delete --id 1'
|
||||||
|
```
|
||||||
|
|
||||||
|
**通行密钥(WebAuthn)已关闭**,不是靠模板删的,而是配置:
|
||||||
|
`[service] ENABLE_PASSKEY_AUTHENTICATION = false`(两处 compose 都设了)。
|
||||||
|
上游那块在浏览器不支持条件中介时会渲染成一个空的方框,关掉配置连区块都不再输出。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 4. 纳入当前项目 & 部署
|
## 4. 纳入当前项目 & 部署
|
||||||
@@ -295,10 +319,12 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke
|
|||||||
- ✅ `custom/public/assets/tjhlp/ask-guide.html` 经 `/assets/` 正常访问
|
- ✅ `custom/public/assets/tjhlp/ask-guide.html` 经 `/assets/` 正常访问
|
||||||
- ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」
|
- ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」
|
||||||
- ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启)
|
- ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启)
|
||||||
|
- ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错
|
||||||
|
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
||||||
|
|
||||||
尚未覆盖(需要时按同样套路加):
|
尚未覆盖(需要时按同样套路加):
|
||||||
|
|
||||||
- Logo / favicon 换成本课程的图(需要设计稿;放到 `custom/public/assets/img/`)
|
- Logo / favicon 换成本课程的图(需要设计稿;放到 `custom/public/assets/img/`)
|
||||||
- 登录页、注册页、错误页文案
|
- 注册页(`user/auth/signup.tmpl`)、错误页文案
|
||||||
- 更多术语(合并请求 / 仓库 / 里程碑…)—— 在 `overrides/` 里加规则即可
|
- 更多术语(合并请求 / 仓库 / 里程碑…)—— 在 `overrides/` 里加规则即可
|
||||||
- 自定义主题配色(`[ui] THEMES` + `custom/public/assets/css/theme-*.css`)
|
- 自定义主题配色(`[ui] THEMES` + `custom/public/assets/css/theme-*.css`)
|
||||||
|
|||||||
@@ -0,0 +1,92 @@
|
|||||||
|
{{/*
|
||||||
|
登录页, 整文件覆盖 Gitea 内置 templates/user/auth/signin.tmpl。
|
||||||
|
|
||||||
|
维护约定:
|
||||||
|
* 上游基线: customization/upstream/<版本>/templates/user/auth/signin.tmpl
|
||||||
|
升级 Gitea 时先 diff 基线, 把上游的结构性改动(新增表单字段/新认证方式)合并回来。
|
||||||
|
* 相对上游的改动只有布局, 逻辑尽量原样搬过来:
|
||||||
|
1) 课程同学走的是「高程统一身份认证」(OIDC), 所以把它放进第一张卡片、配说明文字;
|
||||||
|
卡片正文复用上游的 {{template "user/auth/external_auth_methods" .}},
|
||||||
|
将来新增/更换认证源不用改这个模板。
|
||||||
|
2) 用户名/密码降级为第二张「管理员登录」卡片, 并在正文里写明只有管理员/助教用。
|
||||||
|
3) 不再渲染通行密钥(passkey)区块 —— 上游那块只有 tw-hidden 的元素, 浏览器不支持
|
||||||
|
条件中介时会留下一个空的方框; 服务端已用
|
||||||
|
[service] ENABLE_PASSKEY_AUTHENTICATION = false 关掉该功能。
|
||||||
|
* 只用 Gitea 已编译进 CSS 的 class: Tailwind 工具类是按上游模板裁剪过的,
|
||||||
|
新增 tw-* 前先 grep assets/css/index.css 确认存在(否则不会生效)。
|
||||||
|
* 文案直接写中文(平台只面向中文用户), 表单标签仍走 ctx.Locale.Tr 以便跟随语言设置。
|
||||||
|
*/}}
|
||||||
|
{{template "base/head" .}}
|
||||||
|
<div role="main" aria-label="{{.Title}}" class="page-content user signin">
|
||||||
|
<div class="ui middle very relaxed page grid">
|
||||||
|
{{/* 这些样式与内置模板保持一致, 同时作用于登录/注册/绑定账号页 */}}
|
||||||
|
<div class="column tw-flex tw-flex-col tw-gap-4 tw-max-w-2xl tw-m-auto">
|
||||||
|
<div class="ui container fluid">
|
||||||
|
{{template "base/alert" .}}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{{$hasExternalAuth := or .OAuth2Providers .EnableOpenIDSignIn .EnableSSPI}}
|
||||||
|
{{if $hasExternalAuth}}
|
||||||
|
<div class="ui container fluid">
|
||||||
|
<h4 class="ui top attached header center">登录 {{AppName}}</h4>
|
||||||
|
<div class="ui attached segment">
|
||||||
|
<p class="tw-text-center tw-m-0">
|
||||||
|
同学们请使用<strong>高程统一身份认证</strong>登录, 账号密码与文档作业网站、编程作业网站相同。
|
||||||
|
</p>
|
||||||
|
{{template "user/auth/external_auth_methods" .}}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{end}}
|
||||||
|
|
||||||
|
{{if .EnablePasswordSignInForm}}
|
||||||
|
<div class="ui container fluid">
|
||||||
|
<h4 class="ui top attached header center">管理员登录</h4>
|
||||||
|
<div class="ui attached segment">
|
||||||
|
<p class="tw-text-center tw-m-0 tw-text-sm">
|
||||||
|
此入口仅管理员与助教使用(本地账号)。同学们请使用上方的高程统一身份认证登录。
|
||||||
|
</p>
|
||||||
|
<form class="ui form" action="{{.SignInLink}}" method="post">
|
||||||
|
<div class="required field {{if .Err_UserName}}error{{end}}">
|
||||||
|
<label for="user_name">{{ctx.Locale.Tr "home.uname_holder"}}</label>
|
||||||
|
<input id="user_name" type="text" name="user_name" value="{{.user_name}}" required tabindex="1">
|
||||||
|
</div>
|
||||||
|
{{if not .DisablePassword}}
|
||||||
|
<div class="required field {{if .Err_Password}}error{{end}}">
|
||||||
|
<div class="tw-flex tw-mb-1">
|
||||||
|
<label for="password" class="tw-flex-1">{{ctx.Locale.Tr "password"}}</label>
|
||||||
|
<a href="{{AppSubUrl}}/user/forgot_password" tabindex="4">{{ctx.Locale.Tr "auth.forgot_password"}}</a>
|
||||||
|
</div>
|
||||||
|
<input id="password" name="password" type="password" value="{{.password}}" autocomplete="current-password" required tabindex="2">
|
||||||
|
</div>
|
||||||
|
{{end}}
|
||||||
|
<div class="inline field">
|
||||||
|
<div class="ui checkbox">
|
||||||
|
<label>{{ctx.Locale.Tr "auth.remember_me"}}</label>
|
||||||
|
<input name="remember" type="checkbox" tabindex="5">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{{template "user/auth/captcha" .}}
|
||||||
|
|
||||||
|
<div class="field">
|
||||||
|
<button class="ui primary button tw-w-full" tabindex="3">
|
||||||
|
{{ctx.Locale.Tr "sign_in"}}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{end}}
|
||||||
|
|
||||||
|
{{if .ShowRegistrationButton}}
|
||||||
|
<div class="ui container fluid">
|
||||||
|
<div class="ui attached segment tw-text-center">
|
||||||
|
<span>{{ctx.Locale.Tr "auth.need_account"}}</span>
|
||||||
|
<a href="{{AppSubUrl}}/user/sign_up">{{ctx.Locale.Tr "auth.sign_up_now"}}</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{end}}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{template "base/footer" .}}
|
||||||
@@ -126,6 +126,17 @@ check)
|
|||||||
! grep -q "工单" "${ROOT}/custom/options/locale/locale_zh-CN.json" &&
|
! grep -q "工单" "${ROOT}/custom/options/locale/locale_zh-CN.json" &&
|
||||||
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
||||||
|
|
||||||
|
# --- 登录页 -----------------------------------------------------------
|
||||||
|
login="$(mktemp)"
|
||||||
|
curl -fsS -H 'Accept-Language: zh-CN' "${BASE_URL}/user/login" -o "${login}"
|
||||||
|
grep -q "管理员登录" "${login}" &&
|
||||||
|
ok "登录页有独立的「管理员登录」卡片" || bad "登录页缺少管理员登录卡片"
|
||||||
|
! grep -q "webauthn-error\|signin-passkey" "${login}" &&
|
||||||
|
ok "登录页已无空的通行密钥(WebAuthn)方框" || bad "登录页仍有通行密钥区块"
|
||||||
|
grep -q 'id="external-login-navigator"' "${login}" ||
|
||||||
|
echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)"
|
||||||
|
rm -f "${login}"
|
||||||
|
|
||||||
[ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项"
|
[ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项"
|
||||||
exit "${fail}"
|
exit "${fail}"
|
||||||
;;
|
;;
|
||||||
|
|||||||
@@ -7,3 +7,4 @@
|
|||||||
options/locale/locale_zh-CN.json
|
options/locale/locale_zh-CN.json
|
||||||
templates/home.tmpl
|
templates/home.tmpl
|
||||||
templates/base/head_navbar.tmpl
|
templates/base/head_navbar.tmpl
|
||||||
|
templates/user/auth/signin.tmpl
|
||||||
|
|||||||
@@ -0,0 +1,10 @@
|
|||||||
|
{{template "base/head" .}}
|
||||||
|
<div role="main" aria-label="{{.Title}}" class="page-content user signin{{if .LinkAccountMode}} icon{{end}}">
|
||||||
|
<div class="ui middle very relaxed page grid">
|
||||||
|
{{/* these styles are quite tricky and should also apply to the signup and link_account pages */}}
|
||||||
|
<div class="column tw-flex tw-flex-col tw-gap-4 tw-max-w-2xl tw-m-auto">
|
||||||
|
{{template "user/auth/signin_inner" .}}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{template "base/footer" .}}
|
||||||
Reference in New Issue
Block a user