getInputFileLog (File Filter)

개요

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

요청

Method Request URI
GET https://filesafer.apigw.ntruss.com/filefilter/v1/getInputFileLog

요청 헤더

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

IAM 인증이 필요한 API 호출하기를 참조 합니다.
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.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": [
  ]
}

연관 오퍼레이션