/inspector:auth — 로그인 상태 점검기#

한마디로#

실행 중인 앱이 "지금 로그인이 제대로 되어 있는지, 출입증(토큰)이 살아 있는지"를 실시간으로 들여다보는 점검 도구입니다. 건물 출입 게이트에서 방문증이 유효한지, 언제 만료되는지 확인해 주는 안내 데스크라고 보면 됩니다.

누가·언제 쓰나요#

• 로그인이 안 되거나 자꾸 풀릴 때
• "401 권한 없음" 같은 인증 오류가 날 때
• 토큰(출입증)이 만료됐는지, 사용자 권한이 충분한지 확인하고 싶을 때

주로 개발자나 AI 에이전트가 앱 동작 중에 인증 관련 문제를 진단할 때 사용합니다.

무엇을 해주나요#

실행 중인 앱에 직접 물어봐서 두 가지 정보를 알려 줍니다.

• 인증 상태(auth_get_status) — 로그인 여부, 로그인 방식, 그리고 access/refresh 토큰이 살아 있는지·언제 만료되는지
• 사용자 정보(auth_get_user) — 현재 로그인한 사용자의 ID, 이메일, 이름, 권한(roles)

어떻게 쓰나요#

/inspector/auth status
/inspector/auth user
/inspector/auth token

• status — 지금 로그인되어 있는지 전체 인증 상태를 확인합니다.
• user — 현재 로그인한 사용자가 누구인지(권한 포함) 확인합니다.
• token — 출입증(토큰)이 언제 만료되는지 등 토큰 상태를 자세히 확인합니다.

안에서 무슨 일이 벌어지나요#

문제 유형별로 정해진 순서대로 원인을 좁혀 갑니다.

• 로그인이 안 될 때 — 인증 상태를 확인하고, 토큰 상태를 본 뒤, 로그인 흐름을 점검합니다.
• 401 권한 오류 — 토큰이 만료됐는지, refresh 토큰은 살아 있는지 보고, 토큰 갱신 로직을 점검합니다.
• 권한 부족 오류 — 사용자의 권한(roles)을 확인해 필요한 권한과 비교하고, 권한 체크 로직을 점검합니다.
• 자동 로그아웃 — 토큰 만료 시점과 세션 타임아웃 설정을 확인하고, 토큰 갱신 타이밍을 점검합니다.

{
   " isAuthenticated " : true,
   " authMethod " :  " email " ,
   " tokenStatus " : {
     " accessToken " : {
       " exists " : true,
       " expiresAt " :  " 2024-01-01T12:00:00Z " ,
       " isExpired " : false,
       " expiresIn " :  " 45 minutes " 
     },
     " refreshToken " : {
       " exists " : true,
       " expiresAt " :  " 2024-01-08T10:00:00Z " ,
       " isExpired " : false
    }
  }
}

{
   " user " : {
     " id " : 123,
     " email " :  " user@example.com " ,
     " name " :  " Hong Gildong " ,
     " roles " : [ " user " ,  " premium " ],
     " createdAt " :  " 2023-06-15T10:00:00Z " 
   }
}

1. auth_get_status - >   Check authentication status
2. Verify tokenStatus
3. Review login flow

1. auth_get_status - >   Check token expiration
2. Check refreshToken status
3. Review token renewal logic

1. auth_get_user - >   Check user roles
2. Compare with required permissions
3. Review permission check logic

1. auth_get_status - >   Check token expiration time
2. Check session timeout settings
3. Review token renewal timing

/inspector/auth status

/inspector/auth user

/inspector/auth token