#!/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_\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