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

웹보호 > 악성사이트 접속 제어 내역 조회

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

애플리케이션 제어 > 파일 반출 제어 내역을 조회하는 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

컴퓨터 이름

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 : 개인(민감)정보 검사 실패 파일

sensitiveInfoCount

string

개인(민감)정보 수

sensitiveInfoDetails

array

controlType

string

제어 유형 Allow : 파일 반출 기록, Block : 파일 반출 차단

dateOfEntryUTC

string

제어 시각

UTC 기준, ISO 8601포맷

dateOfEntry

string

제어 시각

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

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

항목
타입
설명

name

string

개인(민감)정보

count

int

레코드 수

Example

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

Last updated