애플리케이션 제어 > 파일 반출 제어 내역

GET https://openapi.exosp.com/logs/v1/application-control/file-transfer-control

애플리케이션 제어 > 파일 반출 제어 내역을 조회하는 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	컴퓨터 이름
category	string	애플리케이션 카테고리 Others : 미분류, P2P : P2P, Messenger : 메신저, FTP Utility : FTP 유틸리티, Media Player : 동영상 플레이어, Email Clients : 메일 클라이언트, Cloud Storage : 클라우드 스토리지, Note Taking Apps : 클라우드 노트, Screen Capture : 화면캡처, Remote Control : 원격 제어, Web Browser : 웹 브라우저, Live Tiles : Live Tiles, AirDrop : 에어드랍
productName	string	제품 이름
processName	string	프로세스 이름
companyName	string	공급자
url	string	웹 사이트 주소
fileName	string	파일 이름
filePath	string	파일 경로
fileSize	string	파일 크기
fileType	string	파일 유형 General : 일반 파일, Sensitive : 개인(민감)정보 파일, Not Scanned : 개인(민감)정보 검사 안 함, Scan Failed : 개인(민감)정보 검사 실패 파일, Exosphere Encrypted File : 엑소스피어 암호화 파일
sensitiveInfoCount	string	개인(민감)정보 수
sensitiveInfoDetails	array	개인(민감)정보 세부 내역
controlType	string	제어 유형 Allow : 파일 반출 기록, Block : 파일 반출 차단
dateOfEntryUTC	string	제어 시각 UTC 기준, ISO 8601포맷
dateOfEntry	string	제어 시각 요청 타임존 기준, ISO 8601포맷

개인(민감)정보 세부 내역

항목	타입	설명
name	string	개인(민감)정보
count	int	레코드 수

Example

200 Success

curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/application-control/file-transfer-control?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": "어벤져스 > 제품 > CX > 이나영",
           "osType": "windows",
           "osUserName": "nayoung",
           "computerName": "DESKTOP-NAYOUNG",
           "category": "Web Browser",
           "productName": "Microsoft Edge",
           "processName": "msedge.exe",
           "companyName": "Microsoft Corporation",
           "url": "admin-kr.exosp.com",
           "fileName": "엑셀_양식(ARK).xlsx",
           "filePath": "C:\\Users\\nayoung\\Documents\\카카오톡 받은 파일\\엑셀_양식(ARK).xlsx",
           "fileSize": "13KB",
           "fileType": "Sensitive",
           "sensitiveInfoCount": "20",
           "sensitiveInfoDetails": [
               {
                   "name": "Email",
                   "count": 20
               }
           ],
           "controlType": "Block",
           "dateOfEntryUTC": "2024-12-09T02:28:18+00:00",
           "dateOfEntry": "2024-12-09T11:28:18+09:00"
      }
    ]
  }
}