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

GET https://openapi.exosp.com/status/v1/cf/user

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

Query Parameters

항목	타입	설명
email*	string	사용자 메일
name*	string	사용자 이름
currentPage*	int	((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*	int	페이지 사이즈
sortField	string	개인(민감)정보의 보유량이 많은 파일의 정렬을 원하는 컬럼명 DetectionTotalCount : 개인(민감)정보 개수, DetectionTime : 탐지 시각
sortType	string	응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순
search	string	검색어 검색 대상 : 컴퓨터이름, 파일이름 기본값 : 빈값
cfRsSortField	string	개인(민감)정보 파일의 보유량이 많은 PC의 정렬을 원하는 컬럼명 FileCount : 탐지된 파일 수, CFCount : 개인(민감)정보 개수, MaxDetectionTime : 최근 탐지 시각
cfRsSortType	string	응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순
timezone	string	응답 데이터 타임존https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 에서 TZ identifier 참고 기본값 : UTC

Response Schema

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

body 상세

항목	타입	설명
fileCount	int	개인(민감)정보 파일 수
cfCount	int	개인(민감)정보 수
log_cf_status_info	array	개인(민감)정보 보유 현황
log_cf_rs_info	int	PC별 개인(민감)정보 보유 현황

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

항목	타입	설명
user	string	사용자(PC)
detectType	string	구분 Real-Time Scan : 실시간 탐지 Administrator Scheduled Scan : 관리자 예약검사 User Full Scan : 사용자 전체검사 User Custom Scan : 사용자 지정검사
inspectionType	string	검사 유형 Quick Scan : 빠른 검사 Full Scan : 일반 검사
fileName	string	파일 이름
detectCount	string	개인(민감)정보 수
name	string	사용자 이름
departmentFull	string	그룹 전체 경로
computerName	string	컴퓨터 이름
osType	string	OS 유형 windows : 윈도우 , macos : 맥
osUserName	string	OS 계정
detectResult	string	개인 민감 정보 상세
filePath	string	파일 경로
fileSize	string	파일 크기
protectionType	string	보호 유형 No Protection : 보호 처리 없음 Encryption : 암호화
encryptionResult	string	암호화 결과 No Protection : 보호 처리 없음 Encryption : 암호화
detectionTime	string	탐지 시각(사용자 기준) 요청 타임존 기준, ISO 8601포맷
detectionTimeUTC	string	탐지 시각(PC 기준) UTC 기준, ISO 8601포맷

개인 민감 정보 상세

항목	타입	설명
type	string	개인(민감)정보 구분 Type : 개인(민감)정보 유형 Keyword : 개인(민감)정보 키워드
name	string	개인(민감)정보 유형 / 키워드
count	int	탐지건수

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

항목	타입	설명
name	string	사용자 이름
departmentFull	string	그룹 전체 경로
fileCount	int	개인(민감)정보 파일 수
cfCount	int	개인(민감)정보 수
computerName	string	컴퓨터 이름
osType	string	OS 유형 windows : 윈도우 , macos : 맥
osUserName	string	OS 계정
maxDetectionTime	string	탐지 시각(사용자 기준) 요청 타임존 기준, ISO 8601포맷
maxDetectionTimeUTC	string	탐지 시각(PC 기준) UTC 기준, ISO 8601포맷

Example

200 Success

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