Docs: 登录测试用例

Mon, 01 Jan 0001 00:00:00 +0000

适用范围

覆盖云联壹云 Web 控制台的登录、登录安全策略、退出与会话管理。涉及的产品功能参见：

环境与账号

项目	值
地址	https://test.yunion.io
账号	cloudadmin
密码	cloudadmin@test
域	Default

登录页元素（以实际界面为准）：账号登录/手机号登录页签、用户名输入框、密码输入框、登录按钮、图形验证码（按策略出现）、指定登录域入口、忘记密码、第三方/CAS 登录入口。

用例总览

编号	用例名称	优先级	类型
TC-LOGIN-001	使用正确的用户名和密码登录	P0	正向
TC-LOGIN-002	使用错误的密码登录	P0	反向
TC-LOGIN-003	使用不存在的用户名登录	P1	反向
TC-LOGIN-004	用户名或密码为空提交	P1	校验
TC-LOGIN-005	指定登录域登录	P1	正向
TC-LOGIN-006	域与用户不匹配时登录失败	P2	反向
TC-LOGIN-007	连续输错密码后出现图形验证码	P1	安全
TC-LOGIN-008	连续输错密码超过上限锁定账户并产生安全告警	P1	安全
TC-LOGIN-009	禁用"控制台登录"的用户无法登录	P1	反向
TC-LOGIN-010	被禁用的用户无法登录	P1	反向
TC-LOGIN-011	启用 MFA 的用户登录	P1	正向
TC-LOGIN-012	密码已过期的用户无法登录	P2	反向
TC-LOGIN-013	登录后落地视图正确	P0	正向
TC-LOGIN-014	退出登录后会话失效	P0	正向
TC-LOGIN-015	未登录直接访问内页跳转登录页	P1	安全
TC-LOGIN-016	切换登录界面语言	P2	正向
TC-LOGIN-017	认证源（LDAP）用户登录	P2	正向
TC-LOGIN-018	登录会话有效期	P2	安全

优先级：P0

前置条件：cloudadmin 账号已启用且允许控制台登录。

步骤：

浏览器打开 https://test.yunion.io 。
在"账号登录"页签中输入用户名 cloudadmin。
输入密码 cloudadmin@test。
单击"登录"按钮。

预期结果：

提交后界面提示"正在登录，请稍候"一类的过渡状态。
登录成功，跳转到控制面板页面，右上角显示当前用户。
顶部区域显示视图切换入口，当前视图为管理后台视图。
浏览器中生成登录凭证（yunionauth）及 scope、domain、tenant 等 Cookie。
再次输入地址访问控制台，无需重新登录。

实测结果：通过（接口层已验证，见附录 B）。

优先级：P0

前置条件：同 TC-LOGIN-001。

步骤：

打开登录页。
输入用户名 cloudadmin。
输入错误密码 wrongpass123。
单击"登录"按钮。

预期结果：

登录失败，停留在登录页。
页面提示"用户名或密码错误"（接口返回 incorrect username or password）。
密码输入框被清空或以密文形式保留，不出现明文回显。
未生成有效登录凭证，无法进入控制台。

实测结果：通过。接口返回 HTTP 401，响应体为 {"class":"IncorrectUsernameOrPassword","code":401,"details":"incorrect username or password"}。

优先级：P1

步骤：

打开登录页。
输入用户名 no_such_user_9999。
输入任意密码。
单击"登录"按钮。

预期结果：

登录失败。
提示信息与 TC-LOGIN-002 一致，不区分"用户名不存在"与"密码错误"，避免泄露账号是否存在。

优先级：P1

步骤：

打开登录页，用户名与密码均留空，单击"登录"按钮。
仅填写用户名，密码留空，单击"登录"按钮。
仅填写密码，用户名留空，单击"登录"按钮。

预期结果：

三种情况均不发起登录请求，直接停留在当前页。
对应的输入框下方出现校验提示"请输入用户名"/“请输入密码”。
输入框标红或有明显错误态。

