feat(停用账号): 停用/删除即强制下线并点名成因——写入口、X-Auth-Reason 头、三面接线

- Java:AdminUserUpdateRequest 加 disabled 开关(不能停自己、归属门沿用既有闸),
  AccountExpiryService/AdminAuthSupport 抛停用/删除子类型,GlobalExceptionHandler 打
  X-Auth-Reason: disabled|deleted 响应头;业务码保持 401 不变,不惊动三个既有消费者
- 后台管理:用户页停用/解除停用按钮 + 已停用徽章;拦截器把成因随 &auth= 带给登录页,
  登录页分停用/删除两种文案;源码钉子棘轮基线按正路重生成
- 用户端:kick-handler 按 X-Auth-Reason 分支亮停用/删除标记(互斥清理),
  登录页两段专属文案且各自关自动登录;跳转目标仍是 /login?expired=1
- 反假绿:摘掉成因头注入实测 2/4 红(变异自证),还原等值后复跑回绿
This commit is contained in:
2026-10-09 16:35:35 +08:00
parent 3c2fd54e3e
commit 24a94428e8
25 changed files with 704 additions and 31 deletions
@@ -52,6 +52,8 @@
<h1 class="login-title">登录</h1>
<p v-if="kickedNotice" class="kicked-msg">该账号已在其他设备登录,本设备已下线。如非本人操作,请及时修改密码。</p>
<p v-if="expiredNotice" class="kicked-msg">登录状态已失效(登录凭证过期,或该账号已被管理员删除),请重新登录。</p>
<p v-if="disabledNotice" class="kicked-msg">该账号已被管理员停用,本设备已退出登录。如有疑问请联系管理员恢复后重新登录。</p>
<p v-if="deletedNotice" class="kicked-msg">该账号已被管理员删除,本设备已退出登录。</p>
<p v-if="errorMessage" class="error-msg">{{ errorMessage }}</p>
<form id="loginForm" @submit.prevent="submitLogin">
<div class="form-group">
@@ -112,7 +114,7 @@
import { onMounted, ref, watch } from 'vue'
import { useRouter } from 'vue-router'
import { loginWithDevice } from '@/shared/api/user'
import { KICK_NOTICE_KEY, SESSION_EXPIRED_NOTICE_KEY } from '@/shared/auth/kick-handler'
import { ACCOUNT_DELETED_NOTICE_KEY, ACCOUNT_DISABLED_NOTICE_KEY, KICK_NOTICE_KEY, SESSION_EXPIRED_NOTICE_KEY } from '@/shared/auth/kick-handler'
import { COMPANY_NAME_STORAGE_KEY, writeCompanyIdentity } from '@/shared/auth/company-identity'
import { clearAccountExpiry, writeAccountExpiry } from '@/shared/auth/account-expiry'
import { useVersionUpdate } from '@/shared/composables/useVersionUpdate'
@@ -137,6 +139,8 @@ const loggingIn = ref(false)
const errorMessage = ref('')
const kickedNotice = ref(false)
const expiredNotice = ref(false)
const disabledNotice = ref(false)
const deletedNotice = ref(false)
const rememberPassword = ref(false)
const autoLogin = ref(false)
const updateOpen = ref(false)
@@ -295,6 +299,16 @@ function isSessionExpiredNav(): boolean {
return lsGet(SESSION_EXPIRED_NOTICE_KEY) === '1'
}
/** 账号被管理员停用后跳回登录页:标记由 kick-handler 按后端 X-Auth-Reason 写入 */
function isAccountDisabledNav(): boolean {
return lsGet(ACCOUNT_DISABLED_NOTICE_KEY) === '1'
}
/** 账号被删除后跳回登录页:同上,与停用/过期分开存 */
function isAccountDeletedNav(): boolean {
return lsGet(ACCOUNT_DELETED_NOTICE_KEY) === '1'
}
function togglePassword() {
passwordVisible.value = !passwordVisible.value
}
@@ -510,12 +524,27 @@ onMounted(() => {
lsRemove(SESSION_EXPIRED_NOTICE_KEY)
}
if (isAccountDisabledNav()) {
// 账号已被管理员停用:同样关自动登录,标记展示后即清。
disabledNotice.value = true
autoLogin.value = false
lsSet(AUTO_LOGIN_KEY, '0')
lsRemove(ACCOUNT_DISABLED_NOTICE_KEY)
}
if (isAccountDeletedNav()) {
deletedNotice.value = true
autoLogin.value = false
lsSet(AUTO_LOGIN_KEY, '0')
lsRemove(ACCOUNT_DELETED_NOTICE_KEY)
}
// 恢复记住的凭据并尝试自动登录(桌面与网页形态一致;登出/切号导航由 tryAutoLogin 内部豁免)
// loadCredentials 现为异步(AES 解密),须先恢复密码再触发自动登录
void (async () => {
await loadCredentials()
if (kickedNotice.value || expiredNotice.value) {
// 刚被顶下线或登录态失效:不自动重登,等用户手动点登录(此时顶掉对方,最后登录者胜)
if (kickedNotice.value || expiredNotice.value || disabledNotice.value || deletedNotice.value) {
// 刚被顶下线/登录态失效/停用/删除:不自动重登,等用户手动点登录(此时顶掉对方,最后登录者胜)
autoLogin.value = false
return
}
+8 -3
View File
@@ -5,7 +5,7 @@ import axios, {
type AxiosResponse,
type InternalAxiosRequestConfig,
} from 'axios'
import { handleKicked, handleSessionExpired, isKickedPayload, isUnauthorizedPayload } from '../auth/kick-handler.ts'
import { authReasonOf, handleKicked, handleSessionExpired, isKickedPayload, isUnauthorizedPayload } from '../auth/kick-handler.ts'
export interface LegacyApiSuccess<T> {
success: true
@@ -61,12 +61,17 @@ function responseStatusOf(error: unknown): unknown {
return (error as { response?: { status?: unknown } } | null | undefined)?.response?.status
}
/** 从 axios 错误对象里取响应头(兼容真实 AxiosError 与测试桩)。 */
function responseHeadersOf(error: unknown): unknown {
return (error as { response?: { headers?: unknown } } | null | undefined)?.response?.headers
}
/** 响应成功分支:Java 业务错误是 HTTP 200 + body.code,下线收口必须在这里也判。 */
export function onResponseFulfilled(response: AxiosResponse): AxiosResponse {
if (isKickedPayload(response.data)) {
handleKicked()
} else if (isUnauthorizedPayload(response.data)) {
handleSessionExpired()
handleSessionExpired(authReasonOf(response.headers))
}
return response
}
@@ -77,7 +82,7 @@ export function onResponseRejected(error: unknown): Promise<never> {
if (isKickedPayload(payload)) {
handleKicked()
} else if (isUnauthorizedPayload(payload) || responseStatusOf(error) === 401) {
handleSessionExpired()
handleSessionExpired(authReasonOf(responseHeadersOf(error)))
}
return Promise.reject(new Error(extractErrorMessage(error)))
}
+31 -6
View File
@@ -28,6 +28,21 @@ export const UNAUTHORIZED_CODE = 401
/** 登录页据此标记显示"登录已失效"。与互踢分开存:两种成因不能互相冒充。 */
export const SESSION_EXPIRED_NOTICE_KEY = 'aiimage_session_expired_notice'
/** 登录页据此标记显示"账号已被停用"。与其它成因分开存:四种成因不能互相冒充。 */
export const ACCOUNT_DISABLED_NOTICE_KEY = 'aiimage_account_disabled_notice'
/** 登录页据此标记显示"账号已被删除"。 */
export const ACCOUNT_DELETED_NOTICE_KEY = 'aiimage_account_deleted_notice'
/** 后端 X-Auth-Reason 头携带的会话失效成因;空串=未点名(令牌过期等)。 */
export type AuthReason = 'disabled' | 'deleted' | ''
/** 从 axios 响应头里读会话失效成因(axios 归一化为全小写键名)。 */
export function authReasonOf(headers: unknown): AuthReason {
const value = (headers as Record<string, unknown> | null | undefined)?.['x-auth-reason']
return value === 'disabled' || value === 'deleted' ? value : ''
}
/** 本次页面生命周期内是否已发起跳转(并发 4011 只跳一次;整页跳转后 window 重建自然重置)。 */
type KickWindow = Window & { __aiimageKickRedirected?: boolean }
@@ -96,12 +111,14 @@ function clearLocalSession(): void {
}
}
/** 亮出这一种成因的标记,同时清掉另一种:两个标记都在时登录页会说出错的那句。 */
function setAuthNotice(key: string, otherKey: string): void {
/** 亮出这一种成因的标记,同时清掉其它三种:多个标记都在时登录页会说出错的那句。 */
function setAuthNotice(key: string, otherKeys: readonly string[]): void {
try {
const storage = window.localStorage
storage.setItem(key, '1')
storage.removeItem(otherKey)
for (const other of otherKeys) {
storage.removeItem(other)
}
} catch {
/* 忽略存储异常 */
}
@@ -127,7 +144,7 @@ export function handleKicked(): void {
return
}
clearLocalSession()
setAuthNotice(KICK_NOTICE_KEY, SESSION_EXPIRED_NOTICE_KEY)
setAuthNotice(KICK_NOTICE_KEY, [SESSION_EXPIRED_NOTICE_KEY, ACCOUNT_DISABLED_NOTICE_KEY, ACCOUNT_DELETED_NOTICE_KEY])
clearDesktopCurrentUid()
redirectToLogin('/login?kicked=1', '[auth] 账号已在其他设备登录,本设备下线,跳转登录页')
}
@@ -141,7 +158,7 @@ export function handleKicked(): void {
* 只在"本端自认为已登录"时收口:匿名请求拿 401 是常态噪声(未登录打开首页、登录前的
* 引导接口),为它清存储并整页跳转,会把一次无害的 401 变成"页面自己弹回登录页"。
*/
export function handleSessionExpired(): void {
export function handleSessionExpired(reason: AuthReason = ''): void {
if (typeof window === 'undefined') {
return
}
@@ -149,7 +166,15 @@ export function handleSessionExpired(): void {
return
}
clearLocalSession()
setAuthNotice(SESSION_EXPIRED_NOTICE_KEY, KICK_NOTICE_KEY)
// 成因点名:后端 X-Auth-Reason 说停用/删除就亮对应的标记,登录页照它说话;
// 没带成因(旧 jar 部署窗口、非本成因的 401)回落到通用「登录已失效」。
if (reason === 'disabled') {
setAuthNotice(ACCOUNT_DISABLED_NOTICE_KEY, [KICK_NOTICE_KEY, SESSION_EXPIRED_NOTICE_KEY, ACCOUNT_DELETED_NOTICE_KEY])
} else if (reason === 'deleted') {
setAuthNotice(ACCOUNT_DELETED_NOTICE_KEY, [KICK_NOTICE_KEY, SESSION_EXPIRED_NOTICE_KEY, ACCOUNT_DISABLED_NOTICE_KEY])
} else {
setAuthNotice(SESSION_EXPIRED_NOTICE_KEY, [KICK_NOTICE_KEY, ACCOUNT_DISABLED_NOTICE_KEY, ACCOUNT_DELETED_NOTICE_KEY])
}
clearDesktopCurrentUid()
redirectToLogin('/login?expired=1', '[auth] 登录态已失效,本设备下线,跳转登录页')
}