PC 보안 점검 현황

PC 보안 점검 현황 조회

GET https://openapi.exosp.com/status/v1/vulnerability-check

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

Query Parameters

항목

타입

설명

offset*

int

((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.

tableSize*

int

페이지 사이즈

timezone

string

응답 데이터 타임존 에서 TZ identifier 참고

기본값 : UTC

string

검색어

검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름

기본값 : 빈값

Response Schema

항목

타입

설명

code

int

응답 처리 결과 코드

0 : 성공, 1 : 실패

message

string

응답 처리 결과 메세지

success : 성공, 그 외 : 실패

body

object

body 상세

항목

타입

설명

total

int

전체 레코드 수

data

array

data 상세

항목

타입

설명

name

string

사용자 이름

departmentName

string

그룹 이름

departmentFull

string

그룹 전체 경로

osType

string

os 유형 windows : 윈도우 , macos : 맥

osUserName

string

os 계정

summary

object

result

object

computerName

string

컴퓨터 이름

dateOfEntryUTC

string

수집 시각

UTC 기준, ISO 8601포맷

dateOfEntry

string

수집 시각

요청 타임존 기준, ISO 8601포맷

summary 상세

항목

타입

설명

secure

int

안전

weak

int

취약

fail

int

점검 실패

uncheckable

int

점검 불가

unScanned

int

점검 안함

windows 결과 상세

항목

데이터

상세

타입

설명

updateOperatingSystem

object

운영체제 업데이트

status

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

array

상세

osVersion

string

업데이트 가능한 OS 버전

enableAntivirus

object

백신 프로그램 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함,

Uncheckable : 점검 불가

detail

array

상세

productName

string

제품 이름

realTimeProtection

string

실시간 보호 사용 여부 Using : 사용 중, Not Using : 사용 안함

updateStatus

string

업데이트 상세 The Latest Version : 최신 버전,

Update Required : 업데이트 필요

enableFirewall

object

방화벽 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

array

상세

productName

string

제품 이름

realTimeProtection

string

실시간 보호 사용 여부 Using : 사용 중, Not Using : 사용 안함

updateStatus

string

업데이트 상세 The Latest Version : 최신 버전,

Update Required : 업데이트 필요

useSecurePassword

object

안전한 비밀번호 사용 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

array

상세

impossibleReason

string

점검 불가 사유

changePasswordPeriodically

object

주기적인 비밀번호 변경 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

object

상세

lastChangeDate

string

마지막 패스워드 변경일

enableScreenSaver

object

화면 보호기 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

object

상세

screenSaver

string

화면 보호기 사용 여부 Using : 사용 중, Not Using : 사용 안함

logonScreenOnRestart

string

다시 시작할 때 로그온 표시 Using : 사용 중, Not Using : 사용 안함

waitTime

string

대기시간(분)

disableSharedFolder

object

공유폴더 점검

status

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

array

상세

folder

string

공유 폴더

disableUSBAutoPlay

object

USB 자동 실행 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

null

updateSoftware

object

소프트웨어 업데이트 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

array

상세

productName

string

제품 이름

updateStatus

string

업데이트 상태 The Latest Version : 최신 버전, Update Required : 업데이트 필요

macos 결과 상세

항목

데이터

상세

타입

설명

updateOperatingSystem

object

운영체제 업데이트 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

array

상세

osVersion

string

업데이트 가능한 OS 버전

enableSystemIntegrityProtection

object

시스템 무결성 보호 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

null

blockUnverifiedAppleApps

object

Apple미검증 앱 실행차단 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

null

enableFirewall

object

방화벽 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

null

useSecurePassword

object

안전한 비밀번호 사용 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

null

changePasswordPeriodcally

object

주기적인 비밀번호 변경

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

object

상세

lastChangeDate

string

마지막 패스워드 변경일

enableScreenSaver

object

화면 보호기 점검

status

string

상태 Secure : 안전,

Weak : 취약,

Fail : 점검 실패,

Un Scanned : 점검 안함, Uncheckable : 점검 불가

detail

object

상세

screenSaver

string

화면 보호기 시작

requirePasswordOnRestart

string

다시 시작할 때 비밀번호 요구

Example

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"
        }
    ]
  }
}

Previous사용자 별 애플리케이션 현황

Last updated 1 month ago