getInputFileLogByParentHash
- 인쇄
- PDF
getInputFileLogByParentHash
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
- getInputFileLogByParentHash API 는 "File Safer"의 "File Filter"에서 제공하는 기능으로 inputFile API를 이용 하여 분석 요청된 압축 파일의 해시 값을 이용하여 압축 파일 내의 파일에 대한 분석 결과를 확인하는 API입니다.
- 해당 API는 네이버 클라우드 플랫폼[공공기관용]에서 사용하는 IAM인증 및 API Gateway를 통해 사용하실 수 있습니다.
요청
| Method | Request URI |
|---|---|
| GET | https://filesafer.apigw.gov-ntruss.com/filefilter/v1/getInputFileLogByParentHash |
요청 헤더
| 헤더명 | 설명 |
|---|---|
| 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 사용 |
| accept | json을 명시 합니다.application/json |
요청 파라미터
| 파라미터명 | 필수 여부 | 타입 | 설명 |
|---|---|---|---|
| parentHash | Yes | string | 조회 하려는 Hash를 추출한 알고리즘 구분 값으로 sha1 지원sha1 |
| fromDate | No | string | 조회 시작 일시 timestamp |
| toDate | No | string | 조회 종료 일시timestamp |
응답
응답 바디
| 필드명 | 필수 여부 | 타입 | 설명 |
|---|---|---|---|
| returnCode | Yes | string | 요청에 대한 처리 결과 코드 |
| returnMessage | Yes | string | 요청에 대한 처리 결과 메시지 |
| inputFileLogList | Yes | string | 분석 결과 리스트 이며, 동일한 Hash의 파일이 2회 이상 분석 되었을 경우 리스트로 표기됨 |
| fileType | No | string | 분석된 파일이 있을 경우에만 포함됨분석된 파일의 포맷 표기 |
| fileSize | No | int | 분석된 파일이 있을 경우에만 포함됨분석된 파일의 크기 |
| parentSha1 | No | string | 분석된 파일이 있을 경우에만 포함됨압축 파일 자체의 SHA1 Hash 값 |
| 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/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": [
]
}
이 문서가 도움이 되었습니까?