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
+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] 登录态已失效,本设备下线,跳转登录页')
}