엑소스피어 OpenAPI 가이드
  • 👋Welcome!
  • 시작하기
    • API 키
    • API 요청 및 응답 모델
  • API 가이드
    • 로그
      • 안티 바이러스 > 바이러스 조치내역
      • 안티 바이러스 > 예약/수동 검사이력
      • 랜섬웨어 방지 > 보호파일 변조 차단 내역
      • 랜섬웨어 방지 > 실행 차단 내역
      • 웹보호 > 악성사이트 접속 제어 내역
      • 개인(민감)정보 보호 > 탐지 및 조치 내역
      • 개인(민감)정보 보호 > 예약/수동 검사 이력
      • 매체 제어 > 디바이스 연결 차단 내역
      • 매체 제어 > 파일 반출 제어 내역
      • 애플리케이션 제어 > 애플리케이션 실행 차단 내역
      • 애플리케이션 제어 > 파일 반출 제어 내역
      • 애플리케이션 제어 > 클라우드 파일 동기화 제어 내역
      • 화면 캡처 제어 내역
      • 출력물 제어 내역
      • 웹 접속 관리 내역
    • 현황
      • IP 사용현황
      • 하드웨어 현황
      • 애플리케이션 별 설치현황
      • 사용자 별 애플리케이션 설치현황
      • PC 보안 점검 현황
Powered by GitBook
On this page
  • Query Parameters
  • Response Schema
  • Example
  1. API 가이드
  2. 로그

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

GET https://openapi.exosp.com/logs/v1/sensitive-information/full-scan

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

Query Parameters

항목
타입
설명

offset*

int

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

tableSize*

int

페이지 사이즈

startTimeUTC*

string

응답 데이터 시작 시각

endTimeUTC*

string

응답 데이터 종료 시각 UTC 기준, ISO 8601포맷

sortType*

string

응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순

timezone

string

기본값 : UTC

search

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 계정

computerName

string

컴퓨터 이름

detectionType

string

탐지 유형 Admin Scheduled Scan : 관리자 예약 검사,

User Full Scan : 사용자 전체 검사,

User Custom Scan : 사용자 지정 검사

inspectionType

string

검사 유형 Quick : 빠른 검사, Full : 일반 검사

scanResult

string

검사 결과 Success : 성공,

Fail(실패 사유) : 실패,

Stop : 중단,

In Progress : 진행 중

------------------------------------------------- 실패 사유 Another Scan Is In Progress : 진행 중인 검사 존재, Agent Termination : 에이전트 종료,

Agent Update : 에이전트 업데이트,

Agent Abnormal Termination : 에이전트 비정상 종료

totalFileCount

string

총 검사 대상

scanFileCount

string

검사 진행된 파일 수

detectedFileCount

string

탐지 수

detectedSensitiveInfoCount

string

개인(민감)정보 수

protectionType

string

보호 유형 Encryption : 암호화, No Protection : 보호 처리 없음

protectionTargetFileCount

string

총 보호 대상 파일 수

protectedFileCount

string

보호된 파일 수

startDateOfEntryUTC

string

검사 시작 시각

UTC 기준, ISO 8601포맷

startDateOfEntry

string

검사 시작 시각

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

endDateOfEntryUTC

string

검사 종료 시각

UTC 기준, ISO 8601포맷

endDateOfEntry

string

검사 종료 시각

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

Example

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

Previous개인(민감)정보 보호 > 탐지 및 조치 내역Next매체 제어 > 디바이스 연결 차단 내역

Last updated 4 months ago

UTC 기준, ISO 8601포맷 최신 3개월 이내의 시각만 입력해주세요.

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

https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
body 상세
data 상세
✅