> For the complete documentation index, see [llms.txt](https://openapi-docs.exosp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openapi-docs.exosp.com/guide/logs/audit/policy-setting.md).

# 관리자 접속 이벤트

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/audit/v1/admin/access`

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

### Query Parameters

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

### Response Schema

<table><thead><tr><th width="162">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>code</td><td>int</td><td><p><strong>응답 처리 결과 코드</strong> </p><p>0 : 성공, 1 : 실패</p></td></tr><tr><td>message</td><td>string</td><td><p><strong>응답 처리 결과 메세지</strong></p><p>success : 성공, 그 외 : 실패</p></td></tr><tr><td>body</td><td>object</td><td><a data-mention href="#body">#body</a></td></tr></tbody></table>

#### **body 상세**

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>searchDate</td><td>string</td><td><strong>조회날짜</strong></td></tr><tr><td>total</td><td>int</td><td><strong>전체 레코드 수</strong></td></tr><tr><td>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

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

### Example

{% tabs %}
{% tab title="200 Success" %}

```javascript
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": "ysmoon1@exosp.com",
        "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"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}