Files
sso/tests/oauth2-maxkey-e2e.sh
T
ssw 6409d42817 feat(sso): MaxKey/JNPF/uc 迁移 P0 修复
- /sign/api/oauth/v20/me 归一化盲区:补 /api/oauth/v20/me 路由别名
- scope 逗号+空白切分(authorize 与 has_openid 同口径,避免逗号串吞 id_token)
- mobile 身份字段走 User.extra 全链(check_mobile/create/set_profile/claims/me),
  me 补 MaxKey 别名字段 id/userId/displayName/fullName
- 单点注销:/logout、/sign/logout 别名 + redirect_uri 302 回跳
  (client 白名单,未登记 400;302 同时清会话 cookie)
- 管理员重置密码入口统一过 accounts::check_password
- e2e 互通套新增 A2b/A2c/A2d/A2e/A8b 六条断言,六套回归 rc=0
2026-09-13 22:06:12 +08:00

359 lines
15 KiB
Bash
Executable File
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.
#!/usr/bin/env bash
# ============================================================================
# MaxKey OAuth2 互通 + demo-system 接入 端到端验证
#
# 三组断言:
# A. MaxKey 端点别名与传参约定(/oauth/v20/*、/oauth2.0/*、context-path 归一化)
# —— 照抄 MaxKey 文档的应用不改一行代码即可对接
# B. demo-system 自己当 OAuth2 客户端:授权码流全链路(style=maxkey)
# C. demo-system 经 IAP 零改造接入:网关认证 + X-Auth-* 注入 + 伪造头被覆盖
#
# 前置:
# - scripts/run-local-e2e.sh 已拉起 nginx(:18098 IdP / :18095 IAP)
# 与 demo-system(:18096)
# - 种子:source/data/users.json(alice/alice123)、source/data/oauth_clients.json
# (demo-system 机密 / demo-spa 公开)
# - 依赖:curl、python3
#
# 客户端密钥不硬编码,运行时从 $DATA_DIR/oauth_clients.json 读取。
#
# 用法:
# bash tests/oauth2-maxkey-e2e.sh [IDP_BASE] [DEMO_BASE] [IAP_DEMO_BASE] [DATA_DIR]
# ============================================================================
set -u
# 口令等敏感值从项目根 .env 读(不进 git);已存在的环境变量优先。
_ENV_HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
. "$_ENV_HERE/../scripts/load-env.sh"
unset _ENV_HERE
IDP="${1:-http://127.0.0.1:18098}"
DEMO="${2:-http://127.0.0.1:18096}"
IAPD="${3:-http://127.0.0.1:18095}"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
DATA_DIR="${4:-$ROOT/source/data}"
JAR="$(mktemp -t sso_mk_cookies.XXXXXX.txt)"
H1="$(mktemp -t sso_mk_h1.XXXXXX.txt)"
H2="$(mktemp -t sso_mk_h2.XXXXXX.txt)"
H3="$(mktemp -t sso_mk_h3.XXXXXX.txt)"
PASS=0; FAIL=0
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
bad() { echo " ❌ $1"; FAIL=$((FAIL+1)); }
need() { command -v "$1" >/dev/null 2>&1 || { echo "缺少依赖: $1"; exit 2; }; }
need curl; need python3
echo "==> IdP : $IDP"
echo "==> demo : $DEMO"
echo "==> IAP+demo : $IAPD"
echo "==> data : $DATA_DIR"
# ---------- 助手 -----------------------------------------------------------
# 顶层键取值(MaxKey /me 是裸对象,不套 {code,msg,data} 信封)
tj() { printf '%s' "$1" | python3 -c "
import sys,json
k=sys.argv[1]
try: d=json.loads(sys.stdin.read())
except Exception: print(''); raise SystemExit
v=d.get(k) if isinstance(d,dict) else None
print(v if isinstance(v,str) else (json.dumps(v) if v is not None else ''))
" "$2"; }
# 取 Location 头
hdr_location() {
python3 - "$1" <<'PY'
import sys
for ln in open(sys.argv[1], errors='replace'):
if ln.lower().startswith('location'):
print(ln.split(':', 1)[1].strip()); break
PY
}
# 从 Set-Cookie 取某个 cookie 值(curl 对 HttpOnly 会写 `#HttpOnly_` 前缀,不能用 ^[^#] 过滤)
setcookie_val() {
python3 - "$1" "$2" <<'PY'
import sys
name, path = sys.argv[1], sys.argv[2]
out = ''
for ln in open(path, errors='replace'):
if ln.lower().startswith('set-cookie'):
first = ln.split(':', 1)[1].strip().split(';')[0]
k, _, v = first.partition('=')
if k.strip() == name:
out = v
print(out)
PY
}
# 从 curl cookie jar 读某个 cookie 值。
# jar 里 HttpOnly cookie 写成 `#HttpOnly_<domain>\t...`,普通行也可能以 `#` 开头,
# 所以要剥前缀而不是简单按 `^[^#]` 过滤。
jar_cookie() {
python3 - "$1" "$2" <<'PY'
import sys
name, path = sys.argv[1], sys.argv[2]
out = ''
for ln in open(path, errors='replace'):
ln = ln.rstrip('\n')
if ln.startswith('#HttpOnly_'):
ln = ln[len('#HttpOnly_'):]
elif ln.startswith('#') or not ln.strip():
continue
f = ln.split('\t')
if len(f) >= 7 and f[5] == name:
out = f[6]
print(out)
PY
}
# 从 URL 取查询参数
qget() {
python3 - "$1" "$2" <<'PY'
import sys, urllib.parse as u
q = u.urlparse(sys.argv[1]).query
print((u.parse_qs(q).get(sys.argv[2]) or [''])[0])
PY
}
# 读客户端密钥(不硬编码)
secret_of() {
python3 - "$DATA_DIR/oauth_clients.json" "$1" <<'PY'
import json, sys
for c in json.load(open(sys.argv[1])):
if c["client_id"] == sys.argv[2]:
print(c.get("client_secret", "")); break
PY
}
DEMO_SECRET="$(secret_of demo-system)"
REDIRECT="http://127.0.0.1:18096/oauth2/callback"
STATE="mk-state-$$"
# ===========================================================================
echo
echo "## A. MaxKey 端点别名与传参约定"
# ===========================================================================
# A1. /oauth/v20/authorize 存在(未登录 → 302 到登录页)
CODE="$(curl -s -o /dev/null -w '%{http_code}' "$IDP/oauth/v20/authorize?client_id=demo-system&response_type=code&redirect_uri=$REDIRECT")"
if [ "$CODE" = "302" ]; then ok "GET /oauth/v20/authorize 命中(302 跳登录)"; else bad "GET /oauth/v20/authorize 期望 302,实得 $CODE"; fi
# A2. context-path 归一化:/maxkey/... 与 /sign/authz/... 都能命中
for P in "/maxkey/oauth/v20/authorize" "/sign/authz/oauth/v20/authorize" "/oauth2.0/authorize"; do
CODE="$(curl -s -o /dev/null -w '%{http_code}' "$IDP$P?client_id=demo-system&response_type=code&redirect_uri=$REDIRECT")"
if [ "$CODE" = "302" ]; then ok "GET $P 命中(context-path 归一化)"; else bad "GET $P 期望 302,实得 $CODE"; fi
done
# A2b. `/sign/api/oauth/v20/me`:MaxKey 真实 userinfo 路径挂在 /sign/api 下
# (不是 /sign/authz)——曾是 context-path 归一化盲区,404 回归线
CODE="$(curl -s -o /dev/null -w '%{http_code}' "$IDP/sign/api/oauth/v20/me")"
if [ "$CODE" != "404" ] && [ "$CODE" != "000" ]; then ok "GET /sign/api/oauth/v20/me 命中(${CODE},非 404)"; else bad "/sign/api/oauth/v20/me 404,归一化盲区回归($CODE)"; fi
# A2c. 逗号分隔 scope(MaxKey 文档示例写法 "openid,profile,email"):
# 校验应通过(未登录 → 302 跳登录),而不是 invalid_scope 400
CODE="$(curl -s -o /dev/null -w '%{http_code}' "$IDP/sign/authz/oauth/v20/authorize?client_id=demo-system&response_type=code&redirect_uri=$REDIRECT&scope=openid,profile,email")"
if [ "$CODE" = "302" ]; then ok "authorize 逗号 scope 通过(302 跳登录)"; else bad "逗号 scope 被拒(期望 302,实得 $CODE)"; fi
# A2d. 单点注销裸路径:/sign/logout 经归一化命中
CODE="$(curl -s -o /dev/null -w '%{http_code}' "$IDP/sign/logout")"
if [ "$CODE" != "404" ] && [ "$CODE" != "000" ]; then ok "GET /sign/logout 命中(${CODE})"; else bad "/sign/logout 未命中($CODE)"; fi
# A2e. 注销回跳:已登记 redirect_uri → 302;未登记 → 400 拒绝(开放重定向防线)
CODE="$(curl -s -o /dev/null -w '%{http_code}' "$IDP/sign/logout?redirect_uri=$REDIRECT")"
if [ "$CODE" = "302" ]; then ok "logout 带已登记 redirect_uri → 302 回跳"; else bad "logout 回跳期望 302,实得 $CODE"; fi
CODE="$(curl -s -o /dev/null -w '%{http_code}' "$IDP/sign/logout?redirect_uri=http://evil.example.com/cb")"
if [ "$CODE" = "400" ]; then ok "logout 未登记 redirect_uri 被拒(400)"; else bad "开放重定向防线失效(期望 400,实得 $CODE)"; fi
# A3. token 端点别名存在(缺参数应 4xx,而不是 404)
CODE="$(curl -s -o /dev/null -w '%{http_code}' -X POST "$IDP/sign/authz/oauth/v20/token" -d 'grant_type=authorization_code')"
if [ "$CODE" != "404" ] && [ "$CODE" != "000" ]; then ok "POST /sign/authz/oauth/v20/token 命中(${CODE},非 404)"; else bad "token 别名未命中(${CODE})"; fi
# A4. 登录 IdP 建立 SSO 会话(MaxKey 风格的客户端不会走 /login,这里只是为了拿到会话)
curl -s -o /dev/null -D "$H1" -c "$JAR" -X POST "$IDP/login" \
--data-urlencode "username=alice" --data-urlencode "password=${ALICE_PASSWORD:-alice123}" \
--data-urlencode "redirect=/"
SSO="$(setcookie_val sso_sid "$H1")"
if [ -n "$SSO" ]; then ok "IdP 登录成功,下发 SSO 会话 Cookie"; else bad "IdP 登录未下发会话 Cookie"; fi
# A5. 带会话走 MaxKey authorize → 拿到授权码
curl -s -o /dev/null -D "$H1" -b "$JAR" \
"$IDP/oauth/v20/authorize?client_id=demo-system&response_type=code&redirect_uri=$REDIRECT&scope=openid+profile+email&state=$STATE"
LOC="$(hdr_location "$H1")"
CODE_AUTH="$(qget "$LOC" code)"
RET_STATE="$(qget "$LOC" state)"
if [ -n "$CODE_AUTH" ] && [ "$RET_STATE" = "$STATE" ]; then
ok "MaxKey authorize 返回授权码(state 原样回传)"
else
bad "MaxKey authorize 未返回 code/state:$LOC"
fi
# A6. MaxKey token:client_id/client_secret 走表单,**不用 Basic**
TOK_JSON="$(curl -s -X POST "$IDP/oauth/v20/token" \
-d "grant_type=authorization_code" \
--data-urlencode "client_id=demo-system" \
--data-urlencode "client_secret=$DEMO_SECRET" \
--data-urlencode "code=$CODE_AUTH" \
--data-urlencode "redirect_uri=$REDIRECT")"
AT="$(tj "$TOK_JSON" access_token)"
case "$AT" in
*.*.*) ok "MaxKey token 换发成功(表单传密钥,access_token 为 JWT)" ;;
*) bad "MaxKey token 换发异常:$TOK_JSON" ;;
esac
# A7. MaxKey /me:令牌走 access_token 参数,返回 MaxKey 扁平字段
# username/userid 必须是**登录账号**(alice),realname 才是显示名
ME_JSON="$(curl -s "$IDP/oauth/v20/me?access_token=$AT")"
U_NAME="$(tj "$ME_JSON" username)"
U_ID="$(tj "$ME_JSON" userid)"
U_MAIL="$(tj "$ME_JSON" email)"
U_REAL="$(tj "$ME_JSON" realname)"
if [ "$U_NAME" = "alice" ] && [ "$U_ID" = "alice" ] && [ -n "$U_MAIL" ] && [ -n "$U_REAL" ]; then
ok "MaxKey /me 账号语义正确(username=alice, realname=${U_REAL})"
else
bad "MaxKey /me 字段异常(username=${U_NAME}, userid=$U_ID, email=$U_MAIL, realname=${U_REAL})"
fi
# A8. /oauth2.0/profile 别名(另一族命名)
ME2="$(curl -s "$IDP/oauth2.0/profile?access_token=$AT")"
if [ "$(tj "$ME2" username)" = "alice" ]; then ok "GET /oauth2.0/profile 别名命中"; else bad "/oauth2.0/profile 别名异常:$ME2"; fi
# A8b. /me 的 MaxKey 别名字段:id/userId(全局身份映射键)+ displayName
U_ID2="$(tj "$ME_JSON" id)"
U_DN="$(tj "$ME_JSON" displayName)"
if [ "$U_ID2" = "alice" ] && [ -n "$U_DN" ]; then ok "/me 别名字段 id/userId/displayName 正常"; else bad "/me 别名字段异常(id=$U_ID2, displayName=$U_DN)"; fi
# A9. 标准端点不受影响(回归):Bearer 头 + userinfo 信封
STD="$(curl -s "$IDP/oauth/userinfo" -H "Authorization: Bearer $AT")"
if [ "$(printf '%s' "$STD" | python3 -c "
import sys,json
d=json.loads(sys.stdin.read())
print((d.get('data') or {}).get('preferred_username',''))
")" = "alice" ]; then ok "标准 /oauth/userinfo(Bearer + 信封)仍正常"; else bad "标准 userinfo 回归失败:$STD"; fi
# ===========================================================================
echo
echo "## B. demo-system 自己当 OAuth2 客户端(授权码流)"
# ===========================================================================
HEALTH="$(curl -s "$DEMO/healthz")"
if [ "$(tj "$HEALTH" style)" = "maxkey" ] && [ "$(tj "$HEALTH" client_id)" = "demo-system" ]; then
ok "demo-system 就绪(style=maxkey, client_id=demo-system)"
else
bad "demo-system /healthz 异常:$HEALTH"
fi
HOME="$(curl -s "$DEMO/")"
case "$HOME" in
*"统一认证登录"*) ok "未登录访问首页显示登录入口" ;;
*) bad "首页未显示登录入口" ;;
esac
# B3. /login 跳转到 IdP 的 MaxKey authorize(而非标准路径)
curl -s -o /dev/null -D "$H2" "$DEMO/login"
AUTH_URL="$(hdr_location "$H2")"
case "$AUTH_URL" in
*"/oauth/v20/authorize"*) ok "demo-system /login 跳 MaxKey 端点 /oauth/v20/authorize" ;;
*) bad "demo-system /login 跳转异常:$AUTH_URL" ;;
esac
D_STATE="$(qget "$AUTH_URL" state)"
if [ -n "$D_STATE" ]; then ok "demo-system 生成并携带 state(防 CSRF)"; else bad "demo-system 未带 state"; fi
# B5. 带 SSO 会话完成授权 → 回调地址带 code
curl -s -o /dev/null -D "$H3" -b "$JAR" "$AUTH_URL"
CB_LOC="$(hdr_location "$H3")"
D_CODE="$(qget "$CB_LOC" code)"
if [ -n "$D_CODE" ]; then ok "授权完成,回调携带授权码"; else bad "未拿到授权码:$CB_LOC"; fi
# B6. 回调:应用用 code 换 token + 取 userinfo + 建本地会话
# 必须 -b + -c 同时给:只给 -c 时 curl 不加载既有 jar,会把它整个覆写成空,
# 后续依赖 SSO 会话的断言(C 组)会集体误判为「未登录」。
CB_CODE="$(curl -s -o /dev/null -w '%{http_code}' -b "$JAR" -c "$JAR" "$CB_LOC")"
D_SESS="$(jar_cookie demo_sess "$JAR")"
if [ "$CB_CODE" = "302" ] && [ -n "$D_SESS" ]; then
ok "回调换发成功并建立 demo-system 本地会话"
else
bad "回调异常(http=$CB_CODE, cookie=${D_SESS})"
fi
# B7. 应用侧 /api/me
D_ME="$(curl -s -b "$JAR" "$DEMO/api/me")"
SRC="$(tj "$D_ME" source)"
D_USER="$(printf '%s' "$D_ME" | python3 -c "
import sys,json
d=json.loads(sys.stdin.read())
print((d.get('user') or {}).get('preferred_username',''))
")"
if [ "$SRC" = "oauth2" ] && [ "$D_USER" = "alice" ]; then
ok "demo-system /api/me 返回 OAuth2 会话身份(alice)"
else
bad "demo-system /api/me 异常:$D_ME"
fi
# B8. 非法 state 应被拒(CSRF 防护)
CB_BAD="$(curl -s -o /dev/null -w '%{http_code}' "$DEMO/oauth2/callback?code=x&state=bogus-$RANDOM")"
if [ "$CB_BAD" = "400" ]; then ok "回调拒绝非法 state(400,防 CSRF)"; else bad "非法 state 未被拒绝(http=${CB_BAD})"; fi
# ===========================================================================
echo
echo "## C. demo-system 经 IAP 零改造接入(18095)"
# ===========================================================================
# C1. 无身份 → 302 跳登录(业务系统根本没被访问到)
curl -s -o /dev/null -D "$H1" "$IAPD/"
ILOC="$(hdr_location "$H1")"
case "$ILOC" in
*"/login"*) ok "IAP 无身份拦截并跳登录" ;;
*) bad "IAP 无身份行为异常:$ILOC" ;;
esac
# C2. 带 SSO 会话经网关 → 网关注入身份头,业务系统读到
curl -s -o /dev/null -b "$JAR" "$IAPD/" -D "$H2"
IAP_HOME_CODE="$(awk 'NR==1{print $2}' "$H2")"
if [ "$IAP_HOME_CODE" = "200" ]; then ok "IAP 带会话放行(业务系统 200)"; else bad "IAP 放行失败(http=${IAP_HOME_CODE})"; fi
ECHO_JSON="$(curl -s -b "$JAR" "$IAPD/api/echo")"
INJ_USER="$(printf '%s' "$ECHO_JSON" | python3 -c "
import sys,json
d=json.loads(sys.stdin.read())
h={k.lower():v for k,v in (d.get('injected_headers') or {}).items()}
print(h.get('x-auth-user',''))
")"
if [ "$INJ_USER" = "alice" ]; then ok "网关注入 X-Auth-User=alice 到业务系统"; else bad "未注入 X-Auth-User:$ECHO_JSON"; fi
# C4. 业务系统按注入头识身份(不接触令牌)
I_ME="$(curl -s -b "$JAR" "$IAPD/api/me")"
I_SRC="$(tj "$I_ME" source)"
I_USER="$(printf '%s' "$I_ME" | python3 -c "
import sys,json
d=json.loads(sys.stdin.read())
print((d.get('user') or {}).get('username',''))
")"
if [ "$I_SRC" = "iap" ] && [ "$I_USER" = "alice" ]; then
ok "业务系统零改造识别身份(source=iap, alice)"
else
bad "IAP 身份识别失败:$I_ME"
fi
# C5. 伪造同名头被网关覆盖(IAP 的关键安全属性)
SPOOF="$(curl -s -b "$JAR" -H 'X-Auth-User: attacker' -H 'X-Auth-Groups: root' "$IAPD/api/echo")"
SP_USER="$(printf '%s' "$SPOOF" | python3 -c "
import sys,json
d=json.loads(sys.stdin.read())
h={k.lower():v for k,v in (d.get('injected_headers') or {}).items()}
print(h.get('x-auth-user',''))
")"
if [ "$SP_USER" = "alice" ]; then
ok "客户端伪造 X-Auth-User 被网关覆盖(仍为 alice)"
else
bad "伪造头未被覆盖,实得:$SP_USER"
fi
# ===========================================================================
echo
echo "=========================================="
echo " 通过: $PASS 失败: $FAIL"
echo "=========================================="
rm -f "$JAR" "$H1" "$H2" "$H3" 2>/dev/null || true
[ "$FAIL" = "0" ] || exit 1
exit 0