优先级：P1

前置条件：Default 域存在已启用且允许控制台登录的用户。

步骤：

打开登录页，单击"指定登录域"入口。
在域列表中选择 Default。
输入用户名 cloudadmin、密码 cloudadmin@test。
单击"登录"按钮。
在控制台右上角用户菜单中重新打开登录域设置，单击"重置登录域"。

预期结果：

指定登录域后界面显示"当前登录域：Default"。
登录成功，进入控制台。
重置登录域后，登录页恢复为平台级登录，不预选任何域。

优先级：P2

前置条件：存在一个 cloudadmin 未加入的域（如新建域 testdomain）。

步骤：

打开登录页，单击"指定登录域"，选择 cloudadmin 未加入的域。
输入用户名 cloudadmin、密码 cloudadmin@test。
单击"登录"按钮。

预期结果：

登录失败，提示用户名或密码错误。
不发生跨域越权登录。

优先级：P1

前置条件：确认平台已配置密码错误次数阈值（keystone 服务参数 password_error_lock_count，默认 0 表示不锁定）。该用例会占用 cloudadmin 的错误次数，执行前请与管理员确认阈值，避免锁定账号。

步骤：

使用 cloudadmin 与错误密码连续登录，直到界面出现验证码输入框。
记录触发验证码所需的失败次数。
在验证码输入框中输入错误验证码，单击"登录"。
输入正确验证码后提交。

预期结果：

达到阈值后登录页出现图形验证码输入框，且验证码图片可刷新。
验证码错误时提示"请输入有效的验证码"/“验证码错误”，登录被拒绝。
验证码正确且密码正确时登录成功。

备注：若平台未开启验证码策略，本用例标记为"不适用"并记录平台配置值。

优先级：P1

前置条件：password_error_lock_count 已配置为大于 0 的值。

步骤：

使用 cloudadmin 与错误密码连续登录，超过配置的阈值。
尝试使用正确密码登录。
使用管理员账号登录，查看安全告警列表。

预期结果：

超过阈值后账户被锁定，即使输入正确密码也无法登录，提示账户已锁定。
安全告警页面生成一条"异常登录"告警记录。
告警同时发送给被锁定用户本人、其所在域的域管理员和系统管理员。
解除锁定后，使用正确密码可正常登录。

备注：该用例会锁定 cloudadmin 账号，请勿在生产或共享环境执行；执行前确认可解锁。

优先级：P1

前置条件：准备一个已启用但**关闭"登录控制台"**的本地用户。

步骤：

使用管理员在用户管理中新建用户，关闭"登录控制台"。
退出当前登录，使用该用户登录控制台。

预期结果：

登录被拒绝，提示无控制台登录权限或用户名密码错误。
该用户仍可通过 API 等方式访问（如平台允许），但无法登录控制台。

优先级：P1

前置条件：准备一个处于禁用状态的用户，且该用户当前已在线。

步骤：

使用该用户登录控制台并保持在线。
使用管理员在用户管理中禁用该用户。
该用户继续操作控制台页面。
该用户退出后再次登录。

预期结果：

禁用操作不会强制在线用户立即退出。
用户退出后再次登录失败，提示用户已禁用。
使用被禁用用户的正确密码登录同样失败。

优先级：P1

前置条件：全局配置已启用双因子认证，且目标用户已开启 MFA 并完成凭证绑定。

步骤：

使用已开启 MFA 的用户登录，输入正确的用户名和密码。
在出现的登录保护页面中输入 6 位安全码。
使用错误安全码提交一次。
使用正确安全码提交。

预期结果：

密码校验通过后不直接进入控制台，而是要求输入 6 位安全码。
错误安全码提示"安全码不正确，请重新输入"，无法进入控制台。
正确安全码提交后成功进入控制台。

备注：test.yunion.io 上 cloudadmin 当前未开启 MFA（登录凭证中 totp_on=false），执行本用例需先准备一个开启 MFA 的用户；若全局双因子认证未启用，用户侧 MFA 开关不生效。

