인증 상태

GET /v1/auth/status

민감 정보를 가린 인증 프로필과 Minara 세션 및 연결 상태를 조회합니다.

응답 본문

{
  "minara_connected": true,
  "minara_oauth_connected": true,
  "minara_source": "oauth-profile",
  "minara_session": {
    "state": "present",
    "connection": "ready"
  },
  "minara_account_scope": "opaque-account-scope",
  "minara_credential_revision": "opaque-credential-revision"
}

참고

예시는 Minara 필드만 보여 줍니다. 응답에는 제공자 설정과 민감 정보를 가린 프로필도 포함됩니다. minara_session.state는 absent, present, reauth_required, unknown 중 하나입니다. 독립적인 connection은 ready, refreshing, unavailable 중 하나입니다. present는 로컬 권한 부여 정보를 유지한다는 뜻이며 서버에 연결할 수 없는 상태일 수도 있습니다. unknown은 자격 증명을 일시적으로 읽을 수 없는 상태입니다. 선택적 reason은 명확한 거부나 키 저장소 문제를 설명합니다. 연결을 사용할 수 없다는 이유만으로 로그인을 시작하지 마세요.

minara_account_scope는 내부 형식을 해석하지 않는 캐시 구분 값입니다. 값이 바뀌면 계정에 연결된 캐시를 지우세요. 자격 증명을 읽을 수 없을 때 이 필드가 생략될 수 있으며, 생략만으로 로그아웃을 판단해서는 안 됩니다. 값을 파싱하거나 인증에 사용하지 마세요. 기존 연결 불리언 값도 계속 제공합니다. minara_oauth_connected에는 OAuth ID가 필요하므로 API key로 Web 앱의 잠금을 해제할 수 없습니다.

minara_credential_revision은 적용된 자격 증명의 불투명한 버전 식별자입니다. token 교체, 자격 증명이나 백엔드 변경, 프로세스 재시작 시 바뀌며 읽을 수 있는 자격 증명이 없으면 생략됩니다. 알고 있는 버전이 바뀌면 일시 중지된 읽기를 서버에 다시 시도할 수 있습니다. 계정 구분이 같으면 캐시를 유지합니다. 값이 같거나 없으면 읽기 중지를 해제하지 않습니다. 새 버전은 권한 상승을 뜻하지 않으며 서버가 다시 인증을 요구할 수 있습니다. 실패한 쓰기를 자동 재실행하거나 이 식별자를 인증에 사용하지 마세요.