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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://openapi-docs.exosp.com/guide/status/vulnerability-check.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.