# Welcome!

엑소스피어는 악성코드방어와 정보 유출 예방(DLP)을 하나의 서비스로 제공하여 다양한 보안 위협으로부터 기업의 데이터를 보호하는 올인원 PC 보안 서비스입니다.

## 엑소스피어 OpenAPI란?

엑소스피어 OpenAPI는 엑소스피어에서 수집된 로그와 현황 데이터를 외부 서비스와 손쉽게 연동할 수 있도록 지원하는 서비스입니다.

RESTful API 형태로 제공되며, 다양한 애플리케이션에서 엑소스피어의 데이터를 통합하고 활용할 수 있습니다.

이 문서에서는 엑소스피어 OpenAPI의 사용을 돕기 위해 개발자에게 필요한 규칙과 제한사항, 그리고 개발 명세를 안내합니다.

OpenAPI와 관련된 질문은 [엑소스피어 서포트팀](https://exolabs-support.channel.io/home)에 문의해 주세요. :relaxed:

{% hint style="success" %}
API 사용은 비즈니스 목적으로만 허용되며, 공공 또는 상업적인 목적으로 재배포하거나 판매하는 행위는 금지됩니다.
{% endhint %}


# API 키

OpenAPI를 사용하기 위해 먼저 API 키를 발급받아야 합니다. API키는 요청 클라이언트의 정보를 확인하고 인증하는 역할을 합니다.

## API키 발급 방법

1. 엑소스피어 [관리자 페이지](https://admin.exosp.com)에 로그인 합니다.
2. 서비스 관리 > 개발자 도구 > OpenAPI 로 이동합니다. 
3. API 키 관리 섹션에서 \[API 키 발급] 버튼을 클릭합니다.
4. 생성된 API 키를 안전한 장소에 보관합니다. 

{% hint style="warning" %}
Secret Key는 발급 시 단 한 번만 온전한 값이 표시됩니다. 분실한 경우 기존 키를 삭제하고 새 키를 발급 받으세요.
{% endhint %}

{% hint style="info" %}
API 키는 최대 2개까지 생성 가능합니다.
{% endhint %}

## API 요청 시 API 키 포함 방법

API 키를 발급받은 후, 이를 API 요청 헤더에 포함시켜야 합니다. 

### 요청 헤더

<table><thead><tr><th width="263">헤더 명</th><th>필드 값</th></tr></thead><tbody><tr><td>x-exosp-access</td><td>발급 받은 Access Key</td></tr><tr><td>x-exosp-secret</td><td>발급 받은 Secret Key</td></tr></tbody></table>

### API 키 에러

<table><thead><tr><th width="317">에러 메세지</th><th>해결 방법</th></tr></thead><tbody><tr><td>Invalid API Key: x-exosp-access.</td><td>x-exosp-access 값을 다시 확인해주세요.</td></tr><tr><td>Not Found API Key: x-exosp-access.</td><td>발급된 Access Key 인지 확인해주세요.</td></tr><tr><td>Invalid API Key: x-exosp-secret.</td><td>x-exosp-secret 값을 다시 확인해주세요.</td></tr><tr><td>Not Found API Key: x-exosp-secret.</td><td>Access Key와 매칭된 Secret Key를 사용하고 있는지 확인해주세요.</td></tr></tbody></table>


# API 요청 및 응답 모델

## 주의 및 제한 사항

* 모든 API 요청에는 유효한 x-exosp-access와 x-exosp-secret 헤더가 포함되어야 합니다.
* 일일 총 호출횟수는 발급한 모든 API 키의 호출 횟수를 합산하여 최대 1,000번의 API 호출이 허용됩니다.
* 호출 횟수는 매일 00:00(KST, UTC+9)에 초기화 됩니다.&#x20;
* 한 번의 호출로 최대 1,000개의 레코드만 요청할 수 있습니다
* 관리자 페이지 > 서비스 관리 > 개발자 도구 > OpenAPI 에서 오늘의 호출 횟수를 확인할 수 있습니다.
* 대량의 데이터를 요청할 경우, 페이징 기법을 사용하세요.
* 요청 및 응답에 포함된 모든 시간 데이터는 ISO 8601 형식을 따릅니다.
* 응답 데이터는 JSON 형식으로 제공됩니다.
* 최신 3개월 이내의 데이터만 조회 가능합니다.
* 구독 종료 혹은 OpenAPI 기능 미사용 시 호출이 제한됩니다.
* 일일 호출 한도는 1,000회 단위로 상향할 수 있으며, 상향은 연 단위로 적용됩니다.
* 특정 기간에만 적용되는 임시 상향은 지원하지 않습니다.

## 요청&#x20;

### Host

* <https://openapi.exosp.com>

### Header

* accept: application/json
* x-exosp-access: 발급 받은 Access Key
* x-exosp-secret: 발급 받은 Secret Key

### Method

* GET

### 공통 요청 데이터

<table><thead><tr><th width="151">항목</th><th width="93">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset</td><td>int</td><td><p><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>페이징 처리를 위한 데이터입니다.</p><p>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</p></td></tr><tr><td>tableSize</td><td>int</td><td><p><strong>페이지 사이즈</strong></p><p>페이징 처리를 위한 데이터입니다. (최대값 : 1000) </p></td></tr><tr><td>timezone</td><td>string</td><td><strong>응답 데이터의 타임존</strong><br>응답 데이터의 시각을 해당 타임존으로 변환하여 전달합니다. <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></tbody></table>

{% code title="Request 예제" fullWidth="false" %}

```sh
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/ip?offset=0&tableSize=1&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 
```

{% endcode %}

## 응답

### 공통 응답 데이터

<table><thead><tr><th width="147">항목</th><th width="104">타입</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><p><strong>응답 데이터</strong></p><p>각 기능에 따라 세부 내용이 다릅니다.</p></td></tr></tbody></table>

{% code title="(성공) Response 예제" %}

```json
{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
      {
        "name": "신은진",
        "departmentName": "디자인",
        "departmentFull": "어벤져스 > 비즈니스 > 디자인",
        "computerName": "어변져스의 iMac",
        "osType": "macos",
        "osDescription": "Sonoma",
        "osUserName": "어변져스(designer)",
        "publicIP": "211.171.171.190",
        "privateIP": "10.100.73.10",
        "dateOfEntryUTC": "2024-07-15T23:27:08+00:00",
        "dateOfEntry": "2024-07-16T08:27:08+09:00"
      }
    ]
  }
}
```

{% endcode %}

{% code title="(실패) Response 예제" %}

```json
{
  "code": 1,
  "message": "tableSize cannot be greater than 1000"
}
```

{% endcode %}


# 로그

## API 목록

{% content-ref url="/pages/8ls4JWi75wJjRVRHx8FO" %}
[안티 바이러스 > 바이러스 조치내역](/guide/logs/anti-virus-control)
{% endcontent-ref %}

{% content-ref url="/pages/PfQvUL4NQXQoeGxxRsf6" %}
[안티 바이러스 > 예약/수동 검사이력](/guide/logs/anti-virus-full-scan)
{% endcontent-ref %}

{% content-ref url="/pages/ZibYrMOYg2PqyAmF7knH" %}
[랜섬웨어 방지 > 보호파일 변조 차단 내역](/guide/logs/ransomware-prevention-protected-file-tampering-block)
{% endcontent-ref %}

{% content-ref url="/pages/NDc61N4nIBn7JpLkI9nL" %}
[랜섬웨어 방지 > 실행 차단 내역](/guide/logs/ransomware-prevention-process-execution-block)
{% endcontent-ref %}

{% content-ref url="/pages/TS8CFbxjVHbKDdh2meFr" %}
[웹보호 > 악성사이트 접속 제어 내역](/guide/logs/web-protection-malicious-urls-control)
{% endcontent-ref %}

{% content-ref url="/pages/uNdNQwVUa20gYDPxkVUv" %}
[개인(민감)정보 보호 > 탐지 및 조치 내역](/guide/logs/sensitive-information-detection-and-action)
{% endcontent-ref %}

{% content-ref url="/pages/QfghEa6a6A1ZsqXb7Tc2" %}
[개인(민감)정보 보호 > 예약/수동 검사 이력](/guide/logs/sensitive-information-full-scan)
{% endcontent-ref %}

{% content-ref url="/pages/PfsvEPeofjLa3y8G5e27" %}
[매체 제어 > 디바이스 연결 차단 내역](/guide/logs/device-control-connection-block)
{% endcontent-ref %}

{% content-ref url="/pages/uYRC0GEXYvcNozqSnVxu" %}
[매체 제어 > 파일 반출 제어 내역](/guide/logs/device-control-file-transfer-control)
{% endcontent-ref %}

{% content-ref url="/pages/ql55VmiVZZAU7xyfsipC" %}
[애플리케이션 제어 > 애플리케이션 실행 차단 내역](/guide/logs/application-control-execution-block)
{% endcontent-ref %}

{% content-ref url="/pages/bCwr0Zh7TmMo2dwYZ67r" %}
[애플리케이션 제어 > 파일 반출 제어 내역](/guide/logs/application-control-file-transfer-control)
{% endcontent-ref %}

{% content-ref url="/pages/QUeQUyfhmaV52YVdcXkE" %}
[애플리케이션 제어 > 클라우드 파일 동기화 제어 내역](/guide/logs/application-control-cloud-file-synchronization)
{% endcontent-ref %}

{% content-ref url="/pages/TNXF7HubpthF4N4RzC7c" %}
[화면 캡처 제어 내역](/guide/logs/screen-capture-control)
{% endcontent-ref %}

{% content-ref url="/pages/KX2TuNxZ2H63dzL528fR" %}
[출력물 제어 내역](/guide/logs/print-control)
{% endcontent-ref %}

{% content-ref url="/pages/plqw0fXOs8hfuM7BGbiO" %}
[웹 접속 관리 내역](/guide/logs/web-control)
{% endcontent-ref %}

{% content-ref url="/pages/YnMkUpmgdOiy8a2tT1Gp" %}
[감사로그](/guide/logs/audit)
{% endcontent-ref %}


# 안티 바이러스 > 바이러스 조치내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v2/anti-virus/virus-control`

안티 바이러스 > 바이러스 조치내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (조치 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름, 파일 이름</p><p>기본값 : 빈값</p></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>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>departmentName</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>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>processHash</td><td>string</td><td><strong>프로세스 해시(SHA256)</strong></td></tr><tr><td>inspectionType</td><td>string</td><td><p><strong>검사 유형</strong><br>Real Time Detection : 실시간 검사, </p><p>Scheduled Scan : 예약 검사, </p><p>Manual Scan : 수동 검사</p></td></tr><tr><td>virusName</td><td>string</td><td><strong>바이러스 이름</strong></td></tr><tr><td>virusType</td><td>string</td><td><strong>바이러스 유형</strong></td></tr><tr><td>action</td><td>string</td><td><p><strong>조치 유형</strong><br>Quarantined : 격리, </p><p>Disinfected : 치료, </p><p>Skipped : 처리 안함, </p><p>None : 없음</p></td></tr><tr><td>actionResult</td><td>string</td><td><strong>조치 결과</strong><br>Success : 성공, Fail : 실패</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>조치 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>조치 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v2/anti-virus/virus-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 317,
    "data": [
      {
          "name": "이시연",
          "departmentName": "웹서비스",
          "departmentFull": "어벤져스 > 제품 > 개발 > 웹서비스",
          "computerName": "DESKTOP-OSP3WGB",
          "osType": "windows",
          "osUserName": "LSY",
          "fileName": "sqlite viewer helper.exe",
          "filePath": "c:\\users\\lsy\\.vscode\\extensions\\qwtel.sqlite-viewer-0.9.3-win32-x64\\out\\bin\\sqlite viewer helper.exe",
          "processHash": "8d697710042b7d222d5ea703ed913dabb34b4977c4a94c891afa46419b58a98f",
          "inspectionType": "Scheduled Scan",
          "virusName": "HEUR/APC",
          "virusType": "APC/MALWARE",
          "action": "Quarantined",
          "actionResult": "Success",
          "dateOfEntryUTC": "2024-11-11T02:32:36+00:00",
          "dateOfEntry": "2024-11-11T02:32:36+00:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 안티 바이러스 > 예약/수동 검사이력

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v3/anti-virus/full-scan`

안티 바이러스 > 예약/수동 검사이력을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (검사 종료 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 사용자 이메일, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="238">항목</th><th width="96">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentName</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>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>detectType</td><td>string</td><td><p><strong>검사 유형</strong></p><ul><li>Admin Scheduled Scan : 관리자 예약 검사</li><li>User Full Scan : 사용자 전체 검사</li><li>User Custom Scan : 사용자 지정 검사</li><li>User Quick Scan : 사용자 빠른 검사</li></ul></td></tr><tr><td>totalScanCount</td><td>int</td><td><strong>총 검사 대상 파일 수</strong></td></tr><tr><td>doneScanCount</td><td>int</td><td><strong>검사 된 파일 수</strong></td></tr><tr><td>detectCount</td><td>int</td><td><strong>탐지된 바이러스 수</strong></td></tr><tr><td>detectQuarantinedCount</td><td>int</td><td><strong>격리된 바이러스 수</strong></td></tr><tr><td>detectDisinfectedCount</td><td>int</td><td><strong>치료된 바이러스 수</strong></td></tr><tr><td>detectSkippedCount</td><td>int</td><td><strong>처리 안된 바이러스 수</strong></td></tr><tr><td>dateOfStartUTC</td><td>string</td><td><p><strong>검사 시작 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfStart</td><td>string</td><td><p><strong>검사 시작 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEndUTC</td><td>string</td><td><p><strong>검사 종료 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEnd</td><td>string</td><td><p><strong>검사 종료 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v3/anti-virus/full-scan?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 631,
    "data": [
      {
        "name": "박성훈",
        "email": "sunghun@gmail.com",
        "departmentName": "제품",
        "departmentFull": "어벤져스 > 제품",
        "computerName": "DESKTOP-GSEV8JK",
        "osType": "windows",
        "osUserName": "sunghun",
        "detectType": "User Full Scan",
        "totalScanCount": 0,
        "doneScanCount": 0,
        "detectCount": 0,
        "detectQuarantinedCount": 0,
        "detectDisinfectedCount": 0,
        "detectSkippedCount": 0,
        "dateOfStartUTC": "2024-02-15T02:26:20+00:00",
        "dateOfStart": "2024-02-15T11:26:20+09:00",
        "dateOfEndUTC": "2024-02-15T02:26:20+00:00",
        "dateOfEnd": "2024-02-15T11:26:20+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 랜섬웨어 방지 > 보호파일 변조 차단 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/ransomware-prevention/protected-file-tampering-block`

랜섬웨어 방지 > 보호파일 변조 차단 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (차단 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</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>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>processName</td><td>string</td><td><strong>프로세스 이름</strong></td></tr><tr><td>processPath</td><td>string</td><td><strong>프로그램 경로</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>processHash</td><td>string</td><td><strong>프로세스 해시(SHA256)</strong></td></tr><tr><td>certificate</td><td>string</td><td><strong>서명</strong></td></tr><tr><td>accessFileName</td><td>string</td><td><strong>보호파일 이름</strong></td></tr><tr><td>accessFilePath</td><td>string</td><td><strong>보호파일 경로</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>차단 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>차단 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/ransomware-prevention/protected-file-tampering-block?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 1,
    "data": [
      {
        "name": "진수인",
        "departmentName": "Test",
        "departmentFull": "어벤져스 > 제품 > CX > Test",
        "computerName": "진수인",
        "osType": "windows",
        "osUserName": "sooin",
        "productName": "TODO: <Product name>",
        "processName": "RWTester.exe",
        "processPath": "C:\\Users\\sooin\\Downloads\\RWTester.exe",
        "companyName": "TODO: <Company name>",
        "processHash": "d878e12465aabb284b60bdd36bc5dfaf099520a204174392a513ef83a79635e5",
        "certificate": "-",
        "accessFileName": "TestFile17.hwp",
        "accessFilePath": "C:\\Users\\zion3\\Downloads\\TestFile17.hwp",
        "dateOfEntryUTC": "2024-05-18T09:17:30+00:00",
        "dateOfEntry": "2024-05-18T18:17:30+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 랜섬웨어 방지 > 실행 차단 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/ransomware-prevention/process-execution-block`

랜섬웨어 방지 > 실행 차단 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (차단 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</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>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>processName</td><td>string</td><td><strong>프로세스 이름</strong></td></tr><tr><td>processPath</td><td>string</td><td><strong>프로그램 경로</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>processHash</td><td>string</td><td><strong>프로세스 해시(SHA256)</strong></td></tr><tr><td>certificate</td><td>string</td><td><strong>서명</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>차단 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>차단 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/ransomware-prevention/process-execution-block?offset=0&tableSize=1&startTimeUTC=2024-04-17T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 2,
    "data": [
      {
        "name": "권종훈",
        "departmentName": "웹서비스",
        "departmentFull": "어벤져스 > 제품 > 개발 > 웹서비스",
        "computerName": "DESKTOP-OSN2GPA",
        "osType": "windows",
        "osUserName": "KJH",
        "productName": "-",
        "processName": "clang++.exe",
        "processPath": "C:\\clang++.exe",
        "companyName": "-",
        "processHash": "9fb6a9df6206c9372241bb56577b108491cd0744e213d56c5040dabd9c9b8520",
        "certificate": "-",
        "dateOfEntryUTC": "2024-06-07T08:32:19+00:00",
        "dateOfEntry": "2024-06-07T17:32:19+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 웹보호 > 악성사이트 접속 제어 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v2/web-protection/malicious-urls-control`

웹보호 > 악성사이트 접속 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름, 파일 이름</p><p>기본값 : 빈값</p></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>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>departmentName</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>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>카테고리</strong><br>Malicious Url : 악성 사이트, </p><p>Potentially Unwanted Website : 불필요한웹사이트, </p><p>Others : 기타</p></td></tr><tr><td>urlHash</td><td>string</td><td><strong>웹사이트 주소 해시(SHA256)</strong></td></tr><tr><td>url</td><td>string</td><td><strong>웹사이트 주소</strong></td></tr><tr><td>siteTitle</td><td>string</td><td><strong>웹사이트 제목</strong></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Warning : 경고위반, Block : 차단</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v2/web-protection/malicious-urls-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
           "name": "이은지",
           "departmentName": "cx 테스트",
           "departmentFull": "어벤져스 > cx 테스트",
           "computerName": "eunji",
           "osType": "windows",
           "osUserName": "eunji",
           "category": "Malicious Url",
           "urlHash": "f93a34889a2eb306e7207eb43318a718570ac65d2f17d00dd26c4ec389fd5d9a",
           "url": "lyubov.empatiya.net/?news&s",
           "siteTitle": "새 탭 외 페이지 3개 - 개인 - Microsoft​ Edge",
           "controlType": "Block",
           "dateOfEntryUTC": "2024-10-07T06:50:27+00:00",
           "dateOfEntry": "2024-10-07T06:50:27+00:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 개인(민감)정보 보호 > 탐지 및 조치 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/sensitive-information/detection-and-action`

개인(민감)정보 보호 > 탐지 및 조치 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="192">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>detectionType</td><td>string</td><td><p><strong>탐지 유형</strong><br>Real Time Detection : 실시간 탐지, </p><p>Admin Scheduled Scan : 관리자 예약 검사, </p><p>User Full Scan : 사용자 전체 검사, </p><p>User Custom Scan : 사용자 지정 검사</p></td></tr><tr><td>inspectionType</td><td>string</td><td><strong>검사 유형</strong><br>Quick : 빠른 검사, Full : 일반 검사</td></tr><tr><td>protectionType</td><td>string</td><td><strong>보호 유형</strong><br>No Protection : 보호 처리 없음, Encryption : 암호화</td></tr><tr><td>protectionResult</td><td>string</td><td><strong>보호 결과</strong><br>No Protection : 보호 처리 없음, Success : 성공, Fail : 실패</td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>fileSize</td><td>string</td><td><strong>파일 크기</strong></td></tr><tr><td>sensitiveInfoCount</td><td>string</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>sensitiveInfoDetails</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### 개인(민감)정보 세부 내역

<table><thead><tr><th width="162">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>type</td><td>string</td><td><p><strong>구분</strong><br>Sensitive Info Type : 개인(민감)정보 유형, </p><p>Sensitive Info Keyword : 개인(민감)정보 키워드</p></td></tr><tr><td>name</td><td>string</td><td><strong>개인(민감)정보</strong></td></tr><tr><td>count</td><td>string</td><td><strong>탐지 수</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/sensitive-information/detection-and-action?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
           "name": "김민지",
           "departmentName": "맥/크로스플랫폼",
           "departmentFull": "어벤져스 > 제품 > 개발 > 맥/크로스플랫폼",
           "osType": "macos",
           "osUserName": "user(user)",
           "computerName": "user의 MacBook Pro",
           "detectionType": "Real Time Detection",
           "inspectionType": "Quick",
           "protectionType": "No Protection",
           "protectionResult": "No Protection",
           "fileName": "암호화 테스트 파일 1234 2.csv",
           "filePath": "/Users/user/Library/CloudStorage/GoogleDrive-minji/내 드라이브/Test/암호화 테스트 파일 1234 2.csv",
           "fileSize": "34B",
           "sensitiveInfoCount": "2",
           "sensitiveInfoDetails": [
               {
                   "type": "Sensitive Info Type",
                   "name": "Email",
                   "count": 1
               },
               {
                   "type": "Sensitive Info Type",
                   "name": "Mobile (Korea)",
                   "count": 1
               }
           ],
           "dateOfEntryUTC": "2024-12-06T09:33:41+00:00",
           "dateOfEntry": "2024-12-06T18:33:41+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 개인(민감)정보 보호 > 예약/수동 검사 이력

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/sensitive-information/full-scan`

개인(민감)정보 보호 >  예약/수동 검사 이력을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="252">항목</th><th width="96">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>detectionType</td><td>string</td><td><p><strong>탐지 유형</strong><br>Admin Scheduled Scan : 관리자 예약 검사, </p><p>User Full Scan : 사용자 전체 검사, </p><p>User Custom Scan : 사용자 지정 검사</p></td></tr><tr><td>inspectionType</td><td>string</td><td><strong>검사 유형</strong><br>Quick : 빠른 검사, Full : 일반 검사</td></tr><tr><td>scanResult</td><td>string</td><td><p><strong>검사 결과</strong><br>Success : 성공, </p><p>Fail(실패 사유) : 실패, </p><p>Stop : 중단, </p><p>In Progress : 진행 중</p><p>-------------------------------------------------<br><strong>실패 사유</strong><br>Another Scan Is In Progress : 진행 중인 검사 존재, Agent Termination : 에이전트 종료, </p><p>Agent Update : 에이전트 업데이트, </p><p>Agent Abnormal Termination : 에이전트 비정상 종료</p></td></tr><tr><td>totalFileCount</td><td>string</td><td><strong>총</strong> <strong>검사 대상</strong></td></tr><tr><td>scanFileCount</td><td>string</td><td><strong>검사 진행된 파일 수</strong></td></tr><tr><td>detectedFileCount</td><td>string</td><td><strong>탐지 수</strong></td></tr><tr><td>detectedSensitiveInfoCount</td><td>string</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>protectionType</td><td>string</td><td><strong>보호 유형</strong><br>Encryption : 암호화, No Protection : 보호 처리 없음</td></tr><tr><td>protectionTargetFileCount</td><td>string</td><td><strong>총 보호 대상 파일 수</strong></td></tr><tr><td>protectedFileCount</td><td>string</td><td><strong>보호된 파일 수</strong></td></tr><tr><td>startDateOfEntryUTC</td><td>string</td><td><p><strong>검사 시작 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>startDateOfEntry</td><td>string</td><td><p><strong>검사 시작 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr><tr><td>endDateOfEntryUTC</td><td>string</td><td><p><strong>검사 종료 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>endDateOfEntry</td><td>string</td><td><p><strong>검사 종료 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/sensitive-information/full-scan?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
           "name": "김소은",
           "departmentName": "마케팅",
           "departmentFull": "어벤져스 > 비즈니스 > 마케팅",
           "osType": "windows",
           "osUserName": "김소은",
           "computerName": "김소은",
           "detectionType": "Admin Scheduled Scan",
           "inspectionType": "Quick",
           "scanResult": "Success",
           "totalFileCount": "2402",
           "scanFileCount": "2402",
           "detectedFileCount": "0",
           "detectedSensitiveInfoCount": "0",
           "protectionType": "Encryption",
           "protectedTargetFileCount": "0",
           "protectedFileCount": "0",
           "startDateOfEntryUTC": "2024-11-26T03:00:59+00:00",
           "startDateOfEntry": "2024-11-26T12:00:59+09:00",
           "endDateOfEntryUTC": "2024-11-26T03:03:13+00:00",
           "endDateOfEntry": "2024-11-26T12:03:13+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 매체 제어 > 디바이스 연결 차단 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/device-control/connection-block`

매체 제어 > 디바이스 연결 차단 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>디바이스 카테고리</strong><br>Others : 미분류, </p><p>CD-ROM/DVD/BD : CD-ROM/DVD, </p><p>Mobile Devices : 휴대용 장치, </p><p>Wireless LAN : 무선랜, </p><p>Bluetooth : 블루투스, </p><p>USB Tethering : USB 테더링, </p><p>USB LAN Adapter: USB 랜카드, <br>Ethernet Adapter: 유선랜카드,</p><p>Infrared Ports : 적외선 포트, </p><p>1394 Port : 1394 포트, </p><p>Modem : 모뎀, </p><p>PCMCIA Port : PCMCIA, </p><p>Image Capture Devices : 이미지 캡처 장치, </p><p>Serial/Parallel Port : Serial/Parallel 포트, </p><p>USB Port : USB 포트, </p><p>Removable Disk : 이동식 디스크</p></td></tr><tr><td>deviceDescription</td><td>string</td><td><strong>디바이스 설명</strong></td></tr><tr><td>deviceSerial</td><td>string</td><td><strong>디바이스 시리얼</strong></td></tr><tr><td>deviceHardwareId</td><td>string</td><td><strong>디바이스 하드웨어 ID</strong></td></tr><tr><td>deviceInstanceId</td><td>string</td><td><strong>디바이스 인스턴스 경로</strong></td></tr><tr><td>deviceClassGuid</td><td>string</td><td><strong>디바이스 클래스 GUID</strong></td></tr><tr><td>deviceClassName</td><td>string</td><td><strong>디바이스 클래스</strong></td></tr><tr><td>volumeUUID</td><td>string</td><td><strong>볼륨 UUID(macos)</strong></td></tr><tr><td>volumeName</td><td>string</td><td><strong>볼륨 이름(macos)</strong></td></tr><tr><td>volumeSize</td><td>string</td><td><strong>볼륨 용량(macos)</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/device-control/connection-block?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
            "name": "이나영",
            "departmentName": "이나영",
            "departmentFull": "어벤져스 > 제품 > CX > 이나영",
            "osType": "windows",
            "osUserName": "nayoung",
            "computerName": "DESKTOP-NAYOUNG",
            "category": "Bluetooth",
            "deviceDescription": "인텔(R) 무선 Bluetooth(R)",
            "deviceSerial": "USB\\ROOT_HUB30\\4&11FD050C&0&0",
            "deviceHardwareId": "USB\\VID_8087&PID_0033&REV_0000",
            "deviceInstanceId": "USB\\VID_8087&PID_0033\\5&2AF8BBA2&0&14",
            "deviceClassGuid": "{e0cbf06c-cd8b-4647-bb8a-263b43f0f974}",
            "deviceClassName": "Bluetooth",
            "volumeUUID": "-",
            "volumeName": "-",
            "volumeSize": "-",
            "dateOfEntryUTC": "2024-11-28T13:36:12+00:00",
            "dateOfEntry": "2024-11-28T22:36:12+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 매체 제어 > 파일 반출 제어 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/device-control/file-transfer-control`

매체 제어 > 파일 반출 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>디바이스 카테고리</strong><br>Others : 미분류, </p><p>CD-ROM/DVD/BD : CD-ROM/DVD, </p><p>Mobile Devices : 휴대용 장치, </p><p>Wireless LAN : 무선랜, </p><p>Bluetooth : 블루투스, </p><p>USB Tethering : USB 테더링, <br>USB LAN Adapter: USB 랜카드, <br>Ethernet Adapter: 유선랜카드,</p><p>Infrared Ports : 적외선 포트, </p><p>1394 Port : 1394 포트, </p><p>Modem : 모뎀, </p><p>PCMCIA Port : PCMCIA, </p><p>Image Capture Devices : 이미지 캡처 장치, </p><p>Serial/Parallel Port : Serial/Parallel 포트, </p><p>USB Port : USB 포트, </p><p>Removable Disk : 이동식 디스크</p></td></tr><tr><td>deviceDescription</td><td>string</td><td><strong>디바이스 설명</strong></td></tr><tr><td>deviceSerial</td><td>string</td><td><strong>디바이스 시리얼</strong></td></tr><tr><td>deviceHardwareId</td><td>string</td><td><strong>디바이스 하드웨어 ID</strong></td></tr><tr><td>deviceInstanceId</td><td>string</td><td><strong>디바이스 인스턴스 경로</strong></td></tr><tr><td>deviceClassGuid</td><td>string</td><td><strong>디바이스 클래스 GUID</strong></td></tr><tr><td>deviceClassName</td><td>string</td><td><strong>디바이스 클래스</strong></td></tr><tr><td>volumeUUID</td><td>string</td><td><strong>볼륨 UUID(macos)</strong></td></tr><tr><td>volumeName</td><td>string</td><td><strong>볼륨 이름(macos)</strong></td></tr><tr><td>volumeSize</td><td>string</td><td><strong>볼륨 용량(macos)</strong></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>fileSize</td><td>string</td><td><strong>파일 크기</strong></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Allow : 파일 반출 기록, Block : 파일 반출 차단</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/device-control/file-transfer-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
            "name": "최수지",
            "departmentName": "최수지",
            "departmentFull": "어벤져스 > 제품 > CX > 최수지",
            "osType": "windows",
            "osUserName": "suzy",
            "computerName": "suzy",
            "category": "Removable Disk",
            "deviceDescription": "Generic Flash Disk USB Device",
            "deviceSerial": "USB\\VID_058F&PID_6387\\79085C0C",
            "deviceHardwareId": "USBSTOR\\DiskGeneric_Flash_Disk______8.07",
            "deviceInstanceId": "USBSTOR\\DISK&VEN_GENERIC&PROD_FLASH_DISK&REV_8.07\\79085C0C&0",
            "deviceClassGuid": "{4d36e967-e325-11ce-bfc1-08002be10318}",
            "deviceClassName": "DiskDrive",
            "volumeUUID": "-",
            "volumeName": "-",
            "volumeSize": "-",
            "fileName": "스크린샷 2024-10-07 165903.png",
            "filePath": "D:\\스크린샷 2024-10-07 165903.png",
            "fileSize": "143KB",
            "controlType": "Allow",
            "dateOfEntryUTC": "2024-10-07T08:00:07+00:00",
            "dateOfEntry": "2024-10-07T17:00:07+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 애플리케이션 제어 > 애플리케이션 실행 차단 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/application-control/execution-block`

애플리케이션 제어 > 애플리케이션 실행 차단 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>애플리케이션 카테고리</strong><br>Others : 미분류, </p><p>P2P : P2P, </p><p>Messenger : 메신저, </p><p>FTP Utility : FTP 유틸리티, </p><p>Media Player : 동영상 플레이어, </p><p>Email Clients : 메일 클라이언트, </p><p>Cloud Storage : 클라우드 스토리지, </p><p>Note Taking Apps : 클라우드 노트, </p><p>Screen Capture : 화면캡처, </p><p>Remote Control : 원격 제어, </p><p>Web Browser : 웹 브라우저, </p><p>Live Tiles : Live Tiles, </p><p>AirDrop : 에어드랍,<br>AI : AI</p></td></tr><tr><td>productName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>processName</td><td>string</td><td><strong>프로세스 이름</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/application-control/execution-block?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
           "name": "이수정",
            "departmentName": "cx 테스트",
            "departmentFull": "어벤져스 > cx 테스트",
            "osType": "windows",
            "osUserName": "이수정",
            "computerName": "이수정",
            "category": "Live Tiles",
            "productName": "Microsoft StickyNotes",
            "processName": "Microsoft.Notes.exe",
            "companyName": "Microsoft Corporation",
            "dateOfEntryUTC": "2024-10-28T00:46:23+00:00",
            "dateOfEntry": "2024-10-28T09:46:23+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 애플리케이션 제어 > 파일 반출 제어 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/application-control/file-transfer-control`

애플리케이션 제어 > 파일 반출 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="195">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>애플리케이션 카테고리</strong><br>Others : 미분류, </p><p>P2P : P2P, </p><p>Messenger : 메신저, </p><p>FTP Utility : FTP 유틸리티, </p><p>Media Player : 동영상 플레이어, </p><p>Email Clients : 메일 클라이언트, </p><p>Cloud Storage : 클라우드 스토리지, </p><p>Note Taking Apps : 클라우드 노트, </p><p>Screen Capture : 화면캡처, </p><p>Remote Control : 원격 제어, </p><p>Web Browser : 웹 브라우저, </p><p>Live Tiles : Live Tiles, </p><p>AirDrop : 에어드랍</p></td></tr><tr><td>productName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>processName</td><td>string</td><td><strong>프로세스 이름</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>url</td><td>string</td><td><strong>웹 사이트 주소</strong></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>fileSize</td><td>string</td><td><strong>파일 크기</strong></td></tr><tr><td>fileType</td><td>string</td><td><p><strong>파일 유형</strong><br>General : 일반 파일, </p><p>Sensitive : 개인(민감)정보 파일, </p><p>Not Scanned : 개인(민감)정보 검사 안 함, </p><p>Scan Failed : 개인(민감)정보 검사 실패 파일,<br>Exosphere Encrypted File : 엑소스피어 암호화 파일</p></td></tr><tr><td>sensitiveInfoCount</td><td>string</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>sensitiveInfoDetails</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Allow : 파일 반출 기록, Block : 파일 반출 차단</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### 개인(민감)정보 세부 내역

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>개인(민감)정보</strong></td></tr><tr><td>count</td><td>int</td><td><strong>레코드 수</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/application-control/file-transfer-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
           "name": "이나영",
           "departmentName": "이나영,
           "departmentFull": "어벤져스 > 제품 > CX > 이나영",
           "osType": "windows",
           "osUserName": "nayoung",
           "computerName": "DESKTOP-NAYOUNG",
           "category": "Web Browser",
           "productName": "Microsoft Edge",
           "processName": "msedge.exe",
           "companyName": "Microsoft Corporation",
           "url": "admin-kr.exosp.com",
           "fileName": "엑셀_양식(ARK).xlsx",
           "filePath": "C:\\Users\\nayoung\\Documents\\카카오톡 받은 파일\\엑셀_양식(ARK).xlsx",
           "fileSize": "13KB",
           "fileType": "Sensitive",
           "sensitiveInfoCount": "20",
           "sensitiveInfoDetails": [
               {
                   "name": "Email",
                   "count": 20
               }
           ],
           "controlType": "Block",
           "dateOfEntryUTC": "2024-12-09T02:28:18+00:00",
           "dateOfEntry": "2024-12-09T11:28:18+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 애플리케이션 제어 > 클라우드 파일 동기화 제어 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/application-control/cloud-file-synchronization`

애플리케이션 제어 > 클라우드 파일 동기화 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="195">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>애플리케이션 카테고리</strong><br>Others : 미분류, </p><p>P2P : P2P, </p><p>Messenger : 메신저, </p><p>FTP Utility : FTP 유틸리티, </p><p>Media Player : 동영상 플레이어, </p><p>Email Clients : 메일 클라이언트, </p><p>Cloud Storage : 클라우드 스토리지, </p><p>Note Taking Apps : 클라우드 노트, </p><p>Screen Capture : 화면캡처, </p><p>Remote Control : 원격 제어, </p><p>Web Browser : 웹 브라우저, </p><p>Live Tiles : Live Tiles, </p><p>AirDrop : 에어드랍</p></td></tr><tr><td>productName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>processName</td><td>string</td><td><strong>프로세스 이름</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>fileSize</td><td>string</td><td><strong>파일 크기</strong></td></tr><tr><td>fileType</td><td>string</td><td><p><strong>파일 유형</strong><br>General : 일반 파일, </p><p>Sensitive : 개인(민감)정보 파일, </p><p>Not Scanned : 개인(민감)정보 검사 안 함, </p><p>Scan Failed : 개인(민감)정보 검사 실패 파일,<br>Exosphere Encrypted File : 엑소스피어 암호화 파일</p></td></tr><tr><td>sensitiveInfoCount</td><td>string</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>sensitiveInfoDetails</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Allow : 파일 동기화 기록, Block : 파일 동기화 차단</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### 개인(민감)정보 세부 내역

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>개인(민감)정보</strong></td></tr><tr><td>count</td><td>int</td><td><strong>레코드 수</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/application-control/cloud-file-synchronization?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
           "name": "김민지",
           "departmentName": "맥/크로스플랫폼",
           "departmentFull": "어벤져스 > 제품 > 개발 > 맥/크로스플랫폼",
           "osType": "macos",
           "osUserName": "user(user)",
           "computerName": "user의 MacBook Pro",
           "category": "Cloud Storage",
           "productName": "Google Drive",
           "processName": "FileProvider",
           "companyName": "Apple Inc.",
           "fileName": "암호화 테스트 파일 1234 복사본 9.csv",
           "filePath": "/Users/user/Library/CloudStorage/GoogleDrive-ㅡminji/내 드라이브/Test/암호화 테스트 파일 1234 복사본 9.csv",
           "fileSize": "10MB",
           "fileType": "Sensitive",
           "sensitiveInfoCount": "1000",
           "sensitiveInfoDetails": [
               {
                   "name": "Email",
                   "count": 1000
               }
           ],
           "controlType": "Block",
           "dateOfEntryUTC": "2024-12-10T08:32:51+00:00",
           "dateOfEntry": "2024-12-10T17:32:51+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 화면 캡처 제어 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/screen-capture-control`

화면 캡처 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>captureType</td><td>string</td><td><p><strong>캡처 유형</strong><br>Windows Shortcut : 윈도우 단축키, </p><p>Application : 애플리케이션, </p><p>Windows Snipping Tool : 윈도우 캡처 도구</p></td></tr><tr><td>productName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>processName</td><td>string</td><td><strong>프로세스 이름</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

<pre class="language-javascript"><code class="lang-javascript">curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/screen-capture-control?offset=0&#x26;tableSize=1&#x26;startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&#x26;endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&#x26;timezone=Asia%2FSeoul&#x26;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": {
    "total": 18,
    "data": [
      {
<strong>            "name": "이은지",
</strong>            "departmentName": "cx 테스트",
            "departmentFull": "어벤져스 > cx 테스트",
            "osUserName": "home",
            "computerName": "DESKTOP-K2PQT3B",
            "captureType": "Application",
            "productName": "KakaoTalk",
            "processName": "KakaoTalk.exe",
            "companyName": "Kakao Corp. ",
            "dateOfEntryUTC": "2024-10-22T08:08:08+00:00",
            "dateOfEntry": "2024-10-22T17:08:08+09:00"
      }
    ]
  }
}
</code></pre>

{% endtab %}
{% endtabs %}


# 출력물 제어 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/print-control`

출력물 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>processPath</td><td>string</td><td><strong>프로그램 경로</strong></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Allow : 허용, Block : 출력 차단, Watermark : 워터마크 출력</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/print-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
      {
            "name": "이은지",
            "departmentName": "cx 테스트2",
            "departmentFull": "어벤져스 > cx 테스트",
            "osType": "windows",
            "osUserName": "eunji@exosp.com",
            "computerName": "eunji",
            "fileName": "ACFrOgC5dMB8okuYn3gplzh39MExKdb7g38X7lF...ee5gPw6L3a3M34s8tOjS506w89uo56Pq504BAU",
            "processPath": "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
            "controlType": "Allow",
            "dateOfEntryUTC": "2024-11-15T03:21:04+00:00",
            "dateOfEntry": "2024-11-15T12:21:04+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 출력물 제어 내역\_v3

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v3/print-control`

출력물 제어 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>processPath</td><td>string</td><td><strong>프로그램 경로</strong></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Allow : 허용, Block : 출력 차단, Watermark : 워터마크 출력</td></tr><tr><td>fileType</td><td>string</td><td><strong>파일 유형</strong><br>General : 일반 파일, Sensitive : 개인(민감)정보 파일, Not Scanned : 개인(민감)정보 검사 안 함, Scan Failed : 개인(민감)정보 검사 실패 파일</td></tr><tr><td>sensitiveInfoCount</td><td>int</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>sensitiveInfoDetails</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>제어 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>제어 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### 개인(민감)정보 세부내역

<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>count</td><td>int</td><td><strong>개인(민감)정보 개수</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v3/print-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 68,
    "data": [
      {
        "name": "흐관리자1",
        "departmentName": "관리자",
        "departmentFull": "update-qc-zn > 관리자",
        "osType": "macos",
        "osUserName": "TEST(ayeon)",
        "computerName": "abc Mac mini",
        "fileName": "무제",
        "processPath": "텍스트\\",
        "controlType": "Watermark",
        "fileType": "Sensitive",
        "sensitiveInfoCount": "1",
        "sensitiveInfoDetails": [
          {
            "name": "Social Security Number (Korea)",
            "count": 1
          }
        ],
        "dateOfEntryUTC": "2026-01-28T06:08:26+00:00",
        "dateOfEntry": "2026-01-28T15:08:26+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 웹 접속 관리 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/web-control`

웹 접속 관리 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong> </td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>category</td><td>string</td><td><p><strong>웹 사이트 카테고리</strong><br>Others : 기타, </p><p>Web Mail : 웹메일, </p><p>Shopping : 쇼핑, </p><p>Finance : 증권, </p><p>Job Search : 취업, </p><p>Gaming : 게임, </p><p>Entertainment : 엔터테인먼트, </p><p>News : 뉴스, </p><p>Social Networking : SNS, </p><p>P2P/Cloud Storage : 웹하드/클라우드 스토리지, </p><p>P2P : 웹하드, </p><p>Cloud Storage : 클라우드 스토리지, </p><p>Pornography/Harmful : 성인/유해</p></td></tr><tr><td>siteTitle</td><td>string</td><td><strong>웹 사이트 제목</strong></td></tr><tr><td>url</td><td>string</td><td><strong>웹 사이트 주소</strong></td></tr><tr><td>urlHash</td><td>string</td><td><strong>웹 사이트 해시</strong></td></tr><tr><td>controlType</td><td>string</td><td><strong>제어 유형</strong><br>Warning : 경고, Block : 차단</td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/web-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&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": {
    "total": 18,
    "data": [
        {
                "name": "김민지",
                "departmentName": "맥/크로스플랫폼",
                "departmentFull": "어벤져스 > 제품 > 개발 > 맥/크로스플랫폼",
                "osType": "macos",
                "osUserName": "minji(minji)",
                "computerName": "minji의 MacBook Air",
                "category": "Gaming",
                "siteTitle": "넥슨",
                "url": "www.nexon.com/Home/Game",
                "urlHash": "5adbc8e6db30a26cdd3a25369a82360d412a4e8f96919ab22d1e34468eca9542",
                "controlType": "Block",
                "dateOfEntryUTC": "2024-11-28T12:18:18+00:00",
                "dateOfEntry": "2024-11-28T21:18:18+09:00"
        }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 접근 제어 > 애플리케이션 접근 내역

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

접근 제어 > 애플리케이션 접근 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (조치 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름, 파일 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="200.4453125">항목</th><th width="89.0234375">타입</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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>userAgent</td><td>string</td><td><strong>브라우저</strong></td></tr><tr><td>ipAddress</td><td>string</td><td><strong>IP 주소</strong></td></tr><tr><td>appTitle</td><td>string</td><td><strong>애플리케이션 이름</strong></td></tr><tr><td>appType</td><td>string</td><td><strong>애플리케이션 유형</strong><br>Cloud : 클라우드 앱<br>Inhouse : 인하우스 앱</td></tr><tr><td>deviceID</td><td>string</td><td><strong>디바이스 ID</strong></td></tr><tr><td>agentInstall</td><td>string</td><td><strong>에이전트 설치 여부</strong><br>Installed : 설치,<br>Not Installed : 미설치<br>Not Checked : 설치 미확인</td></tr><tr><td>accessResult</td><td>string</td><td><strong>접근 결과</strong><br>Success : 성공, Fail : 실패</td></tr><tr><td>accessFail</td><td>string</td><td><strong>실패 사유</strong><br>Inaccessible operating system: 접근 불가 운영체제,<br>Inaccessible browser: 접근 불가 브라우저,<br>Agent not installed: 엑소스피어 미설치,<br>Agent installed with an unauthorized corporate ID: 허용되지 않은 기업 아이디로 엑소스피어 설치됨,<br>Operating system where Agent installation confirmation is restricted: 엑소스피어 설치 확인 제한 운영체제,<br>Unauthorized operating system (Mobile): 허용되지 않은 운영체제(Mobile),<br>Unauthorized browser (Mobile): 허용되지 않은 브라우저(Mobile),<br>Browser where Exosphere installation confirmation is restricted: 엑소스피어 설치 확인 제한 브라우저,<br>Password input exceeded (20 times): 비밀번호 입력 횟수 초과 (20회),<br>PIN input exceeded (20 times): PIN 입력 횟수 초과 (20회),<br>Application integration settings error (String count error): 애플리케이션 연동 설정 오류 (문자열 개수 오류),<br>Application integration settings error (Undecodable string): 애플리케이션 연동 설정 오류 (복호화 불가 문자열),<br>Application integration settings error (No string): 애플리케이션 연동 설정 오류 (문자열 없음),<br>Application integration settings error (String information error): 애플리케이션 연동 설정 오류 (문자열 정보 오류),<br>Application integration settings error (Other): 애플리케이션 연동 설정 오류 (기타),<br>Access control service not used: 접근제어 서비스 이용 안함,<br>Service expired: 서비스 만료,<br>Application integration not set: 애플리케이션 연동 설정 안함,<br>Certificate registration error: 인증서 등록 오류,<br>License exceeded: 라이선스 초과,<br>User information retrieval failed: 사용자 정보 조회 실패,<br>Unintegrated user: 미연동 사용자,<br>Inaccessible IP: 접근 불가 IP,</td></tr><tr><td>accessSuccess</td><td>string</td><td><strong>성공 사유</strong><br>PC Automatic login succeeded: PC 자동 로그인 성공,<br>PC Manual login succeeded: PC 수동 로그인 성공,<br>PC Login with another account: PC 다른 계정 로그인 성공, <br>Authentication Device login succeeded: 인증 디바이스 로그인 성공,<br>Exclude Device login succeeded: 디바이스 허용 수동 로그인 -> 예외 디바이스 로그인 성공,<br>Exclude IP login succeeded: 예외 IP 로그인 성공</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" %}

<pre class="language-javascript"><code class="lang-javascript">curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/access-control/app?startTimeUTC=2025-07-13T15%3A00%3A00%2B00%3A00&#x26;endTimeUTC=2025-07-21T15%3A00%3A00%2B00%3A00&#x26;tableSize=10&#x26;offset=0&#x26;sortType=DESC&#x26;timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 317,
    "data": [
      {
                "name": "정민지",
                "email": "minji@exosp.com",
                "departmentName": "웹 서버",
                "osType": "Windows",
                "computerName": "minji",
                "userAgent": "Google Chrome",
                "ipAddress": "192.168.0.1",
                "appTitle": "Slack",
                "appType": "Cloud",
                "deviceID": "e4f1029e182c1ad95cbc222df41c6527fa30415760280d9d375f762962591b93",
                "agentInstall": "Installed",
                "accessResult": "Success",
                "accessFail": "-",
                "accessSuccess": "PC Automatic login succeeded",
                "dateOfEntryUTC": "<a data-footnote-ref href="#user-content-fn-1">2025</a>-07-21T05:22:23+00:00",
                "dateOfEntry": "2025-07-21T14:22:23+09:00"
            }
    ]
  }
}
</code></pre>

{% endtab %}
{% endtabs %}

[^1]:


# 접근 제어 > 클라우드 애플리케이션 접근 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/access-control/cloud-app`

접근 제어 > 클라우드 애플리케이션 접근 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (조치 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름, 파일 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="200.4453125">항목</th><th width="89.0234375">타입</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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>userAgent</td><td>string</td><td><strong>브라우저</strong></td></tr><tr><td>ipAddress</td><td>string</td><td><strong>IP 주소</strong></td></tr><tr><td>appTitle</td><td>string</td><td><strong>애플리케이션 이름</strong></td></tr><tr><td>deviceID</td><td>string</td><td><strong>디바이스 ID</strong></td></tr><tr><td>agentInstall</td><td>string</td><td><strong>에이전트 설치 여부</strong><br>Installed : 설치,<br>Not Installed : 미설치</td></tr><tr><td>accessResult</td><td>string</td><td><strong>접근 결과</strong><br>Success : 성공, Fail : 실패</td></tr><tr><td>accessFail</td><td>string</td><td><strong>실패 사유</strong><br>Inaccessible operating system: 접근 불가 운영체제,<br>Inaccessible browser: 접근 불가 브라우저,<br>Agent not installed: 엑소스피어 미설치,<br>Agent installed with an unauthorized corporate ID: 허용되지 않은 기업 아이디로 엑소스피어 설치됨,<br>Operating system where Agent installation confirmation is restricted: 엑소스피어 설치 확인 제한 운영체제,<br>Unauthorized operating system (Mobile): 허용되지 않은 운영체제(Mobile),<br>Unauthorized browser (Mobile): 허용되지 않은 브라우저(Mobile),<br>Browser where Exosphere installation confirmation is restricted: 엑소스피어 설치 확인 제한 브라우저,<br>Password input exceeded (20 times): 비밀번호 입력 횟수 초과 (20회),<br>PIN input exceeded (20 times): PIN 입력 횟수 초과 (20회),<br>Application integration settings error (String count error): 애플리케이션 연동 설정 오류 (문자열 개수 오류),<br>Application integration settings error (Undecodable string): 애플리케이션 연동 설정 오류 (복호화 불가 문자열),<br>Application integration settings error (No string): 애플리케이션 연동 설정 오류 (문자열 없음),<br>Application integration settings error (String information error): 애플리케이션 연동 설정 오류 (문자열 정보 오류),<br>Application integration settings error (Other): 애플리케이션 연동 설정 오류 (기타),<br>Access control service not used: 접근제어 서비스 이용 안함,<br>Service expired: 서비스 만료,<br>Application integration not set: 애플리케이션 연동 설정 안함,<br>Certificate registration error: 인증서 등록 오류,<br>License exceeded: 라이선스 초과,<br>User information retrieval failed: 사용자 정보 조회 실패,<br>Unintegrated user: 미연동 사용자,<br>Inaccessible IP: 접근 불가 IP,</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/logs/v1/access-control/cloud-app?startTimeUTC=2025-07-13T15%3A00%3A00%2B00%3A00&endTimeUTC=2025-07-21T15%3A00%3A00%2B00%3A00&tableSize=10&offset=0&sortType=DESC&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 317,
    "data": [
      {
                "name": "정민지",
                "email": "minji@exosp.com",
                "departmentName": "웹 서버",
                "osType": "Windows",
                "computerName": "minji",
                "userAgent": "Google Chrome",
                "ipAddress": "192.168.0.1",
                "appTitle": "Slack",
                "deviceID": "e4f1029e182c1ad95cbc222df41c6527fa30415760280d9d375f762962591b93",
                "agentInstall": "Installed",
                "accessResult": "Success",
                "accessFail": "-",
                "dateOfEntryUTC": "2025-07-21T05:22:23+00:00",
                "dateOfEntry": "2025-07-21T14:22:23+09:00"
            }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 접근 제어 > 인하우스 애플리케이션 접근 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/access-control/inhouse-app`

접근 제어 > 인하우스 애플리케이션 접근 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (조치 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름, 파일 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="202.671875">항목</th><th width="87.796875">타입</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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>userAgent</td><td>string</td><td><strong>브라우저</strong></td></tr><tr><td>ipAddress</td><td>string</td><td><strong>IP 주소</strong></td></tr><tr><td>appTitle</td><td>string</td><td><strong>애플리케이션 이름</strong></td></tr><tr><td>deviceID</td><td>string</td><td><strong>디바이스 ID</strong></td></tr><tr><td>agentInstall</td><td>string</td><td><strong>에이전트 설치 여부</strong><br>Installed : 설치,<br>Not Installed : 미설치</td></tr><tr><td>accessResult</td><td>string</td><td><strong>접근 결과</strong><br>Success : 성공, Fail : 실패</td></tr><tr><td>accessFail</td><td>string</td><td><strong>실패 사유</strong><br>Inaccessible operating system: 접근 불가 운영체제,<br>Inaccessible browser: 접근 불가 브라우저,<br>Agent not installed: 엑소스피어 미설치,<br>Agent installed with an unauthorized corporate ID: 허용되지 않은 기업 아이디로 엑소스피어 설치됨,<br>Operating system where Agent installation confirmation is restricted: 엑소스피어 설치 확인 제한 운영체제,<br>Unauthorized operating system (Mobile): 허용되지 않은 운영체제(Mobile),<br>Unauthorized browser (Mobile): 허용되지 않은 브라우저(Mobile),<br>Browser where Exosphere installation confirmation is restricted: 엑소스피어 설치 확인 제한 브라우저,<br>Password input exceeded (20 times): 비밀번호 입력 횟수 초과 (20회),<br>PIN input exceeded (20 times): PIN 입력 횟수 초과 (20회),<br>Application integration settings error (String count error): 애플리케이션 연동 설정 오류 (문자열 개수 오류),<br>Application integration settings error (Undecodable string): 애플리케이션 연동 설정 오류 (복호화 불가 문자열),<br>Application integration settings error (No string): 애플리케이션 연동 설정 오류 (문자열 없음),<br>Application integration settings error (String information error): 애플리케이션 연동 설정 오류 (문자열 정보 오류),<br>Application integration settings error (Other): 애플리케이션 연동 설정 오류 (기타),<br>Access control service not used: 접근제어 서비스 이용 안함,<br>Service expired: 서비스 만료,<br>Application integration not set: 애플리케이션 연동 설정 안함,<br>Certificate registration error: 인증서 등록 오류,<br>License exceeded: 라이선스 초과,<br>User information retrieval failed: 사용자 정보 조회 실패,<br>Unintegrated user: 미연동 사용자,<br>Inaccessible IP: 접근 불가 IP,</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/logs/v1/access-control/inhouse-app?startTimeUTC=2025-07-13T15%3A00%3A00%2B00%3A00&endTimeUTC=2025-07-21T15%3A00%3A00%2B00%3A00&tableSize=20&offset=0&sortType=DESC&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 317,
    "data": [
      {
                "name": "이유리",
                "email": "yuri@exosp.com",
                "departmentName": "windows 파트",
                "osType": "Windows",
                "computerName": "yurilee",
                "userAgent": "Google Chrome",
                "ipAddress": "192.168.0.111",
                "appTitle": "테스트 페이지(https://test-page.exosp.com)",
                "deviceID": "121c0e6ebdd7a523eg63a39c1b1402a3655d497c147f6621c0054e6c55a5777e",
                "agentInstall": "Installed",
                "accessResult": "Success",
                "accessFail": "-",
                "dateOfEntryUTC": "2025-07-21T05:12:21+00:00",
                "dateOfEntry": "2025-07-21T14:12:21+09:00"
       }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 감사로그

## API 목록

{% content-ref url="/pages/6HmvaOHtkx5hc72GSUgt" %}
[Broken mention](broken://pages/6HmvaOHtkx5hc72GSUgt)
{% endcontent-ref %}

{% content-ref url="/pages/1TElST48VqtWYizP37ZE" %}
[관리자 접속 이벤트](/guide/logs/audit/policy-setting)
{% endcontent-ref %}

{% content-ref url="/pages/LlWXmiP8ykknchTNpvE7" %}
[사용자 관리 이벤트](/guide/logs/audit/policy-setting-1)
{% endcontent-ref %}

{% content-ref url="/pages/rPxbIHtqbZa9mxMEGbul" %}
[에이전트 설치 및 삭제 이벤트](/guide/logs/audit/user-policy-setting)
{% endcontent-ref %}

{% content-ref url="/pages/LMKHegi11exe2cATiEdT" %}
[Broken mention](broken://pages/LMKHegi11exe2cATiEdT)
{% endcontent-ref %}

{% content-ref url="/pages/mUsFez9xfrpPwP9N5Lbp" %}
[백업 파일 삭제 이벤트](/guide/logs/audit/backup)
{% endcontent-ref %}

{% content-ref url="/pages/0V8AEdTQlnUyGoza5PY2" %}
[제로트러스트 애플리케이션 연동 설정 이벤트](/guide/logs/audit/admin-app)
{% endcontent-ref %}

{% content-ref url="/pages/V5CuD7LOWNYST0E4nh73" %}
[제로트러스트 사용자 연동 이벤트](/guide/logs/audit/admin-app-user)
{% endcontent-ref %}


# 정책 설정 이벤트

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

정책 설정 이벤트를 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th>항목</th><th width="203.77734375">타입</th><th>설명</th></tr></thead><tbody><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="92.80859375">타입</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>policyType</td><td>string</td><td><p><strong>정책 타입 (메뉴명)-(정책명)-(기능)-(OS 종류)</strong><br></p><ul><li><p><strong>메뉴명</strong>  </p><ul><li>Vulnerability Check : PC 보안점검</li><li>Anti-Malware : 안티 바이러스</li><li>Ransomware Folder Protection : 랜섬웨어 방지</li><li>Web Protection : 웹 보호</li><li>Detect sensitive information : 개인(민감)정보 보호 </li><li>Data Loss Prevention : 정보 유출 방지</li><li>IT Operational Optimization : IT 운영최적화</li><li>Access Control : 접근제어</li><li>Security Management : 보안 관리</li><li>Agent Management : 에이전트 관리</li></ul></li></ul><p></p><ul><li><p><strong>정책명</strong> </p><ul><li>Full Scan Settings : 점검 정책</li><li>Real-time protection policy : 실시간 보호 정책 </li><li>Scheduled scan policy : 예약 검사 정책</li><li>Exception policy : 예외 정책</li><li>Real-time protection and exception policy : 실시간 보호 및 예외 정책</li><li>Real-time Scan : 실시간 검사정책</li><li>Scheduled Scan : 예약 검사정책</li><li>File Encryption : 확장자 기반 암호화 정책</li><li>Encryption Protection Control : 암호화 보호 정책</li><li>File Export Control : 파일반출 제어 정책</li><li>Device Control : 매체 제어 정책</li><li>Application Control : 애플리케이션 제어 정책</li><li>Screen Capture Control : 화면캡처 제어 정책</li><li>Print Control : 출력물 제어 정책</li><li>Web Control Policy : 웹 접속 관리 정책</li><li>File Export Backup Policy : 반출 파일 백업 정책</li><li>Policy settings : 정책 설정</li><li>Cloud Application : 클라우드 애플리케이션</li><li>In-House Application : 인하우스 애플리케이션</li><li>File Export Backup Policy : 반출 파일 백업 정책</li><li>Temporary Decryption Approval : 암호화 임시 해제 승인</li><li>Crypto Archive End Approval : 암호화 보관 종료 승인</li><li>Device Approval : 매체 승인</li><li>File Approval : 파일 반출 승인</li><li>Print Approval : 출력물 승인</li><li>Admin Access Security Management : 관리자 접속 보안 관리</li><li>Prevent Agent Deletion : 에이전트 삭제 방지설정</li><li>Agent Security Policy : 에이전트 무력화 방지</li><li>Agent Status and Deletion : 에이전트 현황 및 삭제</li><li>Account Security Management : 계정 보안 관리</li><li>Auto delete policy : 자동 삭제 정책</li></ul></li><li><p><strong>기능</strong></p><ul><li>Function Activation : 기능 활성화</li><li>Security Settings : 보안 설정</li><li>Watermark Settings : 워터마크 설정</li><li>Integration Settings : 연동 설정</li><li>Exception Device Management : 예외 디바이스 관리</li><li>Exception IP Management : 예외 IP 관리</li><li>Prevent Agent Deletion : 에이전트 삭제 방지설정</li><li>Prevent Safe Mode Booting : 안전모드 부팅 방지설정</li><li>Prevent Multi-Booting : 멀티 부팅 방지설정</li><li>OS Time Zone Change Prevention : OS 시간대 변경 방지설정 </li></ul></li><li><p>OS 유형 </p><ul><li>Windows</li><li>MacOS</li><li>Common : 공통</li></ul></li></ul></td></tr><tr><td>policyTargetName</td><td>string</td><td><strong>정책 대상 이름</strong></td></tr><tr><td>eventType</td><td>string</td><td><ul><li><p><strong>이벤트 유형</strong></p><ul><li>Policy Group Setting : 정책 그룹 설정</li><li>Policy settings : 정책 설정</li><li>Feature Activation Setting : 기능 활성화 설정</li><li>Exception User Setting : 예외 사용자 설정</li><li>Scan option settings : 검사 옵션 설정</li><li>Inspection Exception Setting : 검사 예외 설정<br>Operating System Update : 운영체제 업데이트</li><li>Use Antivirus : 바이러스 백신 사용</li><li>Use Firewall : 방화벽 사용</li><li>Use Secure PC Password : 안전한 PC 비밀번호 사용</li><li>Periodic PC Password Change : 주기적인 PC 비밀번호 변경</li><li>Use Screen Saver : 화면 보호기 사용</li><li>Use Shared Folder : 공유 폴더 사용</li><li>Disable USB Auto-Run : USB 자동실행 해제</li><li>Software Update : 소프트웨어 업데이트</li><li>Use System Integrity Protection (SIP) : 시스템 무결성 보호(SIP) 사용</li><li>Block Unverified Apple Apps : Apple 미검증 앱 실행 차단</li><li>Set Inspection Schedule : 검사 예약 설정</li><li>Scan option settings : 검사 옵션 설정</li><li>Category Setting : 카테고리 설정</li><li>Set Website Exceptions : 웹사이트 예외 설정</li><li>Set Inspection Type : 검사 유형 설정</li><li>Set Inspection Rules - Personal Information Patterns : 검사 규칙 설정 - 개인 정보 패턴</li><li>Set Inspection Rules - Sensitive Information Keywords : 검사 규칙 설정 - 민감 정보 키워드</li><li>Set Exception Paths : 예외 경로 설정</li><li>Option Setting : 옵션 설정</li><li>Set Extensions : 확장자 설정</li><li>Individual Setting : 개별 설정</li><li>Website Exception Settings : 웹사이트 예외 설정</li><li>Extension Settings : 확장자 설정</li><li>Additional Settings : 추가 설정</li><li>SSO integration settings : SSO 연동 설정</li><li>SAML SSO Certificate : SAML SSO 인증서</li><li>Automatic linking settings for non-registered users : 미연동 사용자 자동 연동 설정</li><li>User integration settings : 사용자 연동 설정</li><li>Policy application settings : 정책 애플리케이션 설정</li><li>Device Security Settings : 디바이스 보안 설정</li><li>Allow access IP settings : 접근 허용 IP 설정</li><li>IP setting options : IP 설정 옵션</li><li>Exception Device Settings : 예외 디바이스 설정</li><li>Application Settings : 애플리케이션 설정</li><li>SDK Integration Settings : SDK 연동 설정</li><li>SDK Option Settings : SDK 옵션 설정</li><li>Network security settings : 네트워크 보안 설정</li><li>Authentication security settings : 인증 보안 설정</li><li>Edit exception device information : 예외 디바이스 정보 수정</li><li>Exception IP settings : 예외 IP 설정</li><li>Edit exception IP information : 예외 IP 정보 수정</li><li>Reason input setting for approval request : 승인 요청 시 사유 입력 설정</li><li>Approval expiration time setting : 승인 만료 시각 설정</li><li>Two-factor authentication setting : 2단계 인증 설정</li><li>Access allowed IP setting : 접속 허용 IP 설정</li><li>Setting options : 설정 옵션</li><li>deletion of event : 에이전트 삭제</li><li>Watermark Image : 워터마크 이미지</li><li>Watermark Text : 워터마크 텍스트</li><li>Password creation rules setting : 비밀번호 생성 규칙 설정</li><li>Password change rules setting : 비밀번호 변경 규칙 설정</li><li>Password error access restriction setting : 비밀번호 오류 접속 제한 설정</li><li>Password error access restriction status : 비밀번호 오류 접속 제한 현황</li><li>Deletion option settings : 삭제 옵션 설정</li></ul></li></ul></td></tr><tr><td>eventDetailData</td><td>array</td><td><a data-mention href="#undefined">#undefined</a><br><a data-mention href="broken://pages/qQ2NfAowUwJEi3FPjUiH">Broken link</a></td></tr><tr><td>eventPath</td><td>string</td><td><p><strong>정책 설정 경로</strong></p><p>Admin page : 관리자페이지<br>Email : 이메일</p></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>

#### 이벤트 유형 데이터 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>policyName</td><td>string</td><td>정책 이름</td></tr><tr><td>memo</td><td>string</td><td>정책 메모</td></tr><tr><td>startTimeUTC</td><td>string</td><td>정책 시작 시각</td></tr><tr><td>endTimeUTC</td><td>string</td><td>정책 종료 시각</td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/audit/v1/admin/policy-setting?currentPage=0&tableSize=1000&timezone=Asia%2FSeoul' \
  -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-26 ~ 2026-01-26",
    "data": [
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Data Loss Prevention - Print Control - Function Activation",
        "policyTargetName": "예외 정책 추가2(ysmoon, test4)",
        "eventType": "Policy Group Setting",
        "eventDetailData": [
          {
            "policyName": "예외 정책 추가2",
            "memo": "",
            "policySettingType": "Scheduled Period",
            "startTimeUTC": "2025-12-18 09:08:40",
            "endTimeUTC": "2025-12-18 09:28:40",
            "timeZone": "Seoul"
          }
        ],
        "eventPath": "Admin page",
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-18T09:08:40+00:00",
        "dateOfEntry": "2025-12-18T18:08:40+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Data Loss Prevention - Print Control - Function Activation",
        "policyTargetName": "정책 3(test2, test4)",
        "eventType": "Policy Group Setting",
        "eventDetailData": [
          {
            "add": {
              "user": [
                "test2"
              ]
            },
            "delete": {
              "user": ""
            }
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-18T04:15:59+00:00",
        "dateOfEntry": "2025-12-18T13:15:59+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Anti-Malware - Scheduled scan policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Inspection Schedule",
        "eventDetailData": [
          {
            "interval": "ONECE",
            "year": 2025,
            "month": 12,
            "day": 9,
            "dayOfWeek": null,
            "hh": 11,
            "mm": 9
          },
          {
            "interval": "ONECE",
            "year": 2025,
            "month": 12,
            "day": 9,
            "dayOfWeek": null,
            "hh": 11,
            "mm": 10
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-09T02:00:08+00:00",
        "dateOfEntry": "2025-12-09T11:00:08+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Anti-Malware - Scheduled scan policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Inspection Schedule",
        "eventDetailData": [
          {
            "interval": "ONECE",
            "year": 2025,
            "month": 12,
            "day": 9,
            "dayOfWeek": null,
            "hh": 11,
            "mm": 9
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-09T01:59:16+00:00",
        "dateOfEntry": "2025-12-09T10:59:16+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Anti-Malware - Scheduled scan policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Inspection Schedule",
        "eventDetailData": null,
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-09T01:59:09+00:00",
        "dateOfEntry": "2025-12-09T10:59:09+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Web Protection - Real-time protection and exception policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Website Exceptions",
        "eventDetailData": [
          {
            "url": "sdfsdf"
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - windows",
        "dateOfEntryUTC": "2025-12-04T07:03:37+00:00",
        "dateOfEntry": "2025-12-04T16:03:37+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Web Protection - Real-time protection and exception policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Website Exceptions",
        "eventDetailData": [
          {
            "url": "test"
          },
          {
            "url": "test2"
          },
          {
            "url": "naver.com"
          },
          {
            "url": "test3"
          },
          {
            "url": "test4"
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-02T04:09:06+00:00",
        "dateOfEntry": "2025-12-02T13:09:06+09:00"
      }
    ],
    "total": 7,
    "currentPage": 0,
    "tableSize": 1000
  }
}
```

{% endtab %}
{% endtabs %}


# 이벤트 유형 데이터

이벤트 유형 데이터

### **일반 동작/상태**

* Add : 추가
* Delete : 삭제
* Activate : 활성화
* Deactivate : 비활성화
* Enabled : 활성화
* Disabled : 비활성화
* Enable : 활성화
* Disable : 비활성화
* Change : 변경하기
* Display : 표시하기
* Edit : 수정
* Modify : 수정
* Edit memo : 메모 수정
* Not linked : 연동 안함
* No Integration : 연동 안함
* Integration : 연동
* Disconnect : 연동 해제
* Use SAML SSO integration : SAML SSO 연동 사용
* Use SDK Integration : SDK 연동 사용
* Download : 다운로드
* Encrypt : 암호화
* Exception : 예외
* Block : 차단
* Warn : 경고
* Warning : 경고
* Allow (No Access Records) : 허용(접속 기록 X)
* Allow (No File Export Record) : 허용(파일반출 기록 X)
* Allow (File Export Record) : 허용(파일반출 기록)
* Allow (Record Print) : 허용(출력 기록)
* Allow (No Capture Record) : 허용(캡처 기록 X)
* Read-Only : 읽기전용
* Block Connection : 연결 차단
* Block Execution : 실행 차단
* Block File Export : 파일반출 차단
* Block UWP App Execution - Enable : UWP앱 실행차단 - 활성화
* Block UWP App Execution - Disable : UWP앱 실행차단 - 비활성화
* Block WebBrowser PDF Viewer - Enable : 웹 브라우저 PDF 뷰어 차단 - 활성화
* Block WebBrowser PDF Viewer - Disable : 웹 브라우저 PDF 뷰어 차단 - 비활성화
* Block Capture : 캡처 차단
* Block Print : 출력 차단
* Quick Inspection : 빠른 검사
* General Inspection : 일반 검사
* Inspection Options : 검사 옵션
* Inspection Status : 검사 여부
* Setting (Modification) : 설정(수정)
* Excel Upload : 엑셀 업로드
* others : 개수
*

### 사용자/승인

* User Selection : 사용자 선택
* Self-Approval : 자가승인
* Approver Approval Required : 승인자 승인필요
* Policy retention period after approval completion : 승인 완료 후 정책 유지기간&#x20;
* Approval expiration time change : 승인 만료 시각 변경
* Minimum Password Length : 비밀번호 최소 길이
* Uppercase Letter Required : 영문 대문자 포함
* Lowercase Letter Required : 영문 소문자 포함
* Number Required : 숫자 포함
* Special Character Required : 특수문자 포함
* Password Change Period : 비밀번호 변경 주기
* Action on Period Reached : 변경 주기 도달 시 처리 옵션
* Block Reuse of Same Password : 동일 비밀번호 변경 차단
* Password Error Limit : 비밀번호 오류 횟수
* Access Restriction Period : 접속 제한 기간
* Access Restriction Released : 접속 제한 해제

### 업데이트/보안

* Check Hidden Update List : 숨겨진 업데이트 목록 점검
* Check Update Status : 업데이트 상태 점검
* Restrict User Exception Settings : 사용자 예외 설정 제한
* Restrict User Block Rule Settings : 사용자 차단 규칙 설정 제한
* Prevent User Default Extension Deletion : 사용자 기본 확장자 삭제 방지
* Action on Vulnerability Settings : 취약 시 동작 설정
* Agent simple login setting : 에이전트 간편 로그인 설정
* 2-step authentication method setting : 2단계 인증 수단 설정
* Quarantine criteria : 격리 기준
* Quarantine retention period : 격리 보관 기간

### 검사/반출

* Number of Personal (Sensitive) Information Criteria : 개인(민감)정보 판단기준 개수
* Set Inspection File Size : 검사 파일 크기 설정
* Set File Size for Inspection : 검사 파일 크기 설정
* Set Personal (Sensitive) Information Export Control : 개인(민감)정보 반출 제어 설정
* Media File Export : 매체 파일 반출
* Application File Export : 애플리케이션 파일 반출
* Output Document : 출력물
* Block file export : 파일반출 차단
* Allow(File Export Log) : 허용(파일반출 기록)

### 암호화 권한

* Set Temporary Encryption Deactivation Permission : 암호화 임시 해제 권한 설정
* Set Encryption Storage Termination Permission : 암호화 보관 종료 권한 설정
* encrypted file : 암호화 파일

### 파일/용량/범위

* File Size : 파일크기
* Set Inspection File Size : 검사 파일 크기 설정
* Range : 범위
* Scope : 범위
* Allow User Interruption : 사용자 중단 허용
* Once : 한번
* Daily : 매일
* Weekly : 매주
* Monthly : 매월
* End of the month : 말일
* Folder Path : 폴더 경로
* File Path :  파일 경로
* File Content : 파일 내용
* First detected on : 첫 탐지일
* Last modified : 최종 수정일
* Last opened : 최종 열람일

### 요일

* Monday : 월요일
* Tuesday : 화요일
* Wednesday : 수요일
* Thursday : 목요일
* Friday : 금요일
* Saturday : 토요일
* Sunday : 일요일

### 화면/표시

* Screen Saver Waiting Time : 화면 보호기 대기 시간
* Print Watermark : 워터마크 출력
* Default Policy : 기본 정책
* Scale : 배율
* Transparency : 투명도
* Layout Type : 배치 유형
* Grid Layout Angle Setting : 바둑판식 배열 각도 설정
* Font Size : 글자 크기
* Font Color : 글자 색상
* Text 1 - Print Time : 텍스트 1 - 출력 시간
* Text 1 - File Name : 텍스트 1 - 파일 이름
* Text 1 - Layout Type : 텍스트 1 - 배치 유형
* Text 2 - Member Name : 텍스트 2 - 멤버 이름
* Text 2 - Group Name : 텍스트 2 - 그룹 이름
* Text 2 - Computer Name : 텍스트 2 - 컴퓨터 이름
* Text 2 - Layout Type : 텍스트 2 - 배치 유형
* Text 2 - Computer IP : 텍스트 2 - 컴퓨터 IP
* Text 3 - Admin Specified Text : 텍스트 3 - 관리자 지정 텍스트
* Text 3 - Change Admin Specified Text Phrase : 텍스트 3 - 관리자 지정 텍스트 문구 설정
* Text 3 - Layout Type : 텍스트 3 - 배치 유형
* Black : 검정
* Gray : 회색
* Fixed Position : 지정 위치
* Tile : 바둑판식 배열
* Tile Angle : 바둑판식 배열 각도

### 검사 대상

* Inspection Target - \[ Removable Disk - {} / Network Drive - {} / Local Disk - {} ] : 검사 대상 - \[ 이동식 디스크 - {} / 네트워크 드라이브 - {}  / 로컬 디스크 - {} ]

### 애플리케이션 정책

* Add Application Policy : 애플리케이션 정책 추가
* Delete Application Policy : 애플리케이션 정책 삭제
* Application policy added : 애플리케이션 정책 추가
* Application policy deleted : 애플리케이션 정책 삭제
* Category Policy : 카테고리 정책

### 디바이스/볼륨

* Device Category : 디바이스 카테고리
* Device Serial Number : 디바이스 시리얼
* Device Hardware ID : 디바이스 하드웨어 ID
* Device Instance Path : 디바이스 인스턴스 경로
* Device Class GUID : 디바이스 클래스 GUID
* Device Class : 디바이스 클래스
* Device Name : 디바이스 설명
* Device Memo : 디바이스 메모
* Device Details : 디바이스 상세 정보
* Volume UUID : 볼륨 UUID
* Volume name : 볼륨 이름
* Volume capacity : 볼륨 용량
* Volume UUID cannot use empty values. : 볼륨 UUID는 빈 값을 사용할 수 없습니다.

### 접근/OS/브라우저/설치

* Operating system : 운영체제
* Operating System : 운영체제
* Browser : 브라우저
* Exosphere Installation : Exosphere 설치
* Installation of Exosphere : Exosphere 설치
* Loading Popup Message Settings : 로딩 팝업 문구 설정
* OS access status : 운영체제 접근 여부
* OS access options : 운영체제 접근 옵션
* Browser access status : 브라우저 접근 여부
* Browser access options : 브라우저 접근 옵션
* Exosphere installation access status : 엑소스피어 설치 접근 여부
* Exosphere installation access options : 엑소스피어 설치 접근 옵션
* IP access status : IP 접근 여부
* Add allowed IP : 접근 허용 IP 추가
* Remove allowed IP : 접근 허용 IP 삭제
* Add IP : IP 추가
* Delete IP : IP 삭제
* Include in deletion targets : 삭제 대상에 포함
* Do not include : 미포함

### 활성화/비활성화/설정 정보

* Activate : 활성화
* Deactivate : 비활성화
* No configuration information : 설정 정보 없음
* Feature activation settings : 기능 활성화 설정

### 접근 항목

* Access Options : 접근 옵션
* Access Status : 접근 여부

### **\[카테고리 관련]**

#### 웹사이트 카테고리

* Webmail : 웹메일
* Shopping : 쇼핑
* Finance : 증권
* Job Search : 취업
* Gaming : 게임
* Entertainment : 엔터테인먼트
* News : 뉴스
* Social Networking : SNS
* P2P/Cloud Storage : P2P/클라우드 스토리지
* Malicious URL : 악성 URL
* Pornography/Harmful : 성인/유해
* Others : 기타
* Potentially Unwanted Website : 불필요한 웹사이트
* P2P : P2P
* Cloud Storage : 클라우드 스토리지
* Generative AI : 생성형 AI
* IP Address in URL : IP 주소

#### 디바이스 카테고리&#x20;

* Removable Device FDD/USB : FDD/USB 저장디바이스
* CD-ROM/DVD/BD : CD-ROM/DVD/BD
* USB Drive : USB 외장하드
* Portable Devices : 휴대용 디바이스
* Wireless LAN : Wireless LAN
* Bluetooth : Bluetooth
* USB Tethering : USB 테더링
* USB LAN Adapter: USB 랜카드
* Ethernet Adapter: 유선랜카드
* Infrared Ports : 적외선 포트
* 1394 Port : 1394 포트
* Modem : 모뎀
* PCMCIA Port : PCMCIA
* Image Capture Devices : 이미지 캡처 디바이스
* Serial/Parallel Port : Serial/Parallel 포트
* USB Port : USB 포트
* Removable Disk : 이동식 디스크
* Others : 미분류
* AI : AI

#### 애플리케이션 카테고리&#x20;

* P2P : P2P
* Messenger : 메신저
* FTP Utility : FTP 유틸리티
* Media Player : 동영상 플레이어
* Email Clients : 메일 클라이언트
* Cloud Storage : 클라우드 스토리지
* Note Taking Apps : 클라우드 노트
* Screen Capture : 화면캡처
* Remote Control : 원격제어
* Web Browser : 웹브라우저
* UWP app : UWP 앱
* Others : 미분류
* Shortcut Key : 단축키
* Snip & Sketch : 캡처 도구
* AI : AI


# 관리자 접속 이벤트

<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 %}


# 사용자 관리 이벤트

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

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

### Query Parameters

<table><thead><tr><th>항목</th><th width="169.08984375">타입</th><th>설명</th></tr></thead><tbody><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>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>policyType</td><td>string</td><td><p><strong>정책 유형</strong></p><ul><li>Account Management : 사용자 관리</li><li>User Group Setting : 사용자 등록</li><li>Admin Settings : 관리자 등록</li><li>Approver Settings : 승인자 등록</li><li>Request To Set User Password : 사용자 비밀번호 설정 요청</li></ul></td></tr><tr><td>eventType</td><td>string</td><td><p><strong>이벤트 유형</strong></p><ul><li>User : 사용자</li><li>Group : 그룹</li><li>Company Information : 기업 정보</li><li>Excel Registration : 엑셀 등록</li><li>LDAP : LDAP</li><li>Set user account initial password : 사용자 계정 초기 비밀번호 설정</li><li>Administrator : 관리자</li><li>Approver : 승인자</li><li>Auto Approval Settings : 자동 승인 설정</li><li>User password setting request : 사용자 비밀번호 설정 요청</li></ul></td></tr><tr><td>eventDetailData</td><td>string</td><td><p><strong>이벤트 유형 상세</strong></p><ul><li>Add : 추가</li><li>Delete : 삭제</li><li>Move : 이동</li><li>Modify : 수정</li><li>Name : 이름</li><li>Group : 그룹</li><li>Parent Group : 상위 그룹</li><li>Installation email sent : 설치 메일 전송</li><li>User guidance email sent : 사용자 안내 메일 전송</li><li>Password reset : 비밀번호 초기화</li><li>Cloud application integration management : 클라우드 애플리케이션 연동 관리</li><li>Company Information : 기업 정보</li><li>Apply : 적용</li><li>All Users : 전체 사용자</li><li>Existing Users : 기존 사용자</li><li>New : 신규</li><li>Changed : 변경</li><li>Deleted : 삭제</li><li>LDAP Users : LDAP 사용자</li><li>Duplicate : 중복</li><li>Delete Server Information : 서버 정보 삭제</li><li>Set user account initial password : 사용자 계정 초기 비밀번호 설정</li><li>Change : 변경</li><li>Administrator : 관리자</li><li>Change Accessible Menu : 접근 가능 메뉴 변경</li><li>Transfer Chief Administrator Rights : 대표 관리자 권한 전달</li><li>Backup File Download Permission : 백업 파일 다운로드 권한</li><li>Approver : 승인자</li><li>Change Approval Group : 승인 그룹 변경</li><li>Auto Approval Settings : 자동 승인 설정</li><li>Activate : 활성화</li><li>Deactivate : 비활성화</li><li>User password setting request : 사용자 비밀번호 설정 요청</li><li>Initial password for user account - changed : 사용자 계정 초기 비밀번호 - 변경</li><li>User security quick setting link validity period : 사용자 보안 간편 설정 링크 유효시간</li><li>minutes : 분</li><li>User : 사용자</li><li>Excel Registration : 엑셀 등록</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/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-11-24 ~ 2026-02-23",
    "total": 189,
    "data": [
      {
        "name": "OpenAPI",
        "email": "OpenAPI",
        "departmentFull": "OpenAPI",
        "policyType": "Account Management - User Group Settings",
        "eventType": "Excel Registration",
        "eventDetailData": "Apply - [ All Users - 2 / Existing Users - 2 / New - 1 / Changed - 0 / Deleted - 0 ]",
        "ip": "127.0.0.1",
        "userAgent": "Other - PC - Other",
        "dateOfEntryUTC": "2026-02-23T01:44:10+00:00",
        "dateOfEntry": "2026-02-23T10:44:10+09:00"
      },
      {
        "name": "OpenAPI",
        "email": "OpenAPI",
        "departmentFull": "OpenAPI",
        "policyType": "Account Management - User Group Settings",
        "eventType": "Excel Registration",
        "eventDetailData": "Apply - [ All Users - 1 / Existing Users - 35 / New - 0 / Changed - 0 / Deleted - 33 ]",
        "ip": "127.0.0.1",
        "userAgent": "Other - PC - Other",
        "dateOfEntryUTC": "2026-02-23T01:35:56+00:00",
        "dateOfEntry": "2026-02-23T10:35:56+09:00"
      },
      {
        "name": "OpenAPI",
        "email": "OpenAPI",
        "departmentFull": "OpenAPI",
        "policyType": "Account Management - User Group Settings",
        "eventType": "Excel Registration",
        "eventDetailData": "Apply - [ All Users - 35 / Existing Users - 37 / New - 0 / Changed - 1 / Deleted - 2 ]",
        "ip": "127.0.0.1",
        "userAgent": "Other - PC - Other",
        "dateOfEntryUTC": "2026-02-23T01:31:37+00:00",
        "dateOfEntry": "2026-02-23T10:31:37+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


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

<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><li>Installation (Account Change) : 설치 (계정 변경)</li><li>Deletion (Account Change) : 삭제 (계정 변경)</li><li>Agent User Changed - [기존 사용자  이름(기존 사용자  Email) > 신규사용자이름(신규사용자 Email) ] : 에이전트 사용자 변경</li><li>Changed by Administrator - 관리자명(관리자Email) [ 이름(Email) > 신규이름(신규Email) ] : 관리자 계정 변경</li><li>Agent Auto Delete (Directory Sync) : 에이전트 자동 삭제 (조직도 연동)</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 %}


# 승인 이벤트

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

승인 이벤트를 조회하는 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>eventType</td><td>string</td><td><p><strong>이벤트 유형</strong></p><ul><li>Device Approval : 매체 승인</li><li>File Export Approval : 파일 반출 승인</li><li>Print Approval : 출력물 승인</li><li>Temporary Decryption Approval : 암호화 임시 해제 승인</li><li>Crypto Archive End Approval : 암호화 보관 종료 승인</li><li>Auto-approval settings : 자동 승인 설정</li><li>Auto-deletion exception : 자동 삭제 예외</li><li>Auto-deletion recovery : 자동 삭제 복구</li></ul></td></tr><tr><td>eventLocation</td><td>string</td><td><p><strong>이벤트 발생 경로</strong></p><ul><li>Admin Console : 관리자페이지</li><li>Email</li><li>user page : 사용자페이지</li><li>auto : 자동<br></li></ul></td></tr><tr><td>eventDetailData</td><td>array</td><td><p><strong>이벤트 유형 데이터 상세</strong></p><ul><li>Pending : 대기</li><li>Approved : 승인</li><li>Rejected : 반려</li><li>Allow(File Export Log) : 허용(파일반출 기록)</li><li>Block : 연결 차단</li><li>Read-only : 읽기전용</li><li>Exception : 관제대상에서 제외</li><li>Approval expiration time change : 승인 만료 시각 변경</li><li>Approved Time : 승인 시각</li><li>Expiring Time : 승인 만료 시각</li><li>Sensitive Information Files : 개인(민감)정보 파일</li><li>Do Not Scan Sensitive Information : 개인(민감)정보 검사 안 함</li><li>Sensitive Information Scan-Failed Files : 개인(민감)정보 검사 실패 파일</li><li>Encrypted File : 암호화 파일</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/v2/admin/approval?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": "2026-03-19 ~ 2026-06-19",
    "total": 120,
    "data": [
      {
        "name": "test",
        "email": "test@exosp.com",
        "departmentFull": "어벤져스 > 제품",
        "eventType": "Temporary Decryption Approval",
        "eventLocation": "Admin Console",
        "eventDetailData": "Approved - Exosphere(jbj) - Approved Time(2026-06-23 07:02:57) - Expiring Time(2026-06-23 09:02:57)",
        "ip": "192.168.0.11",
        "userAgent": "Chrome 120 / Windows 10",
        "dateTimeUTC": "2026-06-23T07:02:57+00:00",
        "dateTime": "2026-06-23T16:02:57+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 백업 파일 삭제 이벤트

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

백업 감사로그를 조회하는 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>eventType</td><td>string</td><td><p><strong>이벤트 유형</strong></p><ul><li>Storage Auto Cleanup Setting : 저장소 자동 정리 설정</li><li>Administrator Deletion : 관리자 삭제</li><li>Auto Cleanup : 자동 정리</li></ul></td></tr><tr><td>eventPath</td><td>string</td><td><p><strong>이벤트 발생 경로</strong></p><ul><li>Administrator Page : 관리자 페이지</li><li>Automatic : 자동</li></ul></td></tr><tr><td>eventDetailData</td><td>array</td><td><p><strong>이벤트 유형 데이터 상세</strong></p><ul><li>Backup File Auto Cleanup - Enabled : 백업 파일 자동 정리 - 활성화</li><li>Backup File Auto Cleanup - Disabled : 백업 파일 자동 정리 - 비활성화</li><li>(파일 이름 / 사용자(이메일) / 컴퓨터 이름 / 백업 파일 크기 / 백업 시각)</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/backup?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": "엑소스피어 서포터",
        "email": "support@exosp.com",
        "departmentFull": "엑소스피어",
        "eventType": "Storage Auto Cleanup Setting",
        "eventPath": "Administrator Page",
        "EventDetailData": "{'Value': 'Y'}",
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - windows",
        "dateOfEntryUTC": "2026-01-26T01:16:24+00:00",
        "dateOfEntry": "2026-01-26T10:16:24+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 제로트러스트 애플리케이션 연동 설정 이벤트

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

제로트러스트 애플리케이션 연동 설정 이벤트를 조회하는 API 입니다.

### Query Parameters

| <p><br>항목</p>                               | 타입     | 설명                                                                                                        |
| ------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------- |
| 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>eventType</td><td>string</td><td><p><strong>이벤트 유형</strong></p><ul><li>Application settings : 애플리케이션 설정</li><li>Application integration settings : 애플리케이션 연동 설정</li><li>SAML SSO certificate : SAML SSO 인증서</li><li>SDK option settings : SDK 옵션 설정</li><li>Automatic linking for unlinked users settings : 미연동 사용자 자동 연동 설정</li><li>Additional SSO option settings : SSO 추가 옵션 설정</li></ul></td></tr><tr><td>eventDetailData</td><td>array</td><td><ul><li>Add application : 애플리케이션 추가</li><li>Delete application : 애플리케이션 삭제</li><li>Edit application : 애플리케이션 수정</li><li>Link : 연결</li><li>Unlink : 연결 해제</li><li>Add certificate : 인증서 추가</li><li>Delete certificate : 인증서 삭제</li><li>Download certificate/metadata : 인증서/메타데이터 다운로드</li><li>Loading popup text : 로딩 팝업 텍스트</li><li>SDK device authentication settings : SDK 장치 인증 설정</li><li>Enable : 활성화</li><li>Disable : 비활성화</li><li>Modify ACS URL : ACS URL 수정</li><li>Modify Issuer URL : Issuer URL 수정</li></ul><p></p><ul><li>Category : 카테고리</li><li>Domain : 도메인</li><li>Description : 메모</li><li>Session duration : 인증 유지 시간</li><li>Log during session retention : 인증 유지 중 로그 기록</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>

#### 이벤트 유형 데이터 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>policyName</td><td>string</td><td>정책 이름</td></tr><tr><td>memo</td><td>string</td><td>정책 메모</td></tr><tr><td>startTimeUTC</td><td>string</td><td>정책 시작 시각</td></tr><tr><td>endTimeUTC</td><td>string</td><td>정책 종료 시각</td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/audit/v1/zts/admin/app?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-11-26 ~ 2026-02-25",
    "total": 2,
    "data": [
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "appTitle": "Google Workspace",
        "eventType": "Application integration settings",
        "eventDetailData": "Link",
        "ip": "",
        "userAgent": "Google Chrome",
        "dateOfEntry": "2026-02-23T17:44:35+09:00",
        "dateOfEntryUTC": "2026-02-23T08:44:35+00:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "appTitle": "Google Workspace",
        "eventType": "Application settings",
        "eventDetailData": "Add application",
        "ip": "",
        "userAgent": "Google Chrome",
        "dateOfEntry": "2026-02-23T17:44:32+09:00",
        "dateOfEntryUTC": "2026-02-23T08:44:32+00:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 제로트러스트 사용자 연동 이벤트

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

제로트러스트 사용자 연동 이벤트를 조회하는 API 입니다.

### Query Parameters

| <p><br>항목</p>                               | 타입     | 설명                                                                                                        |
| ------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------- |
| 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>appTitle</td><td>string</td><td><strong>애플리케이션</strong></td></tr><tr><td>eventType</td><td>string</td><td><strong>이벤트 유형</strong><br>User link settings : 사용자 연동 설정</td></tr><tr><td>eventPath</td><td>string</td><td><p><strong>이벤트 발생 경로</strong></p><ul><li>Admin page : 관리자 페이지</li><li>Email : 이메일</li><li>Application login : 애플리케이션 로그인</li><li>User security settings page : 사용자 보안 설정 페이지</li></ul></td></tr><tr><td>eventDetailData</td><td>array</td><td><ul><li>Link : 연동</li><li>UnLink : 연동 해제</li><li>Automatic linking of unlinked users : 미연동 사용자 자동 연동</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>

#### 이벤트 유형 데이터 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>policyName</td><td>string</td><td>정책 이름</td></tr><tr><td>memo</td><td>string</td><td>정책 메모</td></tr><tr><td>startTimeUTC</td><td>string</td><td>정책 시작 시각</td></tr><tr><td>endTimeUTC</td><td>string</td><td>정책 종료 시각</td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/audit/v1/zts/admin/app/user?offset=0&tableSize=3&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-11-26 ~ 2026-02-25",
    "total": 849,
    "data": [
      {
        "name": null,
        "email": null,
        "departmentFull": null,
        "appTitle": "코맷 test",
        "eventType": "User link settings",
        "eventPath": "Application login",
        "eventDetailData": "Automatic linking of unlinked users - [ test (test@exosp.com) ]",
        "ip": "-",
        "userAgent": "Google Chrome",
        "dateOfEntryUTC": "2026-01-26T07:55:06+00:00",
        "dateOfEntry": "2026-01-26T16:55:06+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "appTitle": "Google Workspace",
        "eventType": "User link settings",
        "eventPath": "Admin page",
        "eventDetailData": "Unlink - [ 지은 (jieun@devssoinfo.com) ]",
        "ip": "-",
        "userAgent": "Google Chrome",
        "dateOfEntryUTC": "2026-01-21T02:40:47+00:00",
        "dateOfEntry": "2026-01-21T11:40:47+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "appTitle": "Google Workspace",
        "eventType": "User link settings",
        "eventPath": "Admin page",
        "eventDetailData": "Link - [ 지은 (jieun@devssoinfo.com) ]",
        "ip": "-",
        "userAgent": "Google Chrome",
        "dateOfEntryUTC": "2026-01-21T02:40:28+00:00",
        "dateOfEntry": "2026-01-21T11:40:28+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 상태

## API 목록

{% content-ref url="/pages/A2ryEoKz1M5M1xbMYVks" %}
[IP 사용현황](/guide/status/ip)
{% endcontent-ref %}

{% content-ref url="/pages/cuIOvog8ihhqxIdZBkCE" %}
[하드웨어 현황](/guide/status/hardware)
{% endcontent-ref %}

{% content-ref url="/pages/oFvGEakR0v0nIUx71WgT" %}
[애플리케이션 별 설치현황](/guide/status/application-installations-application)
{% endcontent-ref %}

{% content-ref url="/pages/VLbC4QO5HxzYWZNxjadt" %}
[사용자 별 애플리케이션 설치현황](/guide/status/application-installations-user)
{% endcontent-ref %}

{% content-ref url="/pages/4fUhy6VHd6JkodrJbMju" %}
[PC 보안 점검 현황](/guide/status/vulnerability-check)
{% endcontent-ref %}

{% content-ref url="/pages/AVo5r6LtEJf4QeQmj3TK" %}
[Broken mention](broken://pages/AVo5r6LtEJf4QeQmj3TK)
{% endcontent-ref %}

{% content-ref url="/pages/vJl5mu85PFTLgu7xkK1E" %}
[에이전트 미설치 사용자 현황](/guide/agent/agent-distribute)
{% endcontent-ref %}

{% content-ref url="/pages/VLbC4QO5HxzYWZNxjadt" %}
[사용자 별 애플리케이션 설치현황](/guide/status/application-installations-user)
{% endcontent-ref %}


# IP 사용현황

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

IP 사용현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</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><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</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>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osDescription</td><td>string</td><td><strong>os 버전</strong></td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>publicIP</td><td>string</td><td><strong>공인 IP</strong></td></tr><tr><td>privateIP</td><td>string</td><td><strong>사설 IP</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>수집 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>수집 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/ip?offset=0&tableSize=1&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
      {
        "name": "신은진",
        "departmentName": "디자인",
        "departmentFull": "어벤져스 > 비즈니스 > 디자인",
        "computerName": "어변져스의 iMac",
        "osType": "macos",
        "osDescription": "Sonoma",
        "osUserName": "어변져스(designer)",
        "publicIP": "211.171.171.190",
        "privateIP": "10.100.73.10",
        "dateOfEntryUTC": "2024-07-15T23:27:08+00:00",
        "dateOfEntry": "2024-07-16T08:27:08+09:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 하드웨어 현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v2/hardware`

하드웨어 현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</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><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>osVersion</td><td>string</td><td><strong>os 버전</strong></td></tr><tr><td>macAddress</td><td>string</td><td><strong>mac 주소</strong></td></tr><tr><td>pc</td><td>array</td><td><a data-mention href="#pc">#pc</a></td></tr><tr><td>cpu</td><td>array</td><td><a data-mention href="#cpu">#cpu</a></td></tr><tr><td>mainBoard</td><td>array</td><td><a data-mention href="#mainboard">#mainboard</a></td></tr><tr><td>bios</td><td>array</td><td><a data-mention href="#bios">#bios</a></td></tr><tr><td>memory</td><td>array</td><td><a data-mention href="#memory">#memory</a></td></tr><tr><td>localDisk</td><td>array</td><td><a data-mention href="#localdisk">#localdisk</a></td></tr><tr><td>graphicCard</td><td>array</td><td><a data-mention href="#graphiccard">#graphiccard</a></td></tr><tr><td>monitor</td><td>array</td><td><a data-mention href="#monitor">#monitor</a></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### pc 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>model</td><td>string</td><td><strong>PC 종류</strong></td></tr><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>uuid</td><td>string</td><td><strong>UUID</strong></td></tr></tbody></table>

#### cpu 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>core</td><td>string</td><td><strong>코어 수</strong></td></tr></tbody></table>

#### mainBoard 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

#### bios 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

#### memory 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>memoryType</td><td>string</td><td><strong>메모리 종류</strong></td></tr><tr><td>memoryCapacity</td><td>string</td><td><strong>메모리 용량</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

#### localDisk 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>storageType</td><td>string</td><td><strong>저장소 종류</strong></td></tr><tr><td>totalCapacity</td><td>string</td><td><strong>전체 용량</strong></td></tr><tr><td>useCapacity</td><td>string</td><td><strong>사용 중</strong></td></tr><tr><td>freeCapacity</td><td>string</td><td><strong>남은 용량</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr></tbody></table>

#### graphicCard 상세

<table><thead><tr><th width="207">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>graphicCardCapacity</td><td>string</td><td><strong>그래픽 카드 용량</strong></td></tr><tr><td>core</td><td>string</td><td><strong>코어 수</strong></td></tr></tbody></table>

#### monitor 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/hardware?offset=0&tableSize=1&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
        {
                "name": "이수진",
                "departmentName": "웹서비스",
                "departmentFull": "어벤져스 > 제품 > 개발 > 웹서비스",
                "osType": "macos",
                "osUserName": "이수진(sujin)",
                "computerName": "이수진의 Mac mini",
                "pc": [
                    {
                        "model": "Mac mini (M1, 2020)",
                        "serialNumber": "D17PU0A1Q7P0",
                        "uuid": "D188F6BC-C5Q2-6Y0C-78B6-52CD322F3833"
                    }
                ],
                "cpu": [
                    {
                        "serialNumber": null,
                        "manufacturer": null,
                        "productName": "Apple M1",
                        "core": "8"
                    }
                ],
                "mainBoard": [],
                "bios": [],
                "memory": [
                    {
                        "serialNumber": null,
                        "memoryType": "LPDDR4",
                        "memoryCapacity": "16GB",
                        "manufacturer": "Hynix"
                    }
                ],
                "localDisk": [
                    {
                        "serialNumber": null,
                        "storageType": "SSD",
                        "totalCapacity": "494GB",
                        "useCapacity": "32GB",
                        "freeCapacity": "462GB",
                        "productName": "APPLE SSD AP0512Q"
                    }
                ],
                "graphicCard": [
                    {
                        "productName": "Apple M1",
                        "graphicCardCapacity": null,
                        "core": "8"
                    }
                ],
                "monitor": [
                    {
                        "serialNumber": "20515842",
                        "productName": "DELL P2723D",
                        "manufacturer": null
                    },
                    {
                        "serialNumber": "234b5362",
                        "productName": "DELL P2417H",
                        "manufacturer": null
                    }
                ],
                "dateOfEntryUTC": "2024-11-04T23:01:55+00:00",
                "dateOfEntry": "2024-11-05T08:01:55+09:00"
        }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 애플리케이션 별 설치현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v1/application-installations/application`

애플리케이션 별 설치현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</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><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 애플리케이션 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="166">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>softwareName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>installCount</td><td>string</td><td><strong>설치 수</strong></td></tr><tr><td>userList</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr></tbody></table>

#### 사용자 정보 상세

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>version</td><td>string</td><td><strong>버전 정보</strong></td></tr><tr><td>installDate</td><td>string</td><td><strong>설치 시각</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/application-installations/application?offset=0&tableSize=1&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
        {
            "softwareName": "Slack",
            "companyName": "Slack Technologies Inc.",
            "installCount": "12",
            "userList": [
                    {
                        "name": "이수지(이수지)",
                        "version": "4.41.105",
                        "installDate": "2024-12-16 00:00:00"
                    }
            ]
        }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 사용자 별 애플리케이션 설치현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v1/application-installations/user`

사용자 별 애플리케이션 설치 현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</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><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>softwareName</td><td>string</td><td><strong>제품 이름</strong></td></tr><tr><td>companyName</td><td>string</td><td><strong>공급자</strong></td></tr><tr><td>size</td><td>string</td><td><strong>크기</strong></td></tr><tr><td>version</td><td>string</td><td><strong>버전 정보</strong></td></tr><tr><td>installLocation</td><td>string</td><td><strong>설치 위치</strong></td></tr><tr><td>installDate</td><td>string</td><td><strong>설치 날짜</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/application-installations/user?offset=0&tableSize=1&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
        {
                "name": "이나영",
                "departmentName": "마케팅",
                "departmentFull": "마케팅",
                "osType": "windows",
                "osUserName": "이나영",
                "computerName": "이나영",
                "softwareName": "Microsoft Edge",
                "companyName": "Microsoft Corporation",
                "size": "0KB",
                "version": "131.0.2903.99",
                "installLocation": "C:\\Program Files (x86)\\Microsoft\\Edge\\Application",
                "installDate": "2024-12-16"
        },
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# PC 보안 점검 현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v1/vulnerability-check`

PC 보안 점검 현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</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><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></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>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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>summary</td><td>object</td><td><a data-mention href="#summary">#summary</a></td></tr><tr><td>result</td><td>object</td><td><a data-mention href="#windows">#windows</a>, <a data-mention href="#macos">#macos</a></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>수집 시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>수집 시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### summary 상세

<table><thead><tr><th width="162">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>secure</td><td>int</td><td><strong>안전</strong></td></tr><tr><td>weak</td><td>int</td><td><strong>취약</strong></td></tr><tr><td>fail</td><td>int</td><td><strong>점검 실패</strong></td></tr><tr><td>uncheckable</td><td>int</td><td><strong>점검 불가</strong></td></tr><tr><td>unScanned</td><td>int</td><td><strong>점검 안함</strong></td></tr></tbody></table>

#### windows 결과 상세

<table><thead><tr><th width="169">항목</th><th width="80">데이터</th><th width="174">상세</th><th width="79">타입</th><th>설명</th></tr></thead><tbody><tr><td>updateOperatingSystem</td><td></td><td></td><td>object</td><td><strong>운영체제 업데이트</strong></td></tr><tr><td></td><td>status</td><td></td><td></td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>array</td><td>상세</td></tr><tr><td></td><td></td><td>osVersion</td><td>string</td><td>업데이트 가능한 OS 버전</td></tr><tr><td>enableAntivirus</td><td></td><td></td><td>object</td><td><strong>백신 프로그램 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, </p><p>Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>array</td><td>상세</td></tr><tr><td></td><td></td><td>productName</td><td>string</td><td>제품 이름</td></tr><tr><td></td><td></td><td>realTimeProtection</td><td>string</td><td>실시간 보호 사용 여부<br>Using : 사용 중, <br>Not Using : 사용 안함</td></tr><tr><td></td><td></td><td>updateStatus</td><td>string</td><td><p>업데이트 상세<br>The Latest Version : 최신 버전, </p><p>Update Required : 업데이트 필요</p></td></tr><tr><td>enableFirewall</td><td></td><td></td><td>object</td><td><strong>방화벽 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>array</td><td>상세</td></tr><tr><td></td><td></td><td>productName</td><td>string</td><td>제품 이름</td></tr><tr><td></td><td></td><td>realTimeProtection</td><td>string</td><td>실시간 보호 사용 여부<br>Using : 사용 중, <br>Not Using : 사용 안함</td></tr><tr><td></td><td></td><td>updateStatus</td><td>string</td><td><p>업데이트 상세<br>The Latest Version : 최신 버전, </p><p>Update Required : 업데이트 필요</p></td></tr><tr><td>useSecurePassword</td><td></td><td></td><td>object</td><td><strong>안전한 비밀번호 사용 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>array</td><td>상세</td></tr><tr><td></td><td></td><td>impossibleReason</td><td>string</td><td>점검 불가 사유</td></tr><tr><td>changePasswordPeriodically</td><td></td><td></td><td>object</td><td><strong>주기적인 비밀번호 변경 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>object</td><td>상세</td></tr><tr><td></td><td></td><td>lastChangeDate</td><td>string</td><td><strong>마지막 패스워드 변경일</strong></td></tr><tr><td>enableScreenSaver</td><td></td><td></td><td>object</td><td><strong>화면 보호기 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>object</td><td>상세</td></tr><tr><td></td><td></td><td>screenSaver</td><td>string</td><td>화면 보호기 사용 여부<br>Using : 사용 중, <br>Not Using : 사용 안함</td></tr><tr><td></td><td></td><td>logonScreenOnRestart</td><td>string</td><td>다시 시작할 때 로그온 표시<br>Using : 사용 중, <br>Not Using : 사용 안함</td></tr><tr><td></td><td></td><td>waitTime</td><td>string</td><td>대기시간(분)</td></tr><tr><td>disableSharedFolder</td><td></td><td></td><td>object</td><td><strong>공유폴더 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td></td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>array</td><td>상세</td></tr><tr><td></td><td></td><td>folder</td><td>string</td><td>공유 폴더</td></tr><tr><td>disableUSBAutoPlay</td><td></td><td></td><td>object</td><td><strong>USB 자동 실행 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>null</td><td>-</td></tr><tr><td>updateSoftware</td><td></td><td></td><td>object</td><td><strong>소프트웨어 업데이트 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>array</td><td>상세</td></tr><tr><td></td><td></td><td>productName</td><td>string</td><td>제품 이름</td></tr><tr><td></td><td></td><td>updateStatus</td><td>string</td><td>업데이트 상태 <br>The Latest Version : 최신 버전, <br>Update Required : 업데이트 필요</td></tr></tbody></table>

#### macos 결과 상세

<table><thead><tr><th width="196">항목</th><th width="81">데이터</th><th width="157">상세</th><th width="80">타입</th><th>설명</th></tr></thead><tbody><tr><td>updateOperatingSystem</td><td></td><td></td><td>object</td><td><strong>운영체제 업데이트 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>array</td><td>상세</td></tr><tr><td></td><td></td><td>osVersion</td><td>string</td><td>업데이트 가능한 OS 버전</td></tr><tr><td>enableSystemIntegrityProtection</td><td></td><td></td><td>object</td><td><strong>시스템 무결성 보호 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>null</td><td>-</td></tr><tr><td>blockUnverifiedAppleApps</td><td></td><td></td><td>object</td><td><strong>Apple미검증 앱 실행차단 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>null</td><td>-</td></tr><tr><td>enableFirewall</td><td></td><td></td><td>object</td><td><strong>방화벽 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>null</td><td>-</td></tr><tr><td>useSecurePassword</td><td></td><td></td><td>object</td><td><strong>안전한 비밀번호 사용 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>null</td><td>-</td></tr><tr><td>changePasswordPeriodcally</td><td></td><td></td><td>object</td><td><strong>주기적인 비밀번호 변경</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>object</td><td>상세</td></tr><tr><td></td><td></td><td>lastChangeDate</td><td>string</td><td>마지막 패스워드 변경일</td></tr><tr><td>enableScreenSaver</td><td></td><td></td><td>object</td><td><strong>화면 보호기 점검</strong></td></tr><tr><td></td><td>status</td><td></td><td>string</td><td><p>상태<br>Secure : 안전, </p><p>Weak : 취약, </p><p>Fail : 점검 실패, </p><p>Un Scanned : 점검 안함, Uncheckable : 점검 불가</p></td></tr><tr><td></td><td>detail</td><td></td><td>object</td><td>상세</td></tr><tr><td></td><td></td><td>screenSaver</td><td>string</td><td>화면 보호기 시작</td></tr><tr><td></td><td></td><td>requirePasswordOnRestart</td><td>string</td><td>다시 시작할 때 비밀번호 요구</td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/vulnerability-check?offset=0&tableSize=1&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
        {
                "name": "최수영",
                "departmentName": "이지연",
                "departmentFull": "어벤져스 > 제품 > CX > 최수영",
                "osType": "windows",
                "osUserName": "suyouong",
                "computerName": "DESKTOP-SUYOUNG",
                "summary": {
                    "secure": 7,
                    "weak": 1,
                    "fail": 0,
                    "uncheckable": 0,
                    "unScanned": 1
                },
                "result": {
                    "updateOperatingSystem": {
                        "status": "Un Scanned",
                        "detail": null
                    },
                    "enableAntivirus": {
                        "status": "Secure",
                        "detail": [
                            {
                                "productName": "엑소스피어",
                                "realTimeProtection": "Using",
                                "updateStatus": "The Latest Version"
                            }
                        ]
                    },
                    "enableFirewall": {
                        "status": "Secure",
                        "detail": [
                            {
                                "productName": "Windows Firewall",
                                "realTimeProtection": "Using",
                                "updateStatus": "The Latest Version"
                            }
                        ]
                    },
                    "useSecurePassword": {
                        "status": "Secure",
                        "detail": null
                    },
                    "changePasswordPeriodically": {
                        "status": "Secure",
                        "detail": {
                            "lastChangeDate": "2024-10-31T10:42:59+09:00(47days ago)"
                        }
                    },
                    "enableScreenSaver": {
                        "status": "Secure",
                        "detail": {
                            "screenSaver": "Using",
                            "logonScreenOnRestart": "Using",
                            "waitTime": "10minutes later"
                        }
                    },
                    "disableSharedFolder": {
                        "status": "Secure",
                        "detail": null
                    },
                    "disableUSBAutoPlay": {
                        "status": "Secure",
                        "detail": null
                    },
                    "updateSoftware": {
                        "status": "Weak",
                        "detail": [
                            {
                                "productName": "Mozilla Firefox",
                                "updateStatus": "Update Required"
                            },
                            {
                                "productName": "Chrome",
                                "updateStatus": "Update Required"
                            },
                            {
                                "productName": "Microsoft Edge",
                                "updateStatus": "Update Required"
                            }
                        ]
                    }
                },
                "dateOfEntryUTC": "2024-12-17T02:36:13+00:00",
                "dateOfEntry": "2024-12-17T11:36:13+09:00"
        },
        {
                "name": "이수진",
                "departmentName": "웹서비스",
                "departmentFull": "어벤져스 > 제품 > 개발 > 웹서비스",
                "osType": "macos",
                "osUserName": "이수진(sujin)",
                "computerName": "이수진의 Mac mini",
                "summary": {
                    "secure": 3,
                    "weak": 4,
                    "fail": 0,
                    "uncheckable": 0,
                    "unScanned": 0
                },
                "result": {
                    "updateOperatingSystem": {
                        "status": "Weak",
                        "detail": [
                            {
                                "osVersion": "macOS Sequoia 15.2"
                            },
                            {
                                "osVersion": "macOS Sonoma 14.7.2"
                            },
                            {
                                "osVersion": "Command Line Tools for Xcode 16.2"
                            }
                        ]
                    },
                    "enableSystemIntegrityProtection": {
                        "status": "Secure",
                        "detail": null
                    },
                    "blockUnverifiedAppleApps": {
                        "status": "Secure",
                        "detail": null
                    },
                    "enableFirewall": {
                        "status": "Weak",
                        "detail": null
                    },
                    "useSecurePassword": {
                        "status": "Weak",
                        "detail": null
                    },
                    "changePasswordPeriodically": {
                        "status": "Secure",
                        "detail": {
                            "lastChangeDate": "2024-10-28T10:10:37+09:00(50days ago)"
                        }
                    },
                    "enableScreenSaver": {
                        "status": "Weak",
                        "detail": null
                    }
                },
                "dateOfEntryUTC": "2024-12-17T02:35:14+00:00",
                "dateOfEntry": "2024-12-17T11:35:14+09:00"
        }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 개인(민감)정보 사용자별 현황

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

개인(민감)정보 사용자별 현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>email<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 메일</strong></td></tr><tr><td>name<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 이름</strong> </td></tr><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>sortField</td><td>string</td><td><strong>개인(민감)정보의 보유량이 많은 파일의 정렬을 원하는 컬럼명</strong><br>DetectionTotalCount : 개인(민감)정보 개수, DetectionTime : 탐지 시각</td></tr><tr><td>sortType</td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 컴퓨터이름, 파일이름 </p><p>기본값 : 빈값</p></td></tr><tr><td>cfRsSortField</td><td>string</td><td><strong>개인(민감)정보 파일의 보유량이 많은 PC의 정렬을 원하는 컬럼명</strong><br>FileCount : 탐지된 파일 수, CFCount : 개인(민감)정보 개수, MaxDetectionTime : 최근 탐지 시각</td></tr><tr><td>cfRsSortType</td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></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>fileCount</td><td>int</td><td>개인(민감)정보 파일 수</td></tr><tr><td>cfCount</td><td>int</td><td>개인(민감)정보 수</td></tr><tr><td>log_cf_status_info</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr><tr><td>log_cf_rs_info</td><td>int</td><td><a data-mention href="#pc">#pc</a></td></tr></tbody></table>

#### 개인(민감)정보 보유 현황

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>user</td><td>string</td><td><strong>사용자(PC)</strong></td></tr><tr><td>detectType</td><td>string</td><td><p><strong>구분</strong><br>Real-Time Scan : 실시간 탐지</p><p>Administrator Scheduled Scan : 관리자 예약검사</p><p>User Full Scan : 사용자 전체검사</p><p>User Custom Scan : 사용자 지정검사</p></td></tr><tr><td>inspectionType</td><td>string</td><td><p><strong>검사 유형</strong><br>Quick Scan : 빠른 검사</p><p>Full Scan : 일반 검사</p></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>detectCount</td><td>string</td><td><strong>개인(민감)정보 수</strong></td></tr><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>osType</td><td>string</td><td><strong>OS 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>OS 계정</strong></td></tr><tr><td>detectResult</td><td>string</td><td><a data-mention href="#undefined-1">#undefined-1</a></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>fileSize</td><td>string</td><td><strong>파일 크기</strong></td></tr><tr><td>protectionType</td><td>string</td><td><p><strong>보호 유형</strong><br>No Protection : 보호 처리 없음</p><p>Encryption : 암호화</p></td></tr><tr><td>encryptionResult</td><td>string</td><td><p><strong>암호화 결과</strong><br>No Protection : 보호 처리 없음</p><p>Encryption : 암호화</p></td></tr><tr><td>detectionTime</td><td>string</td><td><strong>탐지 시각(사용자 기준)</strong><br>요청 타임존 기준,  ISO 8601포맷</td></tr><tr><td>detectionTimeUTC</td><td>string</td><td><strong>탐지 시각(PC 기준)</strong><br>UTC 기준, ISO 8601포맷</td></tr></tbody></table>

#### 개인 민감 정보 상세

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>type</td><td>string</td><td><p><strong>개인(민감)정보 구분</strong><br>Type : 개인(민감)정보 유형</p><p> Keyword : 개인(민감)정보 키워드</p></td></tr><tr><td>name</td><td>string</td><td><strong>개인(민감)정보 유형 / 키워드</strong></td></tr><tr><td>count</td><td>int</td><td><strong>탐지건수</strong></td></tr></tbody></table>

#### PC별 개인(민감)정보 보유 현황

<table><thead><tr><th width="198.4375">항목</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>fileCount</td><td>int</td><td><strong>개인(민감)정보 파일 수</strong></td></tr><tr><td>cfCount</td><td>int</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>OS 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>OS 계정</strong></td></tr><tr><td>maxDetectionTime</td><td>string</td><td><strong>탐지 시각(사용자 기준)</strong><br>요청 타임존 기준,  ISO 8601포맷</td></tr><tr><td>maxDetectionTimeUTC</td><td>string</td><td><strong>탐지 시각(PC 기준)</strong><br>UTC 기준, ISO 8601포맷</td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/cf/user?email=test%40exosp.com&name=test&currentPage=0&tableSize=1000&sortField=DetectionTotalCount&sortType=DESC&cfRsSortField=FileCount&cfRsSortType=DESC&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "fileCount": 1,
    "cfCount": 5,
    "log_cf_status_info_count": 1,
    "log_cf_status_info": [
      {
        "user": "test(test의 Mac mini (2))",
        "detectType": "Administrator Scheduled Scan",
        "inspectionType": "Quick Scan",
        "fileName": "SAVAPI-Documentation-v4.15.pdf",
        "detectCount": 5,
        "name": "test",
        "departmentFull": "test",
        "computerName": "Deok의 Mac mini (2)",
        "osType": "macos",
        "osUserName": "test Mac Mini(test)",
        "detectResult": [
          {
            "type": "Type",
            "name": "Email",
            "count": 5
          }
        ],
        "filePath": "/Users/test/Downloads/SAVAPI-Documentation-v4.15.pdf",
        "fileSize": 1429562,
        "protectionType": "No Protection",
        "encryptionResult": "No Protection",
        "detectionTime": "2024-05-21T18:02:41+09:00",
        "detectionTimeUTC": "2024-05-21T09:02:41+00:00"
      }
    ],
    "log_cf_rs_info_count": 1,
    "log_cf_rs_info": [
      {
        "name": "test(test의 Mac mini (2))",
        "departmentFull": "test",
        "fileCount": 1,
        "cfCount": 5,
        "computerName": "test의 Mac mini (2)",
        "osType": "macos",
        "osUserName": "test Mac Mini(test)",
        "maxDetectionTime": "2024-05-21T19:04:40+09:00",
        "maxDetectionTimeUTC": "2024-05-21T10:04:40+00:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 사용자(조직)

## API 목록

{% content-ref url="/pages/RN3mlCEDS9qGSrBrRM6c" %}
[사용자 조회](/guide/organization/get-member)
{% endcontent-ref %}

{% content-ref url="/pages/N7uozi4PmqslfWmNNrMt" %}
[사용자 생성하기\_v1](/guide/organization/post-member)
{% endcontent-ref %}

{% content-ref url="/pages/bKamAZmGCE8GGEVyFNQq" %}
[사용자 수정하기](/guide/organization/put-member)
{% endcontent-ref %}

{% content-ref url="/pages/hjv8N4DDmXv8y5VbNksw" %}
[사용자 삭제하기](/guide/organization/delete-member)
{% endcontent-ref %}

{% content-ref url="/pages/KBS48xTNYTq3z9vOhfNz" %}
[그룹(부서) 조회](/guide/organization/get-department)
{% endcontent-ref %}

{% content-ref url="/pages/WwmzZozzQqzNDcVl4Znt" %}
[그룹(부서) 생성하기](/guide/organization/post-department)
{% endcontent-ref %}

{% content-ref url="/pages/o1Y7gZvkBzJ92jhguGhg" %}
[그룹(부서) 수정하기](/guide/organization/put-department)
{% endcontent-ref %}

{% content-ref url="/pages/vBAkp5OymYKTTqjSdOP2" %}
[그룹(부서) 삭제하기](/guide/organization/delete-department)
{% endcontent-ref %}


# 사용자 조회

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

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

### 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>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>isNotEmailTypeVaild</td><td>string</td><td><p><strong>아이디에 대한 이메일 형태 체크여부</strong></p><p>(Y: 유효성 체크함, N: 체크 안함)</p></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/organization/v1/member' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
    "code": 0,
    "message": "success",
    "body": {
        "total": 8,
        "data": [
            {
                "name": "test1",
                "email": "test1@exosp.com",
                "isNotEmailTypeValid": "N",
                "departmentName": "test",
                "departmentFullName": "test"
            },
            {
                "name": "test2",
                "email": "test2@exosp.com",
                "isNotEmailTypeValid": "N",
                "departmentName": "test2",
                "departmentFullName": "test > test2"
            },
            {
                "name": "test3",
                "email": "test3.exosp.com",
                "isNotEmailTypeValid": "N",
                "departmentName": "test2",
                "departmentFullName": "test > test2"
            },
            {
                "name": "test4",
                "email": "test4@exosp.com",
                "isNotEmailTypeValid": "N",
                "departmentName": "test4",
                "departmentFullName": "test > test3 > test4"
            },
            {
                "name": "test5",
                "email": "test5@exosp.com",
                "isNotEmailTypeValid": "N",
                "departmentName": "test4",
                "departmentFullName": "test > test3 > test4"
            },
            {
                "name": "test6",
                "email": "test6@exosp.com",
                "isNotEmailTypeValid": "N",
                "departmentName": "test4",
                "departmentFullName": "test > test3 > test4"
            },
            {
                "name": "test7",
                "email": "test7@exosp.com",
                "isNotEmailTypeValid": "N",
                "departmentName": "test",
                "departmentFullName": "test"
            },
            {
                "name": "test7",
                "email": "test7@exosp.com",
                "isNotEmailTypeValid": "Y",
                "departmentName": "test7",
                "departmentFullName": "test > test7"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}


# 사용자 생성하기\_v1

<mark style="background-color:green;">POST</mark> `https://openapi.exosp.com/organization/v1/member`

사용자 정보를 생성하는 API 입니다.

### Request Body <a href="#query-parameters" id="query-parameters"></a>

| 항목                                               | 타입     | 설명                                            |
| ------------------------------------------------ | ------ | --------------------------------------------- |
| name<mark style="color:red;">\*</mark>           | string | **사용자 이름**                                    |
| email<mark style="color:red;">\*</mark>          | string | **사용자 메일**                                    |
| departmentFull<mark style="color:red;">\*</mark> | string | **그룹 전체 경로**                                  |
| isNotEmailTypeValid                              | string | **아이디에 대한 이메일 형태 체크여부**(Y: 유효성 체크함, N: 체크 안함) |

### 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>data</td><td>array</td><td><strong>응답 데이터</strong></td></tr></tbody></table>

#### data 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>inserted_members</td><td>int</td><td><strong>생성된 사용자 수</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'POST' \
  'https://openapi.exosp.com/organization/v1/member' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 
  -d '{
  "memberList": [
    {
      "name": "tuser",
      "email": "tuser@exosp.com",
      "isNotEmailTypeValid": "N",
      "departmentFull": "test"
    }
  ]
}'
 
{
  "code": 0,
  "message": "success",
  "body": {
    "total": 1,
    "data": [
      {
        "inserted_members": 1
      }
    ]
  }
}
```

{% endtab %}

{% tab title="Untitled" %}

{% endtab %}
{% endtabs %}


# 사용자 생성하기

<mark style="background-color:green;">POST</mark> `https://openapi.exosp.com/organization/v1/member`

사용자 정보를 생성하는 API 입니다.

### Request Body <a href="#query-parameters" id="query-parameters"></a>

| 항목                                                     | 타입     | 설명                                            |
| ------------------------------------------------------ | ------ | --------------------------------------------- |
| name<mark style="color:red;">\*</mark>                 | string | **사용자 이름**                                    |
| email<mark style="color:red;">\*</mark>                | string | **사용자 메일**                                    |
| departmentFull<mark style="color:red;">\*</mark>       | string | **그룹 전체 경로**                                  |
| isNotEmailTypeValid                                    | string | **아이디에 대한 이메일 형태 체크여부**(Y: 유효성 체크함, N: 체크 안함) |
| sendInstallationMail<mark style="color:red;">\*</mark> | string | **설치 메일 발송 여부(Y/N)**                          |

### 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>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>inserted</td><td>string</td><td><strong>등록 여부</strong></td></tr><tr><td>mailSent</td><td>string</td><td><strong>메일 발송 여부</strong></td></tr><tr><td>errorMessage</td><td>string</td><td><strong>오류 메시지</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'POST' \
  'https://openapi.exosp.com/organization/v1/member' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 
  -d '{
  "memberList": [
    {
      "name": "test12345",
      "email": "test12345@exosp.com",
      "isNotEmailTypeValid": "N",
      "departmentFull": "test",
      "sendInstallationMail": "Y"
    }
  ]
}'
 
{
  "code": 0,
  "message": "success",
  "body": {
    "total": 1,
    "data": [
      {
        "name": "test12345",
        "email": "test12345@exosp.com",
        "departmentFull": "dev-ys > dev-ysmoon",
        "inserted": false,
        "mailSent": false,
        "errorMessage": "Email already exists"
      }
    ]
  }
}
```

{% endtab %}

{% tab title="Untitled" %}

{% endtab %}
{% endtabs %}


# 사용자 일괄 동기화(추가/수정/삭제)

<mark style="background-color:green;">POST</mark> `https://openapi.exosp.com/organization/v1/member/batch-sync`

사용자 정보를 일괄 동기화하는 API 입니다.

* 추가(Create)&#x20;
  * 보내준 항목의 식별자가 없거나, 서버에서 찾을 수 없으면 새 항목을 만들어 넣습니다.
* 수정(Update)&#x20;
  * 보내준 항목의 식별자(id 등)가 서버에 이미 있으면, 그 항목의 값을 최신 내용으로 바꿉니다.
* 삭제(Delete)
  * 서버에는 있는데 이번 요청 목록에 포함되지 않은 항목은 더 이상 필요하지 않은 것으로 보고 삭제합니다.

### Request Body <a href="#query-parameters" id="query-parameters"></a>

| 항목                                                     | 타입     | 설명                                   |
| ------------------------------------------------------ | ------ | ------------------------------------ |
| memberList<mark style="color:red;">\*</mark>           | array  | [#memberlist](#memberlist "mention") |
| sendInstallationMail<mark style="color:red;">\*</mark> | string | **설치 메일 발송 여부(Y/N)**                 |

#### MemberList

| 항목                                               | 타입     | 설명                                            |
| ------------------------------------------------ | ------ | --------------------------------------------- |
| name<mark style="color:red;">\*</mark>           | string | **사용자 이름**                                    |
| email<mark style="color:red;">\*</mark>          | string | **사용자 메일**                                    |
| departmentFull<mark style="color:red;">\*</mark> | string | **그룹 전체 경로**                                  |
| isNotEmailTypeValid                              | string | **아이디에 대한 이메일 형태 체크여부**(Y: 유효성 체크함, N: 체크 안함) |

### 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="183.2265625">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>summary</td><td>array</td><td><a data-mention href="#summary">#summary</a></td></tr><tr><td>insertMemberDetail</td><td>array</td><td><a data-mention href="#member">#member</a></td></tr><tr><td>updateMemberDetail</td><td>array</td><td><a data-mention href="#member">#member</a></td></tr><tr><td>deleteMemberDetail</td><td>array</td><td><a data-mention href="#member">#member</a></td></tr></tbody></table>

#### summary 상세

<table><thead><tr><th width="196.63671875">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>totalMember</td><td>int</td><td><strong>총 사용자 수</strong></td></tr><tr><td>originMember</td><td>int</td><td><strong>기존 사용자 수</strong></td></tr><tr><td>insertMember</td><td>int</td><td><strong>추가 사용자 수</strong></td></tr><tr><td>updateMember</td><td>int</td><td><strong>수정 사용자 수</strong></td></tr><tr><td>deleteMember</td><td>int</td><td><strong>삭제 사용자 수</strong> </td></tr></tbody></table>

#### member 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>email</td><td>string</td><td><strong>사용자 메일</strong></td></tr><tr><td>success</td><td>string</td><td><strong>성공 여부</strong></td></tr><tr><td>message</td><td>string</td><td><strong>오류 메세지</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'POST' \
  'https://openapi.exosp.com/organization/v1/member/batch-sync' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 
  -d '{
  "memberList": [
    {
      "name": "ysmoon",
      "email": "ysmoon@exosp.com",
      "departmentFull": "dev-ys",
      "isNotEmailTypeValid": "N"
    },
    {
      "name": "test",
      "email": "test@exosp.com",
      "departmentFull": "dev-ys",
      "isNotEmailTypeValid": "N"
    }
  ],
  "sendInstallationMail": "N"
}'
 
{
  "code": 0,
  "message": "success",
  "body": {
    "summary": {
      "totalMember": 2,
      "originMember": 2,
      "insertMember": 1,
      "updateMember": 0,
      "deleteMember": 0
    },
    "insertMemberDetail": [
      {
        "email": "test@exosp.com",
        "name": "test",
        "success": true
      }
    ],
    "updateMemberDetail": [],
    "deleteMemberDetail": [
      {
        "email": "user11@exosp.com",
        "success": false,
        "error": "Cannot delete member with manager role"
      }
    ]
  }
}
```

{% endtab %}

{% tab title="Untitled" %}

{% endtab %}
{% endtabs %}


# 사용자 수정하기

<mark style="background-color:green;">PUT</mark> `https://openapi.exosp.com/organization/v1/member`

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

### Request Body

<table><thead><tr><th width="249">항목</th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td>beforeMemberName<mark style="color:red;">*</mark></td><td>string</td><td><strong>이전</strong> <strong>사용자 이름</strong></td></tr><tr><td>beforeMemberEmail<mark style="color:red;">*</mark></td><td>string</td><td><strong>이전 사용자 메일</strong></td></tr><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>isNotEmailTypeValid</td><td>string</td><td><p><strong>아이디에 대한 이메일 형태 체크여부</strong></p><p>(Y: 유효성 체크함, N: 체크 안함)</p></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>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>inserted_members</td><td>int</td><td><strong>생성된 사용자 수</strong></td></tr><tr><td>errors</td><td>array</td><td><a data-mention href="#errors">#errors</a></td></tr></tbody></table>

#### errors 상세

<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>error</td><td>string</td><td><strong>오류 메세지</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'PUT' \
  'http://openapi.exosp.com/organization/v1/member' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: d992206eb001e717f8a690590c430d96' \
  -H 'x-exosp-secret: iiarwgz4yCAzTdkWNotKLfRiuSKsZPov' \
  -H 'Content-Type: application/json' \
  -d '{
  "beforeMemberName": "tuser",
  "beforeMemberEmail": "tuser@exosp.com",
  "name": "tuser",
  "email": "tuser@exosp.com",
  "departmentFull": "test > test1",
  "isNotEmailTypeValid": "N"
}'
  

{
  "code": 0,
  "message": "success",
  "body": null
}
```

{% endtab %}

{% tab title="Fail" %}

```bash
curl -X 'POST' \
  'http://127.0.0.1:8000/organization/v1/member' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: d992206eb001e717f8a690590c430d96' \
  -H 'x-exosp-secret: iiarwgz4yCAzTdkWNotKLfRiuSKsZPov' \
  -H 'x-app-env: dev' \
  -H 'Content-Type: application/json' \
  -d '{
  "memberList": [
    {
      "name": "testuser4",
      "email": "testuser4@exosp.com",
      "isNotEmailTypeValid": "N",
      "departmentFull": "test > test1"
    },
    {
      "name": "testuser5",
      "email": "testuser5@exosp.com",
      "isNotEmailTypeValid": "N",
      "departmentFull": "test > test1"
    }
  ]
}'

{
  "code": 1,
  "message": "transaction rolled back due to failure",
  "body": {
    "total": 2,
    "data": [
      {
        "inserted_members": 0,
        "errors": [
          {
            "name": "testuser4",
            "email": "testuser4@exosp.com",
            "departmentFull": "test > test1",
            "error": "Email already exists"
          },
          {
            "name": "testuser5",
            "email": "testuser5@exosp.com",
            "departmentFull": "test > test1",
            "error": "Email already exists"
          }
        ]
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 사용자 삭제하기

<mark style="background-color:green;">DELETE</mark> `https://openapi.exosp.com/organization/v1/member`

사용자 정보를 삭제하는 API 입니다.

### Request Body

<table><thead><tr><th width="249">항목</th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td>name<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>email<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 메일</strong></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></tbody></table>

### Example

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

```javascript
curl -X 'DELETE' \
  'https://openapi.exosp.com/organization/v1/member' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' \
  -d '{
  "name": "tuser",
  "email": "tuser@exosp.com"
}'

{
  "code": 0,
  "message": "success"
}
```

{% endtab %}
{% endtabs %}


# 그룹(부서) 조회

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

그룹(부서) 정보를 조회하는 API 입니다.

### 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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong> </td></tr><tr><td>subDepartments</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr></tbody></table>

#### 하위 부서 상세

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong> </td></tr><tr><td>subDepartments</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/organization/v1/department' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "name": "test",
    "fullName": "test",
    "subDepartments": [
      {
        "name": "test2",
        "fullName": "test > test2",
        "subDepartments": []
      },
      {
        "name": "test3",
        "fullName": "test > test3",
        "subDepartments": []
      },
      {
        "name": "test4",
        "fullName": "test > test4",
        "subDepartments": [
          {
            "name": "dev",
            "fullName": "test > test4 > dev",
            "subDepartments": []
          },
          {
            "name": "test5",
            "fullName": "test > test4 > test5",
            "subDepartments": []
          }
        ]
      },
      {
        "name": "test5",
        "fullName": "test > test5",
        "subDepartments": []
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 그룹(부서) 생성하기

<mark style="background-color:green;">POST</mark> `https://openapi.exosp.com/organization/v1/department`

그룹(부서) 정보를 생성하는 API 입니다.

### Request Body

<table><thead><tr><th width="249">항목</th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td>departmentFull<mark style="color:red;">*</mark></td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>departmentName<mark style="color:red;">*</mark></td><td>string</td><td><strong>그룹 이름</strong></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></tbody></table>

### Example

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

```javascript
curl -X 'POST' \
  'https://openapi.exosp.com/organization/v1/department' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' \
  -d '{
  "departmentFull": "test",
  "departmentName": "test1"
}'
{
  "code": 0,
  "message": "success",
  "body": null
}
```

{% endtab %}
{% endtabs %}


# 그룹(부서) 수정하기

<mark style="background-color:green;">PUT</mark> `https://openapi.exosp.com/organization/v1/department`

그룹(부서) 정보를 수정하는 API 입니다.

### Request Body

<table><thead><tr><th width="249">항목</th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td>beforeUpperDepartmentFull<mark style="color:red;">*</mark></td><td>string</td><td><strong>이전</strong> <strong>상위</strong> <strong>그룹 전체 경로</strong></td></tr><tr><td>beforeDepartmentName<mark style="color:red;">*</mark></td><td>string</td><td><strong>이전 그룹 이름</strong></td></tr><tr><td>upperDepartmentFull</td><td>string</td><td><strong>상위</strong> <strong>그룹 전체 경로</strong></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></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></tbody></table>

### Example

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

```javascript
curl -X 'PUT' \
  'https://openapi.exosp.com/organization/v1/department' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' \
  -d '{
  "beforeUpperDepartmentFull": "test",
  "beforeDepartmentName": "test1",
  "upperDepartmentFull": "test",
  "departmentName": "test2"
}'

{
  "code": 0,
  "message": "success"
}
```

{% endtab %}
{% endtabs %}


# 그룹(부서) 삭제하기

<mark style="background-color:green;">DELETE</mark> `https://openapi.exosp.com/organization/v1/department`

그룹(부서) 정보를 삭제하는 API 입니다.

### Request Body

<table><thead><tr><th width="249">항목</th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td>departmentFull<mark style="color:red;">*</mark></td><td>string</td><td><strong>그룹 전체 경로</strong></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></tbody></table>

### Example

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

```javascript
curl -X 'DELETE' \
  'https://openapi.exosp.com/organization/v1/department' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' \
  -d '{
  "departmentFull": "dev-ys > test1"
}'

{
  "code": 0,
  "message": "success"
}
```

{% endtab %}
{% endtabs %}


# 에이전트

{% content-ref url="/pages/MLapt3mbJiRYLRGRwMFu" %}
[에이전트 삭제](/guide/agent/agent-uninstall)
{% endcontent-ref %}


# 에이전트 현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v3/agent/install`

에이전트 현황을 조회하는 API 입니다.

* 조회대상(departmentType)은 선택사항입니다. 미제공 시 전체(필터 미적용) 기준으로 조회됩니다.
* 조회대상을 지정하면 해당 타입별 조건을 반드시 만족해야 합니다.
  * 조회대상을 **department**로 조회하는 경우, **departmentFull**은 **필수**입니다.
  * 조회대상을 **member**로 조회하는 경우, **email**과 **name**을 반드시 포함해야 합니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>departmentType</td><td>string</td><td><strong>조회대상</strong><br>department : 그룹 , member : 사용자</td></tr><tr><td>departmentFull<mark style="color:blue;">*</mark></td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>email<mark style="color:blue;">*</mark></td><td>string</td><td><strong>사용자 메일</strong></td></tr><tr><td>name<mark style="color:blue;">*</mark></td><td>string</td><td><strong>사용자 이름</strong> </td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, OS 계정, 컴퓨터 이름<strong>,</strong> 이메일,</p><p>online : 온라인 , offline : 오프라인, offline_7days : 7일 이상 오프라인</p><p>기본값 : 빈값</p></td></tr><tr><td>sortField</td><td>string</td><td><strong>정렬을 원하는 컬럼명</strong><br>user_name : 이름, department_name : 그룹, product_os_user: OS 계정, computer_name: 컴퓨터 이름, time_install: 설치 시각, time_access: 마지막 통신 시각, product_os_type: OS 종류</td></tr><tr><td>sortType</td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</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><p><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 참고</p><p>기본값 : UTC</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr><tr><td>total</td><td>int</td><td><strong>전체 레코드 수</strong></td></tr><tr><td>offset</td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong> 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize</td><td>int</td><td><strong>페이지 사이즈</strong></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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>OS 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osDescription</td><td>string</td><td><strong>OS 버전</strong></td></tr><tr><td>osUserName</td><td>string</td><td><strong>OS 계정</strong></td></tr><tr><td>computerIP</td><td>string</td><td><strong>컴퓨터 IP</strong></td></tr><tr><td>macAddressList</td><td>string</td><td><strong>컴퓨터 MAC 주소</strong></td></tr><tr><td>agentVersion</td><td>string</td><td><strong>프로그램 버전</strong></td></tr><tr><td>installTimeUTC</td><td>string</td><td><strong>설치 시각( PC 기준 )</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>installTime</td><td>string</td><td><strong>설치 시각( 사용자 기준 )</strong><br>요청 타임존 기준,  ISO 8601포맷</td></tr><tr><td>dateOfAccessUTC</td><td>string</td><td><strong>마지막 통신 시각( PC 기준 )</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>dateOfAccess</td><td>string</td><td><strong>마지막 통신 시각( 사용자 기준 )</strong><br>요청 타임존 기준,  ISO 8601포맷</td></tr><tr><td>unAuth</td><td>string</td><td><strong>오프라인 여부</strong></td></tr><tr><td>isOnline</td><td>string</td><td><strong>온라인 여부</strong></td></tr><tr><td>isDeleted</td><td>string</td><td><strong>삭제 여부</strong></td></tr><tr><td>latestVersion</td><td>string</td><td><strong>에이전트 버전</strong></td></tr><tr><td>latestVersionLabel</td><td>string</td><td><strong>버전 종류</strong><br>standard : 정식, temp_patch : 커스텀</td></tr><tr><td>versionStatus</td><td>string</td><td><strong>업데이트 상태</strong><br>latest : 최신, outdated : 이전, unknown : 버전 없음·비교 불가, fetch_failed : 조회 실패</td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v3/agent/install?offset=0&tableSize=1000&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 1,
    "offset": 0,
    "tableSize": 1000,
    "data": [
      {
        "name": "test",
        "email": "test@exosp.com",
        "departmentFull": "어벤져스 > 제품",
        "departmentName": "제품",
        "computerName": "DESKTOP-GSEV8JK",
        "osType": "windows",
        "osDescription": "Windows 10 Pro 64bit",
        "osUserName": "sunghun",
        "computerIP": "192.168.0.11",
        "macAddressList": "00:11:22:33:44:55, AA:BB:CC:DD:EE:FF",
        "agentVersion": "3.2.1.0",
        "installTimeUTC": "2024-02-15T02:26:20+00:00",
        "installTime": "2024-02-15T11:26:20+09:00",
        "dateOfAccessUTC": "2024-02-15T02:26:20+00:00",
        "dateOfAccess": "2024-02-15T11:26:20+09:00",
        "unAuth": "N",
        "isOnline": "Y",
        "latestVersion": "3.2.2.0",
        "latestVersionLabel": "standard",
        "versionStatus": "latest"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


# 에이전트 미설치 사용자 현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v1/agent/distribute`

에이전트 미설치 사용자 현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 이메일</p><p>기본값 : 빈값</p></td></tr><tr><td>sortField</td><td>string</td><td><strong>정렬을 원하는 컬럼명</strong><br>Name: 이름 , DepartmentName: 그룹 , Email: 이메일</td></tr><tr><td>sortType</td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr><tr><td>total</td><td>int</td><td><strong>전체 레코드 수</strong></td></tr><tr><td>offset</td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong> 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize</td><td>int</td><td><strong>페이지 사이즈</strong></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>state</td><td>string</td><td><strong>설치 현황</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/agent/distribute?offset=0&tableSize=1000' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "data": [
      {
        "name": "test",
        "email": "test@exosp.com",
        "departmentFullName": "test",
        "state": "N",
        "stateMobile": "N"
      },
      {
        "name": "test1",
        "email": "test1@gmail.com",
        "departmentFullName": "test > test1",
        "state": "N",
        "stateMobile": "N"
      }
    ],
    "total": 2,
    "offset": 0,
    "tableSize": 1000
  }
}
```

{% endtab %}
{% endtabs %}


# 에이전트 삭제

<mark style="background-color:green;">PU</mark><mark style="background-color:green;">T</mark> `https://openapi.exosp.com/status/v1/agent/delete`

에이전트를 삭제하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>target<mark style="color:red;">*</mark></td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr></tbody></table>

#### 삭제 대상 상세

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>name<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 이름</strong> </td></tr><tr><td>email<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 메일</strong></td></tr><tr><td>macAddressList<mark style="color:red;">*</mark></td><td>string</td><td><strong>컴퓨터 MAC 주소</strong></td></tr><tr><td>osType<mark style="color:red;">*</mark></td><td>string</td><td><strong>OS 유형</strong></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>deleted_count</td><td>int</td><td>삭제된 에이전트 수</td></tr><tr><td>deleted_data</td><td>array</td><td><a data-mention href="#undefined-1">#undefined-1</a></td></tr></tbody></table>

#### 삭제된 데이터 상세

<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>macAddress</td><td>string</td><td><strong>컴퓨터 MAC 주소</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>OS 유형</strong></td></tr></tbody></table>

### Example

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

```javascript
curl -X 'PUT' \
  'https://openapi.exosp.com/status/v1/agent/delete' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' \
  -d '{
  "target": [
    {
      "name": "test",
      "email": "test@exosp.com",
      "macAddressList": "98:01:a7:a0:0f:95, 82:13:1a:08:7d:00, 82:13:1a:08:7d:01",
      "osType": "macOS"
    }
  ]
}' 

{
  "code": 0,
  "message": "success",
  "body": {
    "deleted_count": 1,
    "deleted_data": [
      {
        "name": "test",
        "email": "test@exosp.com",
        "macAddress": "|98:01:a7:a0:0f:95|82:13:1a:08:7d:00|82:13:1a:08:7d:01",
        "osType": "macOS"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}