#!/usr/bin/env bash # ============================================================================ # 管理接口端到端验证:账号批量维护(角色 / 部门 / 用户组) # # 覆盖: # - 未登录访问批量接口被拒(401) # - 批量加入用户组 / 移出用户组(去重、只改增量) # - 批量设置部门(含清空) # - 批量改角色 + 「至少保留一个管理员」红线 # - 批量解锁(清零 failed_count / locked_until) # - 参数校验:空选择被拒、非法组名被拒、非法角色被拒 # - 不存在的账号只跳过不中断(skipped 回显) # - 改组 → 新签令牌立即携带新组(用户表热生效);旧令牌保持签发时快照 # - 审计日志写入 admin.user.batch # # 前置:网关以 source/conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh) # 依赖:curl、python3 # # 用法:bash tests/admin-users-batch-e2e.sh [IDP_BASE] [DATA_DIR] [IAP_DEMO_BASE] # ADMIN_USER / ADMIN_PASS 可覆盖(默认取 .env 的 ADMIN_USER / ADMIN_PASSWORD) # ============================================================================ set -u # 口令等敏感值从项目根 .env 读(不进 git);已存在的环境变量优先。 _ENV_HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" . "$_ENV_HERE/../scripts/load-env.sh" unset _ENV_HERE BASE="${1:-http://127.0.0.1:18098}" ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" DATA_DIR="${2:-$ROOT/source/data}" IAP_DEMO="${3:-http://127.0.0.1:18095}" ADMIN_USER="${ADMIN_USER:-admin}" ADMIN_PASS="${ADMIN_PASS:-${ADMIN_PASSWORD:-123456}}" PYTHON="${PYTHON:-python3}" JAR="$(mktemp -t sso_batch_cookies.XXXXXX.txt)" trap 'rm -f "$JAR"' EXIT 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: $BASE" echo "==> data: $DATA_DIR" echo "==> admin: $ADMIN_USER" jget() { printf '%s' "$1" | python3 -c " import sys,json path=[k for k in sys.argv[1].split('.') if k] try: d=json.loads(sys.stdin.read()) except Exception: print(''); raise SystemExit for k in path: if isinstance(d,dict): d=d.get(k) elif isinstance(d,list) and k.isdigit(): d=d[int(k)] if int(k) [JSON] local m="$1" p="$2" b="${3:-}" if [ -n "$b" ]; then curl -s -b "$JAR" -X "$m" "$BASE$p" -H 'Content-Type: application/json' -d "$b" else curl -s -b "$JAR" -X "$m" "$BASE$p" fi } acode() { # [JSON] → HTTP 状态码 local m="$1" p="$2" b="${3:-}" if [ -n "$b" ]; then curl -s -o /dev/null -w '%{http_code}' -b "$JAR" -X "$m" "$BASE$p" -H 'Content-Type: application/json' -d "$b" else curl -s -o /dev/null -w '%{http_code}' -b "$JAR" -X "$m" "$BASE$p" fi } # 取某个账号当前的用户组(逗号连接,便于字符串比较) user_groups() { # areq GET "/api/admin/users" | python3 -c " import sys,json d=json.load(sys.stdin).get('data',{}) for u in d.get('items',[]): if u['username']==sys.argv[1]: print(','.join(u.get('groups') or [])); break else: print('__MISSING__') " "$1" } user_field() { # areq GET "/api/admin/users" | python3 -c " import sys,json d=json.load(sys.stdin).get('data',{}) v='__MISSING__' for u in d.get('items',[]): if u['username']==sys.argv[1]: v=u.get(sys.argv[2],'__MISSING__'); break # 布尔字段统一小写,方便 shell 直接比较 true/false print(v if not isinstance(v,bool) else str(v).lower()) " "$1" "$2" } # --------------------------------------------------------------------------- echo "==> [0] 未登录:批量接口一律拒绝" code="$(curl -s -o /dev/null -w '%{http_code}' -X POST "$BASE/api/admin/users/batch" \ -H 'Content-Type: application/json' -d '{"usernames":"admin"}')" [ "$code" = "401" ] && ok "未登录批量维护 → 401" || bad "未登录批量维护应为 401,实际 $code" # --------------------------------------------------------------------------- echo "==> [1] 管理员登录" LOGIN="$(curl -s -c "$JAR" -X POST "$BASE/api/admin/login" -H 'Content-Type: application/json' \ -d "{\"username\":\"$ADMIN_USER\",\"password\":\"$ADMIN_PASS\"}")" [ "$(jget "$LOGIN" code)" = "200" ] && ok "登录成功" || { bad "登录失败:$LOGIN"; exit 1; } # --------------------------------------------------------------------------- # 造两个测试账号,全部批量用例都打在它们身上,绝不碰 admin echo "==> [2] 准备测试账号" # 先清掉上次异常中断留下的同名残留(上轮失败退出时没走到清理节), # 保证「初始组 = base」这条断言与上一次运行的状态无关 for n in bt-u1 bt-u2; do areq POST /api/admin/users/delete "{\"username\":\"$n\"}" > /dev/null done for n in bt-u1 bt-u2; do areq POST /api/admin/users/create \ "{\"username\":\"$n\",\"password\":\"Test@12345\",\"role\":\"user\",\"department\":\"原部门\",\"groups\":\"base\"}" \ > /dev/null done [ "$(user_groups bt-u1)" = "base" ] && ok "bt-u1 初始组 = base" || bad "bt-u1 初始组异常:$(user_groups bt-u1)" [ "$(user_groups bt-u2)" = "base" ] && ok "bt-u2 初始组 = base" || bad "bt-u2 初始组异常:$(user_groups bt-u2)" # --------------------------------------------------------------------------- echo "==> [3] 参数校验" R="$(areq POST /api/admin/users/batch '{"add_groups":"x"}')" [ "$(jget "$R" code)" != "200" ] && ok "空选择被拒:$(jget "$R" msg)" || bad "空选择应被拒" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1","add_groups":"ok,bad name"}')" [ "$(jget "$R" code)" != "200" ] && ok "含换行的组名被拒:$(jget "$R" msg)" || bad "含换行的组名应被拒" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1","role":"root"}')" [ "$(jget "$R" code)" != "200" ] && ok "非法角色被拒:$(jget "$R" msg)" || bad "非法角色应被拒" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1","add_groups":"'"$(python3 -c 'print("x"*65)')"'"}')" [ "$(jget "$R" code)" != "200" ] && ok "超长组名被拒:$(jget "$R" msg)" || bad "超长组名应被拒" # --------------------------------------------------------------------------- echo "==> [4] 批量加入 / 移出用户组" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1,bt-u2","add_groups":"rd,ops"}')" [ "$(jget "$R" code)" = "200" ] && ok "加入组成功:$(jget "$R" msg)" || bad "加入组失败:$R" [ "$(user_groups bt-u1)" = "base,rd,ops" ] && ok "bt-u1 = base,rd,ops" || bad "bt-u1 组异常:$(user_groups bt-u1)" [ "$(user_groups bt-u2)" = "base,rd,ops" ] && ok "bt-u2 = base,rd,ops" || bad "bt-u2 组异常:$(user_groups bt-u2)" # 重复加同一组:应幂等,不产生重复项 areq POST /api/admin/users/batch '{"usernames":"bt-u1","add_groups":"rd"}' > /dev/null [ "$(user_groups bt-u1)" = "base,rd,ops" ] && ok "重复加组幂等(无重复项)" || bad "重复加组产生重复:$(user_groups bt-u1)" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1,bt-u2","remove_groups":"ops"}')" [ "$(jget "$R" code)" = "200" ] && ok "移出组成功:$(jget "$R" msg)" || bad "移出组失败:$R" [ "$(user_groups bt-u1)" = "base,rd" ] && ok "bt-u1 = base,rd" || bad "bt-u1 组异常:$(user_groups bt-u1)" [ "$(user_groups bt-u2)" = "base,rd" ] && ok "bt-u2 = base,rd" || bad "bt-u2 组异常:$(user_groups bt-u2)" # --------------------------------------------------------------------------- echo "==> [5] 批量设置部门" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1,bt-u2","department":"研发中心"}')" [ "$(jget "$R" code)" = "200" ] && ok "设部门成功:$(jget "$R" msg)" || bad "设部门失败:$R" [ "$(user_field bt-u1 department)" = "研发中心" ] && ok "bt-u1 部门 = 研发中心" || bad "bt-u1 部门异常:$(user_field bt-u1 department)" [ "$(user_field bt-u2 department)" = "研发中心" ] && ok "bt-u2 部门 = 研发中心" || bad "bt-u2 部门异常:$(user_field bt-u2 department)" areq POST /api/admin/users/batch '{"usernames":"bt-u1","department":""}' > /dev/null [ "$(user_field bt-u1 department)" = "" ] && ok "部门可清空" || bad "部门清空失败:$(user_field bt-u1 department)" # --------------------------------------------------------------------------- echo "==> [6] 批量改角色与管理员红线" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1","role":"admin"}')" [ "$(jget "$R" code)" = "200" ] && ok "批量提权成功" || bad "批量提权失败:$R" [ "$(user_field bt-u1 is_admin)" = "true" ] && ok "bt-u1 已为管理员" || bad "bt-u1 未提权:$(user_field bt-u1 is_admin)" # 把全部管理员(admin + bt-u1)一起降级 → 必须被红线拦住,且数据不被改动 R="$(areq POST /api/admin/users/batch "{\"usernames\":\"$ADMIN_USER,bt-u1\",\"role\":\"user\"}")" [ "$(jget "$R" code)" != "200" ] && ok "清空管理员被拒:$(jget "$R" msg)" || bad "清空管理员应被拒" [ "$(user_field bt-u1 is_admin)" = "true" ] && ok "被拒后 bt-u1 仍是管理员(无半改)" || bad "被拒后数据被改动:$(user_field bt-u1 is_admin)" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1","role":"user"}')" [ "$(jget "$R" code)" = "200" ] && ok "单个降级成功" || bad "单个降级失败:$R" [ "$(user_field bt-u1 is_admin)" = "false" ] && ok "bt-u1 已降为普通账号" || bad "bt-u1 未降级:$(user_field bt-u1 is_admin)" # --------------------------------------------------------------------------- echo "==> [7] 批量解锁" # 连错 5 次(ACCOUNT_LOCK_THRESHOLD=5)把 bt-u2 锁上。 # 必须用 machine 客户端的真实密钥:机密客户端缺 client_secret 只会拿到 # invalid_client,根本走不到密码校验,失败计数不会累加。 MACHINE_SECRET="$("$PYTHON" - "$DATA_DIR/oauth_clients.json" <<'PY' import json, sys for c in json.load(open(sys.argv[1])): if c["client_id"] == "machine": print(c.get("client_secret", "")); break PY )" for i in 1 2 3 4 5; do curl -s -o /dev/null -X POST "$BASE/oauth/token" \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode "grant_type=password" --data-urlencode "client_id=machine" \ --data-urlencode "client_secret=$MACHINE_SECRET" \ --data-urlencode "username=bt-u2" --data-urlencode "password=wrong-password" done [ "$(user_field bt-u2 locked)" = "true" ] && ok "bt-u2 已被锁定" || bad "bt-u2 未锁定(locked=$(user_field bt-u2 locked))" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u2","unlock":"1"}')" [ "$(jget "$R" code)" = "200" ] && ok "批量解锁成功:$(jget "$R" msg)" || bad "批量解锁失败:$R" [ "$(user_field bt-u2 locked)" = "false" ] && ok "bt-u2 已解锁" || bad "bt-u2 未解锁:$(user_field bt-u2 locked)" # --------------------------------------------------------------------------- echo "==> [8] 不存在的账号只跳过不中断" R="$(areq POST /api/admin/users/batch '{"usernames":"bt-u1,no-such-user","add_groups":"zzz"}')" [ "$(jget "$R" code)" = "200" ] && ok "部分账号不存在仍返回 200" || bad "应返回 200:$R" echo "$R" | grep -q "no-such-user" && ok "skipped 回显了缺失账号" || bad "skipped 未回显:$R" [ "$(jget "$R" data.changed)" = "1" ] && ok "changed=1" || bad "changed 应为 1:$(jget "$R" data.changed)" [ "$(user_groups bt-u1)" = "base,rd,zzz" ] && ok "存在的账号确实被改" || bad "bt-u1 组异常:$(user_groups bt-u1)" # --------------------------------------------------------------------------- echo "==> [9] 改组后 IAP 注入头立即同步(写穿共享内存)" # 用 password grant 给 alice 拿令牌 → 经 demo 系统的 IAP 打 /api/echo → # 断言 X-Auth-Groups 与刚改的组一致。这一步盯的是历史 bug 形态: # 「管理台改完显示成功,IAP 注入的还是旧组」。 MACHINE_SECRET="$("$PYTHON" - "$DATA_DIR/oauth_clients.json" <<'PY' import json, sys for c in json.load(open(sys.argv[1])): if c["client_id"] == "machine": print(c.get("client_secret", "")); break PY )" T_OK="$(curl -s -X POST "$BASE/oauth/token" \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode "grant_type=password" --data-urlencode "client_id=machine" \ --data-urlencode "client_secret=$MACHINE_SECRET" \ --data-urlencode "username=alice" --data-urlencode "password=${ALICE_PASSWORD:-alice123}" \ --data-urlencode "scope=openid profile" | "$PYTHON" -c "import sys,json;print(json.load(sys.stdin).get('data',{}).get('access_token',''))")" [ -n "$T_OK" ] && ok "alice password grant 可用" || { bad "alice 未拿到令牌"; exit 1; } ECHO_RAW="" # 失败时回显原始响应,省得「空组」没法定位 echo_groups_of() { # 经 IAP echo 回显的 x-auth-groups(token 取全局 ECHO_TOKEN) # demo /api/echo 的包装键是 injected_headers(不是 headers) ECHO_RAW="$(curl -s -H "Authorization: Bearer $ECHO_TOKEN" "$IAP_DEMO/api/echo")" printf '%s' "$ECHO_RAW" | "$PYTHON" -c " import sys,json try: d=json.load(sys.stdin) h=d.get('injected_headers') or d.get('headers') or {} except Exception: h={} v=h.get('x-auth-groups') or h.get('X-Auth-Groups') or h.get('x_auth_groups') or '' print(v) " } # 刚写完 users.json 立刻打 IAP,偶尔会撞上 curl 拿到空响应(连接层的偶发, # 不是注入逻辑问题);给 3 次机会、每次 400ms,仍失败才判定为「未同步」 probe_groups() { # $1=token → 打印 x-auth-groups(失败打印空串) local g="" i for i in 1 2 3; do g="$( ECHO_TOKEN="$1" echo_groups_of )" [ -n "$g" ] && break sleep 0.4 done printf '%s' "$g" } alice_token() { # password grant:签发时刻从用户表现读 claims curl -s -X POST "$BASE/oauth/token" \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode "grant_type=password" --data-urlencode "client_id=machine" \ --data-urlencode "client_secret=$MACHINE_SECRET" \ --data-urlencode "username=alice" --data-urlencode "password=${ALICE_PASSWORD:-alice123}" \ --data-urlencode "scope=openid profile" \ | "$PYTHON" -c "import sys,json;print(json.load(sys.stdin).get('data',{}).get('access_token',''))" } # Bearer 注入语义:**令牌是签发时刻的 claims 快照**(标准 OAuth 行为)。 # 「组改动对下游可见」的正确路径是签发新令牌;已签发的旧令牌在到期前保持旧组。 # 所以这里验证的是两件事: # a) 改组后**新签**的令牌立即携带新组(用户表热生效,无需重启); # b) 改组前签发的旧令牌保持旧组(快照语义,写进用例防止将来悄悄变成 # 「每次请求回查用户表」这种性能陷阱)。 T0="$(alice_token)" # 改组前的快照 areq POST /api/admin/users/profile '{"username":"alice","email":"alice@yourdomain.com","department":"研发部","groups":"rd,probe-tmp"}' > /dev/null T1="$(alice_token)" # 改组后新签 G="$(probe_groups "$T1")" printf '%s' "$G" | grep -q "probe-tmp" && ok "改组后新令牌立即携带新组(x-auth-groups=${G})" || bad "新令牌未反映新组:raw=$ECHO_RAW" G0="$(probe_groups "$T0")" printf '%s' "$G0" | grep -q "probe-tmp" && bad "旧令牌不应携带新组(快照被就地改写):${G0}" || ok "旧令牌保持签发时快照(x-auth-groups=${G0})" areq POST /api/admin/users/profile '{"username":"alice","email":"alice@yourdomain.com","department":"研发部","groups":"rd,eng"}' > /dev/null T2="$(alice_token)" G="$(probe_groups "$T2")" printf '%s' "$G" | grep -q "probe-tmp" && bad "移除组后新令牌仍携带旧组:${G}" || ok "移除组后新令牌不再携带该组(x-auth-groups=${G})" # --------------------------------------------------------------------------- echo "==> [10] 审计留痕" AUD="$(areq GET "/api/admin/audit?limit=50")" echo "$AUD" | grep -q "admin.user.batch" && ok "审计记录了 admin.user.batch" || bad "审计缺少 admin.user.batch" # --------------------------------------------------------------------------- echo "==> [11] 清理测试账号" areq POST /api/admin/users/delete '{"username":"bt-u1"}' > /dev/null areq POST /api/admin/users/delete '{"username":"bt-u2"}' > /dev/null [ "$(user_groups bt-u1)" = "__MISSING__" ] && ok "bt-u1 已删除" || bad "bt-u1 未删除" [ "$(user_groups bt-u2)" = "__MISSING__" ] && ok "bt-u2 已删除" || bad "bt-u2 未删除" echo echo "==> 账号批量维护 e2e:PASS=$PASS FAIL=$FAIL" [ "$FAIL" = "0" ] || exit 1 exit 0