优先级：P2

前置条件：存在密码已过期的用户。

步骤：

使用密码已过期的用户登录。
使用密码还有 7 天过期的用户登录。

预期结果：

密码已过期的用户无法登录系统。
密码还有 7 天过期的用户可正常登录，登录后提示密码即将过期，建议尽快修改。

优先级：P0

前置条件：cloudadmin 为 Default 域 system 项目的 admin 角色。

步骤：

使用 cloudadmin 登录。
查看顶部区域视图切换入口。
依次切换到域管理后台视图、项目视图，再切回管理后台视图。

预期结果：

默认落地管理后台视图，可看到系统级资源。
视图切换入口正常展示，切换后左侧导航菜单随视图变化。
域管理后台视图要求平台已开启三级权限；未开启时该视图不出现。

优先级：P0

步骤：

登录控制台，记录当前地址。
单击右上角用户图标，选择"退出"。
使用浏览器后退按钮回到退出前的页面。
直接粘贴退出前的内页地址访问。

预期结果：

退出后跳转到登录页。
后退或直接访问内页均被重定向到登录页，不展示业务数据。
浏览器中的登录凭证已失效。

第三方认证源（如 CAS）用户退出后，若认证服务器侧会话未销毁，可能被自动重新登录，属于认证源行为，需单独确认。

优先级：P1

步骤：

清除浏览器 Cookie 或使用无痕窗口。
直接访问内页地址，如 /vminstance 一类的资源列表地址。

预期结果：

请求被拦截，跳转到登录页。
登录成功后跳转回原访问的内页地址（如平台支持回跳）。

优先级：P2

步骤：

打开登录页，将界面语言切换为英文。
切换回简体中文。

预期结果：

登录页文案随语言切换，登录按钮、输入框提示、错误提示均为目标语言。
切换语言不影响已输入的用户名和密码。

优先级：P2

前置条件：平台已配置并启用 LDAP 认证源，且已同步用户。

步骤：

在登录页选择对应的认证源（如"指定登录域"中选择认证源对应的域）。
输入 LDAP 用户的用户名和密码登录。

预期结果：

认证源用户可正常登录控制台。
用户管理中被标记为 LDAP 认证源的用户，不支持在平台侧重置密码。

优先级：P2

步骤：

登录控制台，查看登录凭证 Cookie 的过期时间。
保持页面空闲超过凭证有效期后，再操作页面或访问内页。

预期结果：

登录凭证有效期默认为 24 小时（Max-Age=86399）。
凭证过期后，操作页面或访问内页被重定向到登录页，需重新登录。

实测结果：通过。实测登录响应中 yunionauth、scope、domain、tenant 四个 Cookie 的 Max-Age 均为 86399 秒。

附录 A：接口层验证脚本

登录相关的界面行为可用登录接口快速回归。以下脚本对 https://test.yunion.io 执行接口级验证，可直接复制运行（需要 curl 与 python3）。

#!/bin/bash
# verify_login.sh — 登录接口回归验证
BASE="https://test.yunion.io"
USER="cloudadmin"
PASS="cloudadmin@test"
DOMAIN="Default"

echo "== TC-LOGIN-001 正确凭据登录 =="
code=$(curl -s -o /tmp/login_ok.txt -w "%{http_code}" \
 -c /tmp/login_cookie.txt \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"$USER\",\"password\":\"$PASS\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login")
echo "HTTP $code"
if [ "$code" = "200" ]; then
 echo "PASS: 登录成功"
 grep -q yunionauth /tmp/login_cookie.txt && echo "PASS: 已下发 yunionauth 凭证"
else
 echo "FAIL: 预期 200，实际 $code"
fi

