import { getApiClient } from '../api/ApiClient'; import { createLogger } from '../utils/Logger'; const logger = createLogger('AuthManager'); /** * DevTools 추적 헬퍼 */ function trackAuthEvent( type: 'login' | 'logout' | 'token-refresh' | 'token-expired' | 'session-restored' | 'permission-denied' | 'api-unauthorized', success: boolean, error?: string, details?: Record ): void { try { const G7Core = (window as any).G7Core; G7Core?.devTools?.trackAuthEvent?.(type, success, error, details); } catch { // DevTools 추적 실패 무시 } } /** * 인증 타입 */ export type AuthType = 'admin' | 'user'; /** * 인증 설정 인터페이스 */ export interface AuthConfig { type: AuthType; loginPath: string; defaultPath: string; userEndpoint: string; loginEndpoint: string; logoutEndpoint: string; refreshEndpoint: string; } /** * 인증된 사용자 정보 */ export interface AuthUser { uuid: string; name: string; email: string; [key: string]: any; } /** * 인증 상태 */ export interface AuthState { isAuthenticated: boolean; user: AuthUser | null; type: AuthType | null; } /** * 이벤트 핸들러 타입 */ type EventHandler = (...args: any[]) => void; /** * 기본 인증 설정 */ const defaultConfigs: Record = { admin: { type: 'admin', loginPath: '/admin/login', defaultPath: '/admin', userEndpoint: '/admin/auth/user', loginEndpoint: '/auth/admin/login', logoutEndpoint: '/admin/auth/logout', refreshEndpoint: '/admin/auth/refresh', }, user: { type: 'user', loginPath: '/login', defaultPath: '/', userEndpoint: '/auth/user', loginEndpoint: '/auth/login', logoutEndpoint: '/auth/logout', refreshEndpoint: '/auth/refresh', }, }; /** * AuthManager 클래스 * * 인증 상태 관리 및 토큰 갱신을 담당하는 싱글톤 클래스입니다. */ export class AuthManager { private static instance: AuthManager; private state: AuthState; private config: Map; private isRefreshing: boolean = false; private refreshPromise: Promise | null = null; private eventHandlers: Map = new Map(); /** 로케일 스토리지 키 (TemplateApp과 동일) */ private static readonly LOCALE_STORAGE_KEY = 'g7_locale'; private constructor() { this.state = { isAuthenticated: false, user: null, type: null, }; this.config = new Map(); this.config.set('admin', defaultConfigs.admin); this.config.set('user', defaultConfigs.user); } /** * 싱글톤 인스턴스 반환 */ static getInstance(): AuthManager { if (!AuthManager.instance) { AuthManager.instance = new AuthManager(); } return AuthManager.instance; } /** * 이벤트 핸들러 등록 */ on(event: string, handler: EventHandler): void { if (!this.eventHandlers.has(event)) { this.eventHandlers.set(event, []); } this.eventHandlers.get(event)!.push(handler); } /** * 이벤트 발생 */ private emit(event: string, ...args: any[]): void { const handlers = this.eventHandlers.get(event); if (handlers) { handlers.forEach(handler => handler(...args)); } } /** * 인증 상태 확인 */ isAuthenticated(): boolean { return this.state.isAuthenticated; } /** * 현재 사용자 정보 반환 */ getUser(): AuthUser | null { return this.state.user; } /** * 현재 인증 타입 반환 */ getAuthType(): AuthType | null { return this.state.type; } /** * 백엔드 API로 인증 상태 확인 * * @param type - 인증 타입 (admin 또는 user) * @returns 인증 여부 */ async checkAuth(type: AuthType): Promise { const apiClient = getApiClient(); const token = apiClient.getToken(); // 토큰이 없으면 미인증 if (!token) { this.clearState(); return false; } const config = this.config.get(type); if (!config) { logger.error(`Unknown auth type: ${type}`); return false; } try { // 사용자 정보 조회 API 호출 const response = await apiClient.get<{ success: boolean; data: AuthUser }>(config.userEndpoint); if (response.success && response.data) { this.state = { isAuthenticated: true, user: response.data, type: type, }; this.emit('authStateChange', this.state); return true; } this.clearState(); return false; } catch (error: any) { // 401 에러인 경우 토큰 갱신 시도 if (error.response?.status === 401) { const refreshed = await this.refreshToken(); if (refreshed) { // 갱신 성공 후 다시 인증 확인 return this.checkAuth(type); } } this.clearState(); return false; } } /** * 사용자 정보 프리로드 (병렬 로딩용) * * checkAuth와 동일하지만 에러를 throw하지 않고 조용히 실패합니다. * * @param type - 인증 타입 (admin 또는 user) * @returns 인증 여부 */ async preloadAuth(type: AuthType): Promise { try { return await this.checkAuth(type); } catch (error) { logger.warn(`Preload auth failed for type ${type}:`, error); return false; } } /** * 로그인 처리 * * @param type - 인증 타입 * @param credentials - 로그인 자격 증명 * @param options - 추가 옵션 (headers 등) * @returns 인증된 사용자 정보 */ async login( type: AuthType, credentials: { email: string; password: string }, options?: { headers?: Record } ): Promise { const apiClient = getApiClient(); const config = this.config.get(type); if (!config) { throw new Error(`Unknown auth type: ${type}`); } // 로그인 엔드포인트 결정 const loginEndpoint = type === 'admin' ? defaultConfigs.admin.loginEndpoint : defaultConfigs.user.loginEndpoint; try { // 추가 헤더 설정 (globalHeaders 지원) const requestConfig = options?.headers ? { headers: options.headers } : undefined; const response = await apiClient.post<{ success: boolean; data: { token: string; user: AuthUser; }; }>(loginEndpoint, credentials, requestConfig); if (response.success && response.data) { // 토큰 저장 apiClient.setToken(response.data.token); // 사용자의 language 설정 확인 및 로케일 변경 처리 const userLanguage = response.data.user.language; const currentLocale = localStorage.getItem(AuthManager.LOCALE_STORAGE_KEY); const localeChanged = userLanguage && userLanguage !== currentLocale; if (userLanguage) { try { localStorage.setItem(AuthManager.LOCALE_STORAGE_KEY, userLanguage); } catch (error) { logger.warn('Failed to save user language to localStorage:', error); } } // 상태 업데이트 this.state = { isAuthenticated: true, user: response.data.user, type: type, }; this.emit('login', this.state); this.emit('authStateChange', this.state); // DevTools 추적 trackAuthEvent('login', true, undefined, { userId: response.data.user.uuid, email: response.data.user.email, type, }); // 로케일이 변경된 경우 TemplateApp 재초기화 if (localeChanged && (window as any).__templateApp) { // changeLocale은 비동기이므로 await 하지 않고 실행 // navigate가 먼저 실행되고, changeLocale이 완료되면 UI가 업데이트됨 (window as any).__templateApp.changeLocale(userLanguage); } return response.data.user; } throw new Error('Login failed'); } catch (error: any) { this.clearState(); // Axios 에러에서 API 응답 메시지 추출 // error.response.data.message가 실제 서버 응답 메시지 const apiMessage = error.response?.data?.message; const enhancedError: any = new Error(apiMessage || error.message || 'Login failed'); enhancedError.response = error.response; enhancedError.status = error.response?.status; // DevTools 추적 trackAuthEvent('login', false, enhancedError.message, { type, status: error.response?.status, }); throw enhancedError; } } /** * 로그아웃 처리 */ async logout(): Promise { const apiClient = getApiClient(); const config = this.state.type ? this.config.get(this.state.type) : null; try { // 백엔드 로그아웃 API 호출 if (config) { await apiClient.post(config.logoutEndpoint); } } catch (error) { logger.warn('Logout API call failed:', error); } finally { // 토큰 삭제 apiClient.removeToken(); // 상태 초기화 const previousState = { ...this.state }; this.clearState(); this.emit('logout', previousState); this.emit('authStateChange', this.state); // DevTools 추적 trackAuthEvent('logout', true, undefined, { previousType: previousState.type, }); // 로그인 페이지로 리다이렉트 (queryString 포함) if (config && previousState.type) { const returnUrl = window.location.pathname + window.location.search; window.location.href = this.getLoginRedirectUrl(previousState.type, returnUrl); } } } /** * 토큰 갱신 * * @returns 갱신 성공 여부 */ async refreshToken(): Promise { // 이미 갱신 중이면 기존 Promise 반환 if (this.isRefreshing && this.refreshPromise) { return this.refreshPromise; } this.isRefreshing = true; this.refreshPromise = this.doRefreshToken(); try { return await this.refreshPromise; } finally { this.isRefreshing = false; this.refreshPromise = null; } } /** * 실제 토큰 갱신 수행 */ private async doRefreshToken(): Promise { const authType = this.state.type; if (!authType) return false; const config = this.config.get(authType); if (!config) return false; const apiClient = getApiClient(); try { const response = await apiClient.post<{ success: boolean; data: { token: string; }; }>(config.refreshEndpoint); if (response.success && response.data?.token) { apiClient.setToken(response.data.token); this.emit('tokenRefreshed'); // DevTools 추적 trackAuthEvent('token-refresh', true, undefined, { type: authType }); return true; } // DevTools 추적 (실패 - 응답은 있지만 토큰 없음) trackAuthEvent('token-refresh', false, 'No token in response', { type: authType }); return false; } catch (error) { logger.error('Token refresh failed:', error); // DevTools 추적 (실패 - 예외) trackAuthEvent('token-refresh', false, error instanceof Error ? error.message : 'Unknown error', { type: authType, }); return false; } } /** * 보호된 라우트 접근 시 로그인 리다이렉트 URL 생성 * * @param type - 인증 타입 * @param returnUrl - 로그인 후 돌아갈 URL * @param reason - 리다이렉트 사유 (예: 'session_expired') — 로그인 페이지 안내 분기용 * @returns 로그인 페이지 URL (redirect 파라미터 포함) */ getLoginRedirectUrl(type: AuthType, returnUrl: string, reason?: string): string { const config = this.config.get(type); if (!config) { return '/login'; } const encodedReturnUrl = encodeURIComponent(returnUrl); let url = `${config.loginPath}?redirect=${encodedReturnUrl}`; if (reason) { url += `&reason=${encodeURIComponent(reason)}`; } return url; } /** * 인증 설정 부분 갱신 (템플릿 부트스트랩에서 호출) * * 템플릿이 자체 로그인 경로를 사용하는 경우 `initTemplate` 단계에서 호출하여 * 코어 디폴트(`/login`, `/admin/login`)를 오버라이드한다. 모듈/플러그인에서 * 호출하면 다른 템플릿에 침범하므로 금지 — 가이드 문서 참조. * * 보안: `loginPath` 는 동일 origin path-only(`/`로 시작, `//` 금지)만 허용한다. * 외부 origin URL 또는 protocol-relative URL 을 허용하면 open redirect 취약점이 된다. * * @param type - 인증 타입 * @param partial - 갱신할 설정 (loginPath, defaultPath 등) * @throws Error loginPath 가 path-only 형식이 아닐 때 */ updateConfig(type: AuthType, partial: Partial): void { if (partial.loginPath !== undefined) { const path = partial.loginPath; if (!path.startsWith('/') || path.startsWith('//')) { throw new Error( `AuthManager.updateConfig: loginPath must be a same-origin path starting with '/' (got: ${path})` ); } } const current = this.config.get(type); if (current) { this.config.set(type, { ...current, ...partial }); } } /** * 로그인 후 리다이렉트 URL 가져오기 * * URL 파라미터에서 redirect 값을 읽어 반환합니다. * * @param type - 인증 타입 * @returns 리다이렉트할 URL */ getRedirectUrl(type: AuthType): string { const config = this.config.get(type); const defaultPath = config?.defaultPath || '/'; // URL 파라미터에서 redirect 값 읽기 const urlParams = new URLSearchParams(window.location.search); const redirectUrl = urlParams.get('redirect'); if (redirectUrl) { // 보안: 같은 도메인 경로만 허용 try { const decoded = decodeURIComponent(redirectUrl); if (decoded.startsWith('/')) { return decoded; } } catch { // 디코딩 실패 시 기본 경로 반환 } } return defaultPath; } /** * 인증 설정 조회 */ getConfig(type: AuthType): AuthConfig | undefined { return this.config.get(type); } /** * 상태 초기화 */ private clearState(): void { this.state = { isAuthenticated: false, user: null, type: null, }; } /** * 테스트용 인스턴스 초기화 */ static resetInstance(): void { AuthManager.instance = null as any; } } export default AuthManager;