Skip to content

TPN으로 사용자의 상세 정보 조회

TPN으로 사용자의 상세 정보를 조회합니다.

HTTP 요청

http
GET https://<your-console-host>/api/v1/iam/authn/users/{tpn}

URI 매개변수

이름위치필수형식설명
tpnpath필수string사용자 TPN. 길이 1~

요청 헤더

인증 헤더는 모든 API 가 같습니다. 공통 규약을 참고하십시오.

응답

상태 코드설명
200 OKSuccessful Response
422 Unprocessable EntityValidation Error

위 표는 정상 응답과 요청 검증 실패만 나열합니다. 이 API 는 그 밖에 401(인증 실패) · 403(권한 없음) · 404(리소스 없음) · 502(인프라 오류)를 반환할 수 있습니다. 조건은 오류 처리를 참고하십시오.

응답 본문 — 200

이름필수형식설명
message선택string 또는 null응답 메시지
timestamp선택string응답 생성 시간
requestId필수string요청 식별자
result필수object결과 데이터
result.tpn필수string
result.orgId선택string 또는 null
result.username필수string
result.displayName선택string 또는 null
result.email선택string 또는 null
result.status필수string
result.lastSignIn선택string 또는 null
result.presence선택string값: online, offline. 기본값 "offline"
result.groups선택array (object)
result.groups[].groupId필수string그룹 ID
result.groups[].groupTpn선택string 또는 null그룹 TPN
result.groups[].displayName선택string 또는 null그룹 이름
result.roles선택array (object)
result.roles[].roleId필수string역할 ID
result.roles[].roleName선택string 또는 null역할 이름
result.roles[].assignedAt선택string 또는 null할당 시각 (ISO8601)
result.failedLoginCount선택integer현재 로그인 실패 횟수 (max 도달 시 status=disabled로 변경). 기본값 0
result.mfaEnabled선택boolean기본값 false
result.mfaEmailEnabled선택boolean기본값 false
result.mfaTotpEnabled선택boolean기본값 false
result.region선택string 또는 null
result.tags선택object 또는 null
result.idpKind선택string 또는 null
result.idpRealm선택string 또는 null
result.forcePasswordChange선택boolean기본값 false
result.defaultOrgId선택string 또는 null
result.createdAt선택string 또는 null
result.updatedAt선택string 또는 null

Thaki Cloud Aegis — 연동 개발자용 API 문서