Files
sso/source/www/admin.html
T
ssw c8a02b8c49 feat: 从网关项目剥离为独立 SSO 统一认证服务
定位:身份层(IdP + IAP),不含动态域名转发 / LLM 上游代理 / 用量计费。

代码(source/rust,nginx 动态模块 + Rust,单进程零外部依赖)
- IdP:authorization_code(含 PKCE)/ refresh_token / client_credentials / password
  四种 grant,含 discovery / introspect / userinfo / jwks 占位
- IAP:access 阶段门禁,注入 X-Auth-* 到后端,客户端伪造同名头被覆盖
- MaxKey 互通:/oauth/v20/* 与 /oauth2.0/* 别名 + context-path 归一化 + 扁平字段
- 管理接口:账号(含角色/部门/用户组)与 OAuth 接入方注册表,热写穿共享内存
- 模块改名 ngx_http_sso_module,指令 sso_state / sso_data_dir / sso_api / sso_iap,
  Cookie sso_sid(终端用户)与 sso_admin_session(管理员)两套身份两套会话

配置(source/conf)
- nginx.conf 生产模板(TLS、IAP 子域、含 auth_sub 的日志格式)
- nginx.test.conf 本机验证配置(明文 18095-18099)
- tls/README.md 证书约定与公钥比对校验

前端(source/www/admin.html)
- 三 tab:账号管理 / 接入方 / 接入指南;去掉审核队列、域名、LLM 上游、用量统计

测试与脚本
- tests/ 三套端到端:协议基线 14 项 · MaxKey 互通与接入 24 项 · 管理接口 31 项,全绿
- tests/demo-system 演示业务系统(Python 标准库),覆盖应用自建客户端与 IAP 零改造两种姿势
- scripts/run-local-e2e.sh 本机一键起停;scripts/seed-data.sh 物化运行时数据目录

文档
- README.md 概览与快速开始;CLAUDE.md 硬约定与排障速查
- docs/design.md 完整设计;docs/roadmap.md 待执行任务(v2 RS256+JWKS、用户管理界面)
2026-09-12 21:42:06 +08:00

827 lines
38 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>统一认证 · 管理台</title>
<style>
:root{
--bg:#f5f7fa; --panel:#ffffff; --border:#e3e8ef; --border-strong:#cbd5e1;
--text:#1f2937; --muted:#6b7280; --accent:#2563eb; --accent-hover:#1d4ed8;
--ok-bg:#e7f6ec; --ok-fg:#15803d;
--warn-bg:#fef3c7; --warn-fg:#92400e;
--err-bg:#fdecec; --err-fg:#b91c1c;
--gray-bg:#eef1f5; --gray-fg:#6b7280;
--radius:8px;
}
*{box-sizing:border-box}
/* [hidden] 的 display:none 来自 UA 样式表,任何 author 样式里的 display 都会盖掉它
(下面 .login-wrap 就设了 display:flex),必须显式兜底,否则隐藏不生效 */
[hidden]{display:none !important}
html,body{margin:0;padding:0}
body{
background:var(--bg); color:var(--text); font-size:14px; line-height:1.6;
font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif;
}
code,.mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12.5px}
/* ---------- 登录 ---------- */
.login-wrap{min-height:100vh;display:flex;align-items:center;justify-content:center;padding:24px}
.login-card{width:100%;max-width:380px;background:var(--panel);border:1px solid var(--border);
border-radius:12px;padding:32px 28px;box-shadow:0 8px 28px rgba(15,23,42,.07)}
.login-card h1{font-size:17px;margin:0 0 4px}
.login-card .sub{color:var(--muted);font-size:12.5px;margin-bottom:24px}
.login-card .hint{margin-top:18px;padding-top:14px;border-top:1px dashed var(--border);
color:var(--muted);font-size:12px}
/* ---------- 通用控件 ---------- */
label{display:block;font-size:12.5px;color:var(--muted);margin:0 0 6px}
input[type=text],input[type=password],select{
width:100%;padding:9px 11px;border:1px solid var(--border-strong);border-radius:var(--radius);
background:#fff;color:var(--text);font-size:13.5px;outline:none;transition:border-color .15s,box-shadow .15s}
input:focus,select:focus{border-color:var(--accent);box-shadow:0 0 0 3px rgba(37,99,235,.12)}
input[readonly]{background:#f8fafc;color:var(--muted)}
button{font-family:inherit;font-size:13px;padding:8px 14px;border-radius:var(--radius);cursor:pointer;
border:1px solid var(--border-strong);background:#fff;color:var(--text);transition:.15s;white-space:nowrap}
button:hover{border-color:var(--muted)}
button:disabled{opacity:.5;cursor:not-allowed}
.btn-primary{background:var(--accent);border-color:var(--accent);color:#fff}
.btn-primary:hover{background:var(--accent-hover);border-color:var(--accent-hover)}
.btn-sm{padding:4px 10px;font-size:12px}
.btn-danger{color:var(--err-fg);border-color:#f3c6c6}
.btn-danger:hover{background:var(--err-bg);border-color:var(--err-fg)}
.btn-ok{color:var(--ok-fg);border-color:#bfe3cb}
.btn-ok:hover{background:var(--ok-bg);border-color:var(--ok-fg)}
.btn-block{width:100%;justify-content:center}
.field{margin-bottom:14px}
/* ---------- 布局 ---------- */
.topbar{background:var(--panel);border-bottom:1px solid var(--border);padding:0 24px;
display:flex;align-items:center;justify-content:space-between;height:58px;position:sticky;top:0;z-index:10}
.brand{display:flex;align-items:baseline;gap:10px}
.brand b{font-size:15px}
.brand span{color:var(--muted);font-size:12.5px}
.user-box{display:flex;align-items:center;gap:12px;font-size:13px;color:var(--muted)}
.wrap{max-width:1180px;margin:0 auto;padding:22px 24px 60px}
.stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:14px;margin-bottom:20px}
.stat{background:var(--panel);border:1px solid var(--border);border-radius:var(--radius);padding:14px 16px}
.stat .k{color:var(--muted);font-size:12.5px}
.stat .v{font-size:24px;font-weight:600;margin-top:2px}
.tabs{display:flex;gap:6px;border-bottom:1px solid var(--border);margin-bottom:18px}
.tab{padding:9px 4px;margin-right:20px;border:0;background:none;border-bottom:2px solid transparent;
color:var(--muted);font-size:14px;border-radius:0}
.tab:hover{color:var(--text)}
.tab.active{color:var(--accent);border-bottom-color:var(--accent);font-weight:600}
.panel{background:var(--panel);border:1px solid var(--border);border-radius:var(--radius);padding:18px 20px;margin-bottom:18px}
.panel h2{font-size:14px;margin:0 0 4px}
.panel .desc{color:var(--muted);font-size:12.5px;margin-bottom:16px}
.grid-form{display:grid;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:12px;align-items:end}
/* 跨整行:给长字符串字段用。默认 auto-fit 在宽面板里会排成 6 列,
每格只剩 ~170px —— 回调地址 / 密钥根本显示不全 */
.span-all{grid-column:1/-1}
/* 表单里短字段两列、长字段独占整行;窄屏收成一列 */
.grid-form.two{grid-template-columns:repeat(2,1fr)}
@media (max-width:600px){.grid-form.two{grid-template-columns:1fr}}
input.field-mono,textarea.field-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12.5px}
/* 回调地址很长且没有空格,允许折行,避免把表格撑破 */
td.wrap-cell{word-break:break-all}
table{width:100%;border-collapse:collapse;font-size:13px}
th{text-align:left;color:var(--muted);font-weight:500;font-size:12.5px;padding:9px 10px;
border-bottom:1px solid var(--border);white-space:nowrap}
td{padding:11px 10px;border-bottom:1px solid #f1f4f8;vertical-align:middle}
tr:last-child td{border-bottom:0}
tbody tr:hover{background:#fafbfd}
.empty{text-align:center;color:var(--muted);padding:34px 0 !important;font-size:13px}
.badge{display:inline-block;padding:2px 8px;border-radius:20px;font-size:12px;line-height:18px;white-space:nowrap}
.b-ok{background:var(--ok-bg);color:var(--ok-fg)}
.b-warn{background:var(--warn-bg);color:var(--warn-fg)}
.b-err{background:var(--err-bg);color:var(--err-fg)}
.b-gray{background:var(--gray-bg);color:var(--gray-fg)}
.b-blue{background:#e6efff;color:#1d4ed8}
.row-actions{display:flex;gap:6px;flex-wrap:wrap}
.key-cell{display:flex;align-items:center;gap:6px}
.muted{color:var(--muted)}
.nowrap{white-space:nowrap}
.checkbox{display:flex;align-items:center;gap:8px;font-size:13px;color:var(--text);padding-bottom:9px}
.checkbox input{width:16px;height:16px;accent-color:var(--accent)}
/* 多选组:横向排开,窄屏自行折行 */
.chk-row{display:flex;gap:18px;flex-wrap:wrap;padding-bottom:9px}
.chk-row .checkbox{padding-bottom:0}
textarea{width:100%;padding:9px 11px;border:1px solid var(--border-strong);border-radius:var(--radius);
background:#fff;color:var(--text);font-size:13.5px;outline:none;resize:vertical;
transition:border-color .15s,box-shadow .15s}
textarea:focus{border-color:var(--accent);box-shadow:0 0 0 3px rgba(37,99,235,.12)}
/* 接入指南里的配置片段:长行横向滚动,不撑破面板 */
pre{background:#f7f9fc;border:1px solid var(--border);border-radius:var(--radius);
padding:12px 14px;overflow:auto;margin:0;font-size:12.5px;line-height:1.65}
pre code{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
ol.steps{margin:0;padding-left:20px;color:var(--text);font-size:13px}
ol.steps li{margin-bottom:8px}
ol.steps code{background:#f1f4f8;padding:1px 5px;border-radius:4px}
#toast{position:fixed;top:20px;left:50%;transform:translateX(-50%) translateY(-16px);
background:#111827;color:#fff;padding:10px 18px;border-radius:var(--radius);font-size:13px;
opacity:0;pointer-events:none;transition:.22s;z-index:99;max-width:70vw}
#toast.show{opacity:1;transform:translateX(-50%) translateY(0)}
#toast.err{background:#b91c1c}
.err-msg{color:var(--err-fg);font-size:12.5px;margin-top:10px;min-height:18px}
</style>
</head>
<body>
<!-- ==================== 登录 ==================== -->
<div id="loginView" class="login-wrap">
<form class="login-card" id="loginForm">
<h1>统一认证</h1>
<div class="sub">SSO 网关管理控制台 · 仅管理员可登录</div>
<div class="field">
<label for="loginUser">管理员账号</label>
<input id="loginUser" type="text" autocomplete="username" placeholder="admin" required>
</div>
<div class="field">
<label for="loginPass">密码</label>
<input id="loginPass" type="password" autocomplete="current-password" placeholder="请输入密码" required>
</div>
<button class="btn-primary btn-block" type="submit" id="loginBtn">登 录</button>
<div class="err-msg" id="loginErr"></div>
<div class="hint">初始账号为 <code>admin</code>,首次登录后请在「账号管理」中修改密码。</div>
</form>
</div>
<!-- ==================== 管理台 ==================== -->
<div id="appView" hidden>
<div class="topbar">
<div class="brand">
<b>统一认证</b>
<span>SSO 网关管理控制台</span>
</div>
<div class="user-box">
<span id="whoami">-</span>
<button class="btn-sm" id="refreshBtn">刷新</button>
<button class="btn-sm btn-danger" id="logoutBtn">退出</button>
</div>
</div>
<div class="wrap">
<div class="stats">
<div class="stat"><div class="k">账号总数</div><div class="v" id="statUsers">-</div></div>
<div class="stat"><div class="k">管理员</div><div class="v" id="statAdmins">-</div></div>
<div class="stat"><div class="k">OAuth 接入方</div><div class="v" id="statClients">-</div></div>
<div class="stat"><div class="k">部门</div><div class="v" id="statDepts">-</div></div>
<div class="stat"><div class="k">用户组</div><div class="v" id="statGroups">-</div></div>
</div>
<div class="tabs">
<button class="tab active" data-tab="accounts">账号管理</button>
<button class="tab" data-tab="oauth">OAuth 应用</button>
<button class="tab" data-tab="guide">接入指南</button>
</div>
<!-- ---------- 账号管理 ---------- -->
<section id="tab-accounts">
<div class="panel">
<h2>新建账号</h2>
<div class="desc">账号是统一认证的「主体」:邮箱 / 部门 / 用户组会成为 OIDC 声明,并经 IAP 注入为
<code>X-Auth-*</code> 请求头交给下游系统做授权判断。每个账号同时自动生成一个 API Key,供脚本类调用方走
<code>/api/v1/*</code> 使用。</div>
<form id="createUserForm" class="grid-form">
<div><label for="cuName">账号名</label><input id="cuName" type="text" placeholder="zhangsan" required></div>
<div><label for="cuDisplay">展示名(中文姓名,可空)</label><input id="cuDisplay" type="text" placeholder="张三"></div>
<div><label for="cuPass">初始密码</label><input id="cuPass" type="text" placeholder="至少 6 位" required></div>
<div>
<label for="cuRole">角色</label>
<select id="cuRole">
<option value="user">普通账号</option>
<option value="admin">管理员</option>
</select>
</div>
<div><label for="cuEmail">邮箱(OIDC email)</label><input id="cuEmail" class="field-mono" type="text" placeholder="[email protected]"></div>
<div><label for="cuDept">部门</label><input id="cuDept" type="text" placeholder="研发部"></div>
<div class="span-all"><label for="cuGroups">用户组(逗号 / 顿号分隔,如 rd,eng)</label><input id="cuGroups" class="field-mono" type="text" placeholder="rd, eng"></div>
<div><button class="btn-primary btn-block" type="submit">创建账号</button></div>
</form>
</div>
<div class="panel">
<h2>账号列表</h2>
<div class="desc">API Key 完整值在创建时展示一次;此处可复制或重置。角色的「部门 / 用户组 / 邮箱」列由账号数据直出——
在线编辑这三项的可视化维护是<b>待执行项</b>,当前可用接口 <code>/api/admin/users/profile</code> 与
<code>/api/admin/users/role</code> 直接改(见 <code>docs/roadmap.md</code>)。</div>
<table>
<thead><tr>
<th>账号</th><th>角色</th><th>部门</th><th>用户组</th><th>邮箱</th><th>API Key</th><th>操作</th>
</tr></thead>
<tbody id="usersBody"></tbody>
</table>
</div>
</section>
<!-- ---------- OAuth 应用(统一认证接入方) ---------- -->
<section id="tab-oauth" hidden>
<div class="panel">
<h2>新建 / 更新接入方</h2>
<div class="desc">登记一个第三方应用。机密客户端(服务端应用)持有密钥,用 <code>client_secret</code> 换令牌;
公开客户端(SPA / 移动端)不持有密钥,必须走 PKCE。回调地址必须与申请时传入的 <code>redirect_uri</code>
完全一致,否则授权请求会被拒。</div>
<form id="upsertClientForm" class="grid-form two">
<div><label for="ocId">client_id</label><input id="ocId" class="field-mono" type="text" placeholder="grafana" required></div>
<div><label for="ocName">应用名称</label><input id="ocName" type="text" placeholder="Grafana 监控面板"></div>
<div>
<label for="ocType">客户端类型</label>
<select id="ocType">
<option value="confidential">机密客户端(有密钥,服务端应用)</option>
<option value="public">公开客户端(无密钥,SPA / 移动端,走 PKCE)</option>
</select>
</div>
<div>
<label for="ocSecret">客户端密钥(留空 = 自动生成 / 不修改)</label>
<input id="ocSecret" class="field-mono" type="text" placeholder="留空即可" autocomplete="off">
</div>
<div class="span-all">
<label for="ocRedirects">回调地址(一行一个,必须是 http(s) 绝对地址)</label>
<textarea id="ocRedirects" rows="2" class="field-mono" placeholder="https://grafana.example.com/login/generic_oauth"></textarea>
</div>
<div class="span-all">
<label>授权类型</label>
<div class="chk-row">
<span class="checkbox"><input type="checkbox" id="ocGCode" checked><label for="ocGCode">authorization_code</label></span>
<span class="checkbox"><input type="checkbox" id="ocGRefresh" checked><label for="ocGRefresh">refresh_token</label></span>
<span class="checkbox"><input type="checkbox" id="ocGCred"><label for="ocGCred">client_credentials</label></span>
<span class="checkbox"><input type="checkbox" id="ocGPass"><label for="ocGPass">password</label></span>
</div>
</div>
<div class="span-all">
<label for="ocScopes">scope(空格或逗号分隔)</label>
<input id="ocScopes" class="field-mono" type="text" value="openid profile email">
</div>
<div><button class="btn-primary btn-block" type="submit">保存接入方</button></div>
<div><button type="button" class="btn-block" id="ocClearBtn">清空表单(改回新建)</button></div>
</form>
</div>
<div class="panel">
<h2>接入方列表</h2>
<div class="desc">保存后立即生效,无需重启网关。删除不可恢复:指向该 <code>client_id</code> 的授权请求会立即变成
「客户端不存在」,已签发的令牌在过期前仍然有效。</div>
<table>
<thead><tr>
<th>client_id</th><th>名称</th><th>类型</th><th>回调地址</th><th>授权类型 / scope</th><th>客户端密钥</th><th>创建时间</th><th>操作</th>
</tr></thead>
<tbody id="oauthClientsBody"></tbody>
</table>
</div>
</section>
<!-- ---------- 接入指南 ---------- -->
<section id="tab-guide" hidden>
<div class="panel">
<h2>统一认证端点</h2>
<div class="desc">网关自带 OAuth2 / OIDC 授权服务器。第三方应用按「标准 / OIDC」一列对接即可;
「MaxKey 兼容」一列是给那些照抄 MaxKey 文档配好了 URL 的应用准备的别名:路径不同,响应格式对齐 MaxKey
(令牌为裸对象、用户信息扁平字段),改一处地址就能切过来。</div>
<table>
<thead><tr><th>用途</th><th>标准 / OIDC</th><th>MaxKey 兼容</th></tr></thead>
<tbody id="oauthEndpointsBody"></tbody>
</table>
</div>
<div class="panel">
<h2>接入方式一:应用自己做 OAuth2 客户端</h2>
<div class="desc">适合 Grafana、GitLab、自研 Web 应用这类本身就支持 OIDC 的系统。它们只关心三件事:
Discovery 地址、client_id、client_secret(公开客户端用 PKCE 代替)。</div>
<ol class="steps">
<li>在「OAuth 应用」页新建接入方,填好回调地址与 scope,复制返回的客户端密钥。</li>
<li>把应用的 OIDC 配置指向 <code id="guideDiscovery">/.well-known/openid-configuration</code>,
或分别填授权 / 令牌 / 用户信息三个端点。</li>
<li>首次访问时应用会把浏览器送到授权端点;网关侧未登录会让用户登录,登录成功后带
<code>code</code> 回跳,应用用 code 换令牌。</li>
<li>令牌是 JWT(HS256)。校验方式二选一:调 <code>/oauth/introspect</code>(需客户端鉴权),
或对 id_token 用 <code>client_secret</code> 本地验签。</li>
</ol>
</div>
<div class="panel">
<h2>接入方式二:IAP 零改造接入</h2>
<div class="desc">应用完全不写认证代码,只读网关注入的请求头。适合内部系统、遗留系统。网关在 access 阶段
完成门禁:无身份直接 401 并由 <code>error_page</code> 跳登录页;有身份则注入五个头,且<b>覆盖</b>客户端伪造的同名头。</div>
<pre><code>location / {
sso_iap on; # 开启身份感知代理
proxy_pass http://127.0.0.1:8080; # 你的应用
proxy_set_header Host $host;
# 身份注入:客户端自己发的这几个头会被覆盖
proxy_set_header X-Auth-User $auth_user; # 登录账号
proxy_set_header X-Auth-Sub $auth_sub; # OIDC sub(同 User)
proxy_set_header X-Auth-Email $auth_email;
proxy_set_header X-Auth-Groups $auth_groups; # 逗号分隔的用户组
proxy_set_header X-Auth-Token $auth_token; # 可再次验签的 access_token
error_page 401 = @oauth_login; # 未登录 → 跳统一登录页并回跳
}
location @oauth_login {
return 302 "https://sso.example.com/login?redirect=$scheme://$host$request_uri";
}</code></pre>
<div class="desc" style="margin-top:14px">注意:注入头只在经过网关的请求上可信。应用若可被直连(绕过网关),
任何人都能伪造这几个头——生产上必须让应用只监听内网,或只接受来自网关的连接。</div>
</div>
<div class="panel">
<h2>跨子域 SSO</h2>
<div class="desc">同一个 SSO 会话要给多个子站用(<code>a.example.com</code>、<code>b.example.com</code>),
必须把 SSO Cookie 的 Domain 设成带点的父域,否则第二个站点拿不到 Cookie,表现为「刚登录又被弹回登录页」。</div>
<pre><code>env OAUTH_COOKIE_DOMAIN; # nginx 会剥掉环境变量,必须显式声明
export OAUTH_COOKIE_DOMAIN=.example.com
export OAUTH_SIGNING_SECRET=$(openssl rand -hex 32) # 生产必设;不设则每次重启令牌全失效
export OAUTH_ISSUER=https://sso.example.com</code></pre>
</div>
</section>
</div>
</div>
<div id="toast"></div>
<script>
(function () {
"use strict";
var state = { me: null, users: [], departments: [], groups: [], oauthClients: [], endpoints: {} };
function arr(v) { return Array.isArray(v) ? v : []; }
// ---------------- 基础设施 ----------------
function $(id) { return document.getElementById(id); }
function esc(v) {
if (v === null || v === undefined) return "";
return String(v).replace(/[&<>"']/g, function (c) {
return ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c];
});
}
function toast(msg, isErr) {
var el = $("toast");
el.textContent = msg;
el.className = "show" + (isErr ? " err" : "");
clearTimeout(el._t);
el._t = setTimeout(function () { el.className = ""; }, 2800);
}
function api(method, path, body) {
var opt = { method: method, credentials: "same-origin", headers: {} };
if (body) {
opt.headers["Content-Type"] = "application/json";
opt.body = JSON.stringify(body);
}
return fetch(path, opt).then(function (res) {
return res.json().catch(function () { return { code: res.status, msg: "响应解析失败" }; })
.then(function (data) {
if (res.status === 401 && path.indexOf("/login") === -1) {
showLogin();
throw new Error(data.msg || "会话已过期,请重新登录");
}
if (!res.ok) throw new Error(data.msg || ("请求失败 HTTP " + res.status));
return data;
});
});
}
function copyText(text, okMsg) {
if (navigator.clipboard && navigator.clipboard.writeText) {
navigator.clipboard.writeText(text).then(function () { toast(okMsg || "已复制"); },
function () { window.prompt("手动复制:", text); });
} else {
window.prompt("手动复制:", text);
}
}
// ---------------- 登录 / 登出 ----------------
function showLogin() {
state.me = null;
$("appView").hidden = true;
$("loginView").hidden = false;
$("loginPass").value = "";
}
function showApp(me) {
state.me = me;
$("loginView").hidden = true;
$("appView").hidden = false;
$("whoami").textContent = me.username + " · " + (me.is_admin ? "管理员" : "普通账号");
return loadAll();
}
$("loginForm").addEventListener("submit", function (e) {
e.preventDefault();
var btn = $("loginBtn");
$("loginErr").textContent = "";
btn.disabled = true;
btn.textContent = "登录中…";
api("POST", "/api/admin/login", {
username: $("loginUser").value.trim(),
password: $("loginPass").value
}).then(function (r) {
return showApp(r.data).then(function () { toast("登录成功"); });
}).catch(function (err) {
$("loginErr").textContent = err.message;
}).then(function () {
btn.disabled = false;
btn.textContent = "登 录";
});
});
$("logoutBtn").addEventListener("click", function () {
api("POST", "/api/admin/logout").then(showLogin).catch(showLogin);
});
$("refreshBtn").addEventListener("click", function () { loadAll().then(function () { toast("已刷新"); }); });
// ---------------- 数据加载 ----------------
function loadAll() {
return api("GET", "/api/admin/session").then(function (r) {
state.me = r.data;
$("whoami").textContent = r.data.username + " · " + (r.data.is_admin ? "管理员" : "普通账号");
}).then(function () {
return Promise.all([
api("GET", "/api/admin/users"),
api("GET", "/api/admin/oauth-clients")
]);
}).then(function (res) {
state.users = arr(res[0].data.items);
state.departments = arr(res[0].data.departments);
state.groups = arr(res[0].data.groups);
state.oauthClients = arr(res[1].data.items);
state.endpoints = res[1].data.endpoints || {};
render();
}).catch(function (err) {
toast(err.message, true);
});
}
// ---------------- 渲染 ----------------
function render() {
$("statUsers").textContent = state.users.length;
$("statAdmins").textContent = state.users.filter(function (u) { return u.is_admin; }).length;
$("statClients").textContent = state.oauthClients.length;
$("statDepts").textContent = state.departments.length;
$("statGroups").textContent = state.groups.length;
renderUsers();
renderEndpoints();
renderOAuthClients();
}
function groupsCell(u) {
var gs = arr(u.groups);
if (!gs.length) return "<span class='muted'>-</span>";
return gs.map(function (g) {
return "<span class='badge b-blue' style='margin:0 4px 2px 0'>" + esc(g) + "</span>";
}).join("");
}
function renderUsers() {
var body = $("usersBody");
if (!state.users.length) {
body.innerHTML = '<tr><td colspan="7" class="empty">还没有账号</td></tr>';
return;
}
body.innerHTML = state.users.map(function (u) {
var displayName = u.display_name || "";
return "<tr>" +
"<td><b>" + esc(u.name || u.username) + "</b>" +
"<div class='muted nowrap'>@" + esc(u.username) + " · " + esc(u.created_at_text) + "</div></td>" +
"<td>" + (u.is_admin
? "<span class='badge b-blue'>管理员</span>"
: "<span class='badge b-gray'>普通</span>") + "</td>" +
"<td>" + (u.department ? esc(u.department) : "<span class='muted'>-</span>") + "</td>" +
"<td>" + groupsCell(u) + "</td>" +
"<td class='mono muted wrap-cell'>" + (u.email ? esc(u.email) : "-") + "</td>" +
"<td><div class='key-cell'><code class='mono'>" + esc(u.api_key_masked) + "</code>" +
"<button class='btn-sm' data-act='copy-key' data-key='" + esc(u.api_key) + "'>复制</button>" +
"<button class='btn-sm' data-act='reset-key' data-user='" + esc(u.username) + "'>重置</button>" +
"</div></td>" +
"<td><div class='row-actions'>" +
"<button class='btn-sm' data-act='reset-pass' data-user='" + esc(u.username) + "'>改密码</button>" +
"<button class='btn-sm' data-act='set-display' data-user='" + esc(u.username) + "' data-display='" + esc(displayName) + "'>改展示名</button>" +
"<button class='btn-sm btn-danger' data-act='del-user' data-user='" + esc(u.username) + "'>删除</button>" +
"</div></td>" +
"</tr>";
}).join("");
}
// 端点表:给接入方抄地址用。标准一组给新应用;MaxKey 一组给「照着 MaxKey
// 文档配好了 URL」的应用——路径不同,响应格式已对齐 MaxKey。
function renderEndpoints() {
var ep = state.endpoints || {};
var cell = function (v) {
if (!v) return "<span class='muted'>-</span>";
return "<code class='mono'>" + esc(v) + "</code> " +
"<button class='btn-sm' data-act='copy-text' data-text='" + esc(v) + "'>复制</button>";
};
var rows = [
["发现文档(Discovery)", ep.discovery, ""],
["授权端点", ep.authorize, ep.authorize_v20],
["令牌端点", ep.token, ep.token_v20],
["用户信息", ep.userinfo, ep.profile_v20],
["令牌自省(RFC 7662)", ep.introspect, ""],
["退出登录", ep.logout, ""]
];
$("oauthEndpointsBody").innerHTML = rows.map(function (r) {
return "<tr><td>" + esc(r[0]) + "</td><td>" + cell(r[1]) + "</td><td>" + cell(r[2]) + "</td></tr>";
}).join("");
if (ep.discovery) $("guideDiscovery").textContent = ep.discovery;
}
function renderOAuthClients() {
var body = $("oauthClientsBody");
if (!state.oauthClients.length) {
body.innerHTML = '<tr><td colspan="8" class="empty">还没有登记任何接入方</td></tr>';
return;
}
body.innerHTML = state.oauthClients.map(function (c) {
var redirects = arr(c.redirect_uris);
var redirectCell = redirects.length
? redirects.map(function (u) {
return "<div class='mono muted wrap-cell' style='font-size:12px'>" + esc(u) + "</div>";
}).join("")
: "<span class='muted'>-</span>";
// 授权类型用徽标、scope 用小字接在下面:合成一列后其余列才有呼吸空间
var grants = arr(c.grant_types);
var grantCell = (grants.length
? grants.map(function (g) {
return "<span class='badge b-blue' style='margin:0 4px 2px 0'>" + esc(g) + "</span>";
}).join("")
: "<span class='muted'>-</span>") +
"<div class='muted mono' style='font-size:11.5px;margin-top:2px'>" +
esc(arr(c.scopes).join(" ") || "(未设 scope)") + "</div>";
var keyCell = c.confidential
? "<div class='key-cell'><code class='mono'>" + esc(c.client_secret_masked || "-") + "</code>" +
"<button class='btn-sm' data-act='copy-secret' data-id='" + esc(c.client_id) + "'>复制</button></div>"
: "<span class='badge b-gray'>无密钥(PKCE)</span>";
return "<tr>" +
"<td><b class='mono'>" + esc(c.client_id) + "</b></td>" +
"<td>" + esc(c.name || "-") + "</td>" +
"<td>" + (c.confidential
? "<span class='badge b-blue'>机密</span>"
: "<span class='badge b-gray'>公开</span>") + "</td>" +
"<td>" + redirectCell + "</td>" +
"<td>" + grantCell + "</td>" +
"<td>" + keyCell + "</td>" +
"<td class='muted nowrap'>" + esc(c.created_at_text || "-") + "</td>" +
"<td><div class='row-actions'>" +
"<button class='btn-sm' data-act='edit-client' data-id='" + esc(c.client_id) + "'>编辑</button>" +
(c.confidential
? "<button class='btn-sm btn-ok' data-act='rotate-secret' data-id='" + esc(c.client_id) + "'>重置密钥</button>"
: "") +
"<button class='btn-sm btn-danger' data-act='del-client' data-id='" + esc(c.client_id) + "'>删除</button>" +
"</div></td>" +
"</tr>";
}).join("");
}
// 公开客户端按定义不持有密钥,也不能用 client_credentials / password
// (这两种都要用密钥证明身份)——把不适用的控件直接置灰,别让人填了才发现。
function syncClientTypeUI() {
var isPublic = $("ocType").value === "public";
$("ocSecret").disabled = isPublic;
$("ocGCred").disabled = isPublic;
$("ocGPass").disabled = isPublic;
if (isPublic) {
$("ocSecret").value = "";
$("ocSecret").placeholder = "公开客户端无需密钥";
$("ocGCred").checked = false;
$("ocGPass").checked = false;
} else {
$("ocSecret").placeholder = "留空即可(自动生成 / 不修改)";
}
}
function fillClientForm(c) {
$("ocId").value = c.client_id;
// 主键不可改:改 client_id 语义上等于「新建一个 + 删掉旧的」,
// 让它在输入框里可编辑只会产生一堆说不清的半成品
$("ocId").readOnly = true;
$("ocName").value = c.name || "";
$("ocType").value = c.confidential ? "confidential" : "public";
$("ocSecret").value = "";
$("ocRedirects").value = arr(c.redirect_uris).join("\n");
var grants = arr(c.grant_types);
$("ocGCode").checked = grants.indexOf("authorization_code") !== -1;
$("ocGRefresh").checked = grants.indexOf("refresh_token") !== -1;
$("ocGCred").checked = grants.indexOf("client_credentials") !== -1;
$("ocGPass").checked = grants.indexOf("password") !== -1;
$("ocScopes").value = arr(c.scopes).join(" ");
syncClientTypeUI();
}
function clearClientForm() {
$("ocId").value = "";
$("ocId").readOnly = false;
$("ocName").value = "";
$("ocType").value = "confidential";
$("ocSecret").value = "";
$("ocRedirects").value = "";
$("ocGCode").checked = true;
$("ocGRefresh").checked = true;
$("ocGCred").checked = false;
$("ocGPass").checked = false;
$("ocScopes").value = "openid profile email";
syncClientTypeUI();
}
// ---------------- 事件:账号表格 ----------------
$("usersBody").addEventListener("click", function (e) {
var btn = e.target.closest("button[data-act]");
if (!btn) return;
var act = btn.getAttribute("data-act");
var user = btn.getAttribute("data-user");
if (act === "copy-key") {
copyText(btn.getAttribute("data-key"), "API Key 已复制到剪贴板");
return;
}
var req = null;
if (act === "reset-key") {
if (!confirm("重置后旧 Key 立即失效,确认继续?")) return;
req = api("POST", "/api/admin/users/key", { username: user });
} else if (act === "reset-pass") {
var pwd = prompt("为账号 " + user + " 设置新密码(至少 6 位):");
if (!pwd) return;
req = api("POST", "/api/admin/users/password", { username: user, password: pwd });
} else if (act === "set-display") {
var curDisplay = btn.getAttribute("data-display") || "";
var dn = prompt("账号 " + user + " 的展示名(中文姓名,留空 = 清空):", curDisplay);
if (dn === null) return;
req = api("POST", "/api/admin/users/display", { username: user, display_name: dn.trim() });
} else if (act === "del-user") {
if (!confirm("删除账号 " + user + "?删除后该账号无法登录,已签发的令牌在过期前仍然有效。")) return;
req = api("POST", "/api/admin/users/delete", { username: user });
}
if (!req) return;
btn.disabled = true;
req.then(function (r) {
toast(r.msg + (r.data && r.data.api_key ? ":" + r.data.api_key : ""));
return loadAll();
}).catch(function (err) { toast(err.message, true); btn.disabled = false; });
});
// ---------------- 事件:OAuth 接入方 ----------------
$("oauthEndpointsBody").addEventListener("click", function (e) {
var btn = e.target.closest("button[data-act='copy-text']");
if (!btn) return;
copyText(btn.getAttribute("data-text") || "", "端点地址已复制");
});
$("oauthClientsBody").addEventListener("click", function (e) {
var btn = e.target.closest("button[data-act]");
if (!btn) return;
var act = btn.getAttribute("data-act");
var id = btn.getAttribute("data-id");
if (act === "copy-secret") {
var c = state.oauthClients.filter(function (x) { return x.client_id === id; })[0];
if (c) copyText(c.client_secret || "", "客户端密钥已复制");
return;
}
if (act === "edit-client") {
var target = state.oauthClients.filter(function (x) { return x.client_id === id; })[0];
if (!target) return;
fillClientForm(target);
window.scrollTo({ top: 0, behavior: "smooth" });
toast("已载入 " + id + ",改完点「保存接入方」;密钥留空表示不改");
return;
}
if (act === "rotate-secret") {
if (!confirm("重置 " + id + " 的密钥?旧密钥立即失效,还用着旧密钥的接入方将无法换取令牌。")) return;
btn.disabled = true;
api("POST", "/api/admin/oauth-clients/rotate", { client_id: id })
.then(function (r) {
var secret = (r.data || {}).client_secret || "";
toast(r.msg);
// 明文只在这一刻存在:列表里是脱敏值,弹窗关掉就得再重置一次
if (secret) window.prompt("新密钥(请立即复制到接入方配置):", secret);
return loadAll();
})
.catch(function (err) { toast(err.message, true); btn.disabled = false; });
return;
}
if (act === "del-client") {
if (!confirm("删除接入方 " + id + "?指向它的授权请求会立即失败(已签发令牌在过期前仍有效)。")) return;
btn.disabled = true;
api("POST", "/api/admin/oauth-clients/delete", { client_id: id })
.then(function (r) { toast(r.msg); return loadAll(); })
.catch(function (err) { toast(err.message, true); btn.disabled = false; });
}
});
// ---------------- 事件:表单 ----------------
$("createUserForm").addEventListener("submit", function (e) {
e.preventDefault();
api("POST", "/api/admin/users/create", {
username: $("cuName").value.trim(),
display_name: $("cuDisplay").value.trim(),
password: $("cuPass").value,
role: $("cuRole").value,
email: $("cuEmail").value.trim(),
department: $("cuDept").value.trim(),
groups: $("cuGroups").value.trim()
}).then(function (r) {
toast(r.msg + ",API Key:" + (r.data || {}).api_key);
$("cuName").value = "";
$("cuDisplay").value = "";
$("cuPass").value = "";
$("cuEmail").value = "";
$("cuDept").value = "";
$("cuGroups").value = "";
return loadAll();
}).catch(function (err) { toast(err.message, true); });
});
$("ocType").addEventListener("change", syncClientTypeUI);
$("ocClearBtn").addEventListener("click", function () {
clearClientForm();
toast("表单已清空,现在是新建模式");
});
$("upsertClientForm").addEventListener("submit", function (e) {
e.preventDefault();
var clientId = $("ocId").value.trim();
if (!clientId) { toast("client_id 不能为空", true); return; }
var grants = [];
if ($("ocGCode").checked) grants.push("authorization_code");
if ($("ocGRefresh").checked) grants.push("refresh_token");
if (!$("ocGCred").disabled && $("ocGCred").checked) grants.push("client_credentials");
if (!$("ocGPass").disabled && $("ocGPass").checked) grants.push("password");
var existed = state.oauthClients.some(function (c) { return c.client_id === clientId; });
var payload = {
client_id: clientId,
name: $("ocName").value.trim(),
// 回调地址原样按行传,后端自己拆(换行 / 逗号 / 空格都认)
redirect_uris: $("ocRedirects").value,
grant_types: grants.join(","),
scopes: $("ocScopes").value,
confidential: $("ocType").value === "confidential"
};
// 密钥留空就不传这个字段:新建时后端自动生成,更新时保留原值
var secret = $("ocSecret").value.trim();
if (secret) payload.client_secret = secret;
api("POST", "/api/admin/oauth-clients/save", payload).then(function (r) {
var d = r.data || {};
toast(r.msg);
if (!existed && d.client_secret) {
// 明文只出现这一次(列表里是脱敏值),别让它随 toast 一起消失
window.prompt("接入方已创建,客户端密钥(请立即复制):", d.client_secret);
}
clearClientForm();
return loadAll();
}).catch(function (err) { toast(err.message, true); });
});
// ---------------- 事件:Tab ----------------
var TAB_NAMES = ["accounts", "oauth", "guide"];
document.querySelectorAll(".tab").forEach(function (tab) {
tab.addEventListener("click", function () {
document.querySelectorAll(".tab").forEach(function (t) { t.classList.remove("active"); });
tab.classList.add("active");
var want = tab.getAttribute("data-tab");
TAB_NAMES.forEach(function (name) { $("tab-" + name).hidden = (name !== want); });
});
});
// ---------------- 启动 ----------------
syncClientTypeUI();
api("GET", "/api/admin/session")
.then(function (r) { return showApp(r.data); })
.catch(function () { showLogin(); });
})();
</script>
</body>
</html>