getInputFileLog (File Filter)

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

개요

getInputFileLog API는 "File Safer" 의 "File Filter"에서 제공하는 기능으로 inputFile API를 이용 하여 분석 요청된 파일의 분석 결과를 확인하는 API 입니다.
해당 API는 네이버 클라우드 플랫폼[공공기관용]에서 사용하는 IAM인증 및 API Gateway를 통해 사용하실 수 있습니다.

요청

메서드	Request URI
GET	`https://filesafer.apigw.gov-ntruss.com/filefilter/v1/getInputFileLog`

요청 헤더

헤더 명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(millisecond)로 나타낸 것 APIGW 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-api-key	API Gateway에서 발급받은 키
x-ncp-iam-access-key	NCP에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
x-ncp-apigw-signature-v2	Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명 HMAC 암호화 알고리즘은 HmacSHA256 사용
accept	json을 명시함 `application/json`

요청 파라미터

파라미터 명	필수여부	타입	설명
hash	Yes	string	조회 하려는 Hash 값
hashType	Yes	string	조회 하려는 Hash를 추출한 알고리즘 구분 값으로 md5, sha1을 지원함 `sha1` or `md5`

응답

응답 바디

필드 명	필수 여부	타입	설명
returnCode	Yes	string	요청에 대한 처리 결과 코드
returnMessage	Yes	string	요청에 대한 처리 결과 메시지
inputFileLogList	Yes	string	분석 결과 리스트 이며, 동일한 Hash의 파일이 2회 이상 분석 되었을 경우 리스트로 표기됨
fileType	No	string	`분석된 파일이 있을 경우에만 포함됩니다` 분석된 파일의 포맷 표기
fileSize	No	int	`분석된 파일이 있을 경우에만 포함됩니다` 분석된 파일의 크기
md5	No	string	`분석된 파일이 있을 경우에만 포함됩니다` 분석된 파일의 MD5 Hash 값
sha1	No	string	`분석된 파일이 있을 경우에만 포함됩니다` 분석된 파일의 SHA1 Hash 값
sha256	No	string	`분석된 파일이 있을 경우에만 포함됩니다` 분석된 파일의 SHA256 Hash 값
analysisStatusCode	No	string	`분석된 파일이 있을 경우에만 포함됩니다` 분석 상태 코드이며 아래의 값을 가짐 [ Code : Desc : Status ] IPRG : Analyzing : 분석 중 CMPL : Analysis completed : 분석 완료 ERR : Analysis error : 에러 EXCN : Exclude analysis : 예외
analysisResultCode	No	string	`분석된 파일이 있을 경우에만 포함됩니다` 분석 결과 코드이며 아래의 값을 가짐 [ Code : Desc : Status ] M : Malware detected : 악성 코드 (Hash Filter에 업데이트됨) N : Malware not detected : 정상 파일 E : Detection error : 에러
notifyYmdt	No	long	`분석된 파일이 있을 경우에만 포함됩니다` 알림을 설정했을 경우 알림이 발송된 시간
registrationYmdt	No	long	`분석된 파일이 있을 경우에만 포함됩니다` 파일이 인입된 시간
serviceCode	No	string or null	`분석된 파일이 있을 경우에만 포함됩니다` 특정 분석 요청의 경우에만 표기되며 대부분 null 값이 표기됨
applicationCode	No	string or null	`분석된 파일이 있을 경우에만 포함됩니다` 특정 분석 요청의 경우에만 표기되며 대부분 null 값이 표기됨

예시

요청 예시

curl -X GET "https://filesafer.apigw.gov-ntruss.com/filefilter/v1/getInputFileLog?hash=f093e7767bb63ac973b697d3fd1d40a78b87b8bf&hashType=sha1"
   -H "accept: application/json" 
   -H "x-ncp-apigw-api-key: {x-ncp-apigw-api-key}" 
   -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}" 
   -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}" 
   -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"

응답 예시

// 분석된 파일이 있는 경우
{
  "returnCode": "0",
  "returnMessage": "success",
  "inputFileLogList": [
    {
      "fileType": "application/x-msdownload; format=pe32",
      "fileSize": 740544,
      "md5": "a69acb01b99959efec7c0a2a8caa7545",
      "sha1": "f093e7767bb63ac973b697d3fd1d40a78b87b8bf",
      "sha256": "470a75fe3da2ddf9d27fb3f9c96e6c665506ea7ba26ab89f0c89606f678ae4a2",
      "analysisStatusCode": "CMPL",
      "analysisResultCode": "M",
      "notifyYmdt": 1544005507000,
      "registrationYmdt": 1544005472000,
      "serviceCode": null,
      "applicationCode": null
    },
    {
      "fileType": "application/x-msdownload; format=pe32",
      "fileSize": 740544,
      "md5": "a69acb01b99959efec7c0a2a8caa7545",
      "sha1": "f093e7767bb63ac973b697d3fd1d40a78b87b8bf",
      "sha256": "470a75fe3da2ddf9d27fb3f9c96e6c665506ea7ba26ab89f0c89606f678ae4a2",
      "analysisStatusCode": "CMPL",
      "analysisResultCode": "M",
      "notifyYmdt": 1544006407000,
      "registrationYmdt": 1544006150000,
      "serviceCode": null,
      "applicationCode": null
    },
  ]
}

// 분석된 파일이 없는 경우
{
  "returnCode": "0",
  "returnMessage": "success",
  "inputFileLogList": [
  ]
}

이 문서가 도움이 되었습니까?

What's Next

getInputFileLogByParentHash

개요
요청
응답
예시

태그

File Safer