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

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

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

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

Query Parameters

항목	타입	설명
offset*	int	((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*	int	페이지 사이즈
startTimeUTC*	string	응답 데이터 시작 시각 UTC 기준, ISO 8601포맷 ✅ 최신 3개월 이내의 시각만 입력해주세요.
endTimeUTC*	string	응답 데이터 종료 시각 UTC 기준, ISO 8601포맷
sortType*	string	응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순
timezone	string	응답 데이터 타임존https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 에서 TZ identifier 참고 기본값 : UTC
search	string	검색어 검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름 기본값 : 빈값

Response Schema

항목	타입	설명
code	int	응답 처리 결과 코드 0 : 성공, 1 : 실패
message	string	응답 처리 결과 메세지 success : 성공, 그 외 : 실패
body	object	body 상세

body 상세

항목	타입	설명
total	int	전체 레코드 수
data	array	data 상세

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

200 Success

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