관리자 접속 이벤트

GET https://openapi.exosp.com/audit/v1/admin/access

관리자 접속 이벤트를 조회하는 API 입니다.

Query Parameters

항목	타입	설명
offset*	int	((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*	int	페이지 사이즈
timezone	string	응답 데이터 타임존https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 에서 TZ identifier 참고기본값 : UTC
sortType*	string	응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순

Response Schema

항목	타입	설명
code	int	응답 처리 결과 코드 0 : 성공, 1 : 실패
message	string	응답 처리 결과 메세지 success : 성공, 그 외 : 실패
body	object	body 상세

body 상세

항목	타입	설명
searchDate	string	조회날짜
total	int	전체 레코드 수
data	array	data 상세

data 상세

항목	타입	설명
name	string	사용자 이름
email	string	사용자 메일
departmentFull	string	그룹 전체 경로
permission	string	관리 권한 Super Admin : 대표 관리자 Full : 모든 권한 Partial Permission : 일부 권한 Approval : 승인관리 View logs : 로그조회
eventType	string	이벤트 유형 Login : 로그인 Login Fail : 로그인 실패 Account Lockout : 계정 잠금 Account Unlock : 계정 잠금 해제 Logout : 로그아웃 Change Password : 비밀번호 변경
eventDetailData	string	이벤트 유형 상세 Enable two-step verification : 2단계 인증 활성화 Disable two-step verification : 2단계 인증 비활성화 Password continuation error {} times : 비밀번호 연속 오류 {}회 Account Lockout : 계정 잠금 IP not allowed : 허용되지 않은 IP Account Unlock Time : 계정 잠금 해제 시각 Unlocked by another admin : 다른 관리자에 의해 잠금 해제 Email Authentication : 이메일 인증 Change Password : 비밀번호 변경 Valid Time Expired : 유효시간 만료 Duplicate Login : 중복 로그인 Administrator privileges expired : 관리자 권한 만료 Enabled : 활성화 Disabled : 비활성화
ip	string	IP
userAgent	string	클라이언트의 브라우저
dateOfEntryUTC	string	정책 생성 시각 UTC 기준, ISO 8601포맷
dateOfEntry	string	정책 생성 시각 요청 타임존 기준, ISO 8601포맷

Example

200 Success

curl -X 'GET' \
  'https://openapi.exosp.com/audit/v1/admin/access?offset=0&tableSize=1000&timezone=Asia%2FSeoul&sortType=DESC' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "searchDate": "2025-10-31 ~ 2026-01-30",
    "total": 1,
    "data": [
      {
        "name": "ysmoon",
        "email": "[email protected]",
        "departmentFull": "dev-ys",
        "permission": "Super Admin",
        "eventType": "Login Fail",
        "eventDetail": "Password continuation error 1 times",
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "DateOfEntryUTC": "2026-01-12T08:49:38+00:00",
        "DateOfEntry": "2026-01-12T17:49:38+09:00"
      }
    ]
  }
}