echo
echo "== TC-LOGIN-002 错误密码登录 =="
resp=$(curl -s -w "\n%{http_code}" \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"$USER\",\"password\":\"wrongpass123\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login")
body=$(echo "$resp" | head -n -1)
code=$(echo "$resp" | tail -n 1)
echo "HTTP $code"
echo "$body" | grep -q IncorrectUsernameOrPassword \
 && echo "PASS: 返回 IncorrectUsernameOrPassword" \
 || echo "FAIL: 未返回预期错误类型"

echo
echo "== TC-LOGIN-003 不存在用户登录（提示应与错误密码一致） =="
resp=$(curl -s -w "\n%{http_code}" \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"no_such_user_9999\",\"password\":\"whatever\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login")
body=$(echo "$resp" | head -n -1)
code=$(echo "$resp" | tail -n 1)
echo "HTTP $code"
echo "$body" | grep -q IncorrectUsernameOrPassword \
 && echo "PASS: 与错误密码返回一致，未泄露账号是否存在" \
 || echo "FAIL: 错误类型与错误密码不一致"

echo
echo "== TC-LOGIN-018 会话有效期 =="
exp=$(curl -s -D - -o /dev/null \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"$USER\",\"password\":\"$PASS\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login" | grep -i '^set-cookie: yunionauth' | grep -o 'Max-Age=[0-9]*')
echo "yunionauth $exp"
[ "$exp" = "Max-Age=86399" ] && echo "PASS: 有效期为 24 小时" || echo "WARN: 有效期与预期 86399 不同"

登录成功后可用 /tmp/login_cookie.txt 中的凭证调用其他业务接口，例如：

curl -s -b /tmp/login_cookie.txt "$BASE/api/v1/servers?limit=5"

附录 B：本环境实测记录

以下接口行为在 https://test.yunion.io 实测确认（2026-09-15），可作为用例预期结果的基准。

检查项	实测结果
控制台可达性	HTTP 200，HTTP/2，nginx
登录接口	`POST /api/v1/auth/login`，请求体 `{"username","password","domain"}`
正确凭据	HTTP 200，响应体为空，下发 `yunionauth`/`scope`/`domain`/`tenant` Cookie
错误密码	HTTP 401，`{"class":"IncorrectUsernameOrPassword","details":"incorrect username or password"}`
cloudadmin 默认 scope	`system`（管理后台视图）
cloudadmin 默认域	`Default`
cloudadmin MFA 状态	未开启（凭证中 `totp_on=false`、`totp_verified=false`）
登录凭证有效期	86399 秒（24 小时）
图形验证码接口	`GET /api/v1/auth/captcha`，返回 `image/png` 并下发 `captcha` Cookie

说明：以上为接口层实测结论；依赖界面交互的用例（如验证码出现时机、MFA 交互、密码过期提示）仍需按用例步骤在浏览器中执行确认。

Cloudpods – 认证

Docs: 登录测试用例

适用范围

环境与账号

用例总览

TC-LOGIN-001 使用正确的用户名和密码登录

TC-LOGIN-002 使用错误的密码登录

TC-LOGIN-003 使用不存在的用户名登录

TC-LOGIN-004 用户名或密码为空提交

TC-LOGIN-005 指定登录域登录

TC-LOGIN-006 域与用户不匹配时登录失败

TC-LOGIN-007 连续输错密码后出现图形验证码

TC-LOGIN-008 连续输错密码超过上限锁定账户并产生安全告警

TC-LOGIN-009 禁用"控制台登录"的用户无法登录

TC-LOGIN-010 被禁用的用户无法登录

TC-LOGIN-011 启用 MFA 的用户登录

TC-LOGIN-012 密码已过期的用户无法登录

TC-LOGIN-013 登录后落地视图正确

TC-LOGIN-014 退出登录后会话失效

TC-LOGIN-015 未登录直接访问内页跳转登录页

TC-LOGIN-016 切换登录界面语言

TC-LOGIN-017 认证源（LDAP）用户登录

TC-LOGIN-018 登录会话有效期

附录 A：接口层验证脚本

附录 B：本环境实测记录