> 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/user-policy-setting.md).

# 에이전트 설치 및 삭제 이벤트

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

사용자 정보를 조회하는 API 입니다.

### Query Parameters

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

### 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>total</td><td>int</td><td><strong>전체 레코드 수</strong></td></tr><tr><td>searchDate</td><td>string</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>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>eventType</td><td>string</td><td><p><strong>이벤트 유형</strong></p><ul><li>Installation : 설치</li><li>Admin Delete : 관리자 삭제</li><li>Agent Direct Delete : 에이전트 직접 삭제</li><li>Deletion via User Page : 사용자페이지 통한 삭제</li></ul></td></tr><tr><td>osType</td><td>string</td><td><strong>OS 종류</strong></td></tr><tr><td>osVersion</td><td>string</td><td><strong>OS 버전</strong></td></tr><tr><td>ip</td><td>string</td><td><strong>IP</strong></td></tr><tr><td>macAddress</td><td>string</td><td><strong>컴퓨터 MAC 주소</strong></td></tr><tr><td>agentVersion</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/user/policy-setting?offset=0&tableSize=1&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": 89,
    "data": [
      {
        "name": "Exosphere Support Team(support@exosp.com)",
        "departmentFull": "-",
        "computerName": "abc Mac mini",
        "eventType": "Agent Direct Delete",
        "osType": "macos",
        "osVersion": "26.2.0",
        "ip": "192.168.0.171",
        "macAddress": "|f6:f7:c1:45:f3:d2|f6:f7:c1:45:f3:d3|f6:f7:c1:45:f3:b2|36:bc:38:19:e6:c0|36:bc:38:19:e6:c4|f6:f7:c1:45:f3:b3|18:4a:53:11:43:1d|18:4a:53:23:49:aa",
        "agentVersion": "1.28.0",
        "dateOfEntryUTC": "2026-01-27T05:51:04+00:00",
        "dateOfEntry": "2026-01-27T14:51:04+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}