getInputFileLogByParentHash
    • PDF

    getInputFileLogByParentHash

    • PDF

    기사 요약

    개요

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

    요청

    MethodRequest URI
    GEThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/getInputFileLogByParentHash

    요청 헤더

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

    요청 파라미터

    파라미터명필수 여부타입설명
    parentHashYesstring조회 하려는 Hash를 추출한 알고리즘 구분 값으로 sha1 지원
    sha1
    fromDateNostring조회 시작 일시
    timestamp
    toDateNostring조회 종료 일시
    timestamp

    응답

    응답 바디

    필드명필수 여부타입설명
    returnCodeYesstring요청에 대한 처리 결과 코드
    returnMessageYesstring요청에 대한 처리 결과 메시지
    inputFileLogListYesstring분석 결과 리스트 이며, 동일한 Hash의 파일이 2회 이상 분석 되었을 경우 리스트로 표기됨
    fileTypeNostring분석된 파일이 있을 경우에만 포함됨
    분석된 파일의 포맷 표기
    fileSizeNoint분석된 파일이 있을 경우에만 포함됨
    분석된 파일의 크기
    parentSha1Nostring분석된 파일이 있을 경우에만 포함됨
    압축 파일 자체의 SHA1 Hash 값
    md5Nostring분석된 파일이 있을 경우에만 포함됨
    압축 파일 내 분석된 파일의 MD5 Hash 값
    sha1Nostring분석된 파일이 있을 경우에만 포함됨
    압축 파일 내 분석된 파일의 SHA1 Hash 값
    sha256Nostring분석된 파일이 있을 경우에만 포함됨
    압축 파일 내 분석된 파일의 SHA256 Hash 값
    analysisStatusCodeNostring분석된 파일이 있을 경우에만 포함됨
    분석 상태 코드이며 아래의 값을 가짐

    [ Code : Desc : Status ]
    IPRG : Analyzing : 분석 중
    CMPL : Analysis completed : 분석 완료
    ERR : Analysis error : 오류
    EXCN : Exclude analysis : 예외
    analysisResultCodeNostring분석된 파일이 있을 경우에만 포함됨
    분석 결과 코드이며 아래의 값을 가짐

    [ Code : Desc : Status ]
    M : Malware detected : 악성 코드 (Hash Filter에 업데이트)
    N : Malware not detected : 정상 파일
    E : Detection error : 오류
    notifyYmdtNolong분석된 파일이 있을 경우에만 포함됨
    알림을 설정했을 경우 알림이 발송된 시간
    registrationYmdtNolong분석된 파일이 있을 경우에만 포함됨
    파일이 인입된 시간
    serviceCodeNostring or null분석된 파일이 있을 경우에만 포함됨
    특정 분석 요청의 경우에만 표기되며 대부분 null 값이 표기됨
    applicationCodeNostring or null분석된 파일이 있을 경우에만 포함됨
    특정 분석 요청의 경우에만 표기되며 대부분 null 값이 표기됨

    예시

    요청 예시

    curl -X GET "https://filesafer.apigw.gov-ntruss.com/filefilter/v1/getInputFileLogByParentHash?ParentHash=f093e7767bb63ac973b697d3fd1d40a78b87b8bf"
       -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": "Adobe Portable Document Format",
          "fileSize": 68584,
          "parentSha1": "4fa122a164fab49701d440dc376a108b2ab71bc4",
          "md5": "83861ed7105eb8b9886616f9f0428b62",
          "sha1": "ea445bec4e8f79c5a2f8db5a368f2c3c741e238f",
          "sha256": "ff8ca1b607ab03268078d9bde33980e16ca45aa3c798e2b963ca89efd87714cc",
          "analysisStatusCode": "CMPL",
          "analysisResultCode": "N",
          "notifyYmdt": null,
          "registrationYmdt": 1697766000000,
          "serviceCode": null,
          "applicationCode": null
        },
        {
          "fileType": "Adobe Portable Document Format",
          "fileSize": 56686,
          "parentSha1": "4fa122a164fab49701d440dc376a108b2ab71bc4",
          "md5": "e162e32656ff4b4666d14bc43f9238c1",
          "sha1": "d4021b08bcaa08255afd1b80bf9c39ab46116447",
          "sha256": "40aa534c3cd62f4d7585a9bbf06a4af23b771d8b39127f16b2ec2503bffcd4aa",
          "analysisStatusCode": "CMPL",
          "analysisResultCode": "N",
          "notifyYmdt": null,
          "registrationYmdt": 1697766000000,
          "serviceCode": null,
          "applicationCode": null
        }
      ]
    }
    

    응답 예시 (분석된 파일이 없는 경우)

    {
      "returnCode": "0",
      "returnMessage": "success",
      "inputFileLogList": [
      ]
    }
    

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

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.