Files
sso/tests/oauth2-maxkey-e2e.sh
T
ssw 9ac47f7942 feat: 凭据改 .env 注入 + 本地联调脚本 + nginx 域名转发配置
凭据管理
  新增 .env.example(**进版本库**,只放本机/CI 演示默认值)与 scripts/load-env.sh
  (统一读取项目根 .env,已存在的环境变量优先)。三套既有 e2e 改为从 .env 取
  口令与签名密钥,命令行不再出现任何密钥 —— 既避免误入库,也避开终端历史泄露。

本地联调
  scripts/local-serve.sh start|stop|restart:按 .env 起停 nginx 与 demo 系统,
  替代手工拼路径。

nginx 配置
  nginx.test.conf 新增 18093(转发回显后端)+ 18094(sso_domain on +
  proxy_pass http://$proxy_backend_addr),并补 error_page 500 502 503 =
  @no_backend 兜底。
  nginx.conf(生产模板)新增企业域名转发 server:
  server_name ~^(?<subdomain>.+dm)\.mayishangshu\.cn$,443 与 80 跳转各一个。

  为什么不给空上游用 `if ($proxy_backend_addr = "")` 兜底:`if` 在 **rewrite**
  阶段求值,而变量是 **access** 阶段才写入的 —— 合法子域名会被一起误判成
  未解析。改用 error_page + 固定 body 标记(NO_BACKEND),顺带把「转发层兜底」
  与「插件自己发的 404」区分开,e2e 断言才有意义。
2026-09-13 10:25:19 +08:00

334 lines
13 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
# 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
# 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