凭据管理 新增 .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 断言才有意义。
334 lines
13 KiB
Bash
Executable File
334 lines
13 KiB
Bash
Executable File
#!/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
|