SearchQuarantine
- 인쇄
- PDF
SearchQuarantine
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
격리된 웹쉘 의심 파일 중 원하는 항목을 검색합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| POST | /quarantines |
요청 헤더
Webshell Behavior Detector API에서 공통으로 사용하는 헤더에 대한 정보는 Webshell Behavior Detector 공통 헤더를 참조해 주십시오.
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
fileOriginName | String | Optional | 파일 이름 |
fileOwner | String | Optional | 파일 소유자 |
hostName | String | Optional | VM의 호스트 이름 |
memo | String | Optional | 메모 |
pageIndex | Integer | Required | 페이지 번호 |
pageSize | Integer | Required | 페이지 출력 개수 |
quarantineFileName | String | Optional | 격리 조치된 파일 이름 |
quarantineTimeFrom | Integer | Optional | 격리 시작 일시(Timestamp) |
quarantineTimeTo | Integer | Optional | 격리 종료 일시(Timestamp) |
serverName | String | Optional | VM의 서버 이름 |
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://wbd.apigw.ntruss.com/api/v1/quarantines' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'X-NCP-USE_PLATFORM_TYPE: VPC' \
--data '{
"fileOriginName": "",
"pageIndex": "0",
"pageSize": "2",
"serverName": "s18ee********"
}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
success | Boolean | - | 요청 처리 여부 |
code | Integer | - | 응답 코드 |
message | String | - | 응답 메시지 |
result | Array | - | 의심 파일 목록 |
result
result에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
suspicionFileId | String | - | 파일 ID |
detectionId | String | - | 웹쉘 행위 탐지 내역 ID |
hostName | String | - | VM의 호스트 이름 |
osType | String | - | VM의 OS 유형 |
fileOriginName | String | - | 파일 이름 |
quarantineFileName | String | - | 격리 조치된 파일 이름 |
fileSize | Integer | - | 파일 크기 |
sha1 | String | - | 파일의 sha1 해시 값 |
privateIPofServer | String | - | VM의 사설 IP |
fileAuthority | String | - | 파일의 권한 |
fileOwner | String | - | 파일 소유자 |
fileGroup | String | - | 파일 소유 그룹 |
accessTime | Integer | - | 파일 접근 일시(Timestamp) |
modifyTime | Integer | - | 파일 변경 일시(Timestamp) |
changeTime | Integer | - | 파일 수정 일시(Timestamp) |
instanceNo | String | - | VM의 인스턴스 번호 |
hashScanResult | String | - | Hash 기반의 악성 판단 결과
|
memo | String | - | 메모 |
memberNo | Integer | - | VM 사용 회원 번호 |
restoreTime | Integer | - | 파일 복구 일시(Timestamp) |
quarantineTime | Integer | - | 파일 격리 일시(Timestamp) |
weight | Integer | - | 스코어
|
commandStatus | String | - | 격리/복구 명령의 처리 상태
|
commandResult | String | - | 격리/복구 명령의 결과에 대한 상세 메시지 |
isRestore | Boolean | - | 복구 상태의 여부
|
isQuarantine | Boolean | - | 격리 여부
|
isExcepted | Boolean | - | 예외 처리 여부
|
lastUpdatedTime | Integer | - | 마지막 탐지 내역의 기록 일시(Timestamp) |
resultCode | Integer | - | 격리/복구 명령의 결과 코드 |
platform | String | - | VM 환경
|
serverName | String | - | VM의 서버 이름 |
containerName | String | - | VM의 컨테이너 이름 |
k8sName | String | - | 워크로드 이름
|
k8sType | String | - | 배포된 Pod의 워크로드 유형
|
podName | String | - | 배포된 Pod 이름
|
isDeleted | Boolean | - | 파일의 삭제 여부
|
응답 상태 코드
Webshell Behavior Detector API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Webshell Behavior Detector 공통 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"success": true,
"code": 0,
"message": "success",
"result": {
"content": [
{
"suspicionFileId": "2024072409172700000036",
"detectionId": "2024072409172700000036",
"hostName": null,
"osType": "WINDOWS",
"fileOriginName": "{web-root-path}/{suspicious-object-name}",
"quarantineFileName": "{web-root-path}/{quarantined-object-name}",
"fileSize": 98,
"sha1": "********************************",
"privateIPofServer": "***.***.***.***",
"fileAuthority": "[{\"BUILTIN/Administrators\":\"(I)(F)\"},{\"BUILTIN/IIS_IUSRS\":\"(I)(RX)\"},{\"BUILTIN/Users\":\"(I)(RX)\"},{\"NT AUTHORITY/SYSTEM\":\"(I)(F)\"},{\"NT SERVICE/TrustedInstaller\":\"(I)(F)\"}]",
"fileOwner": "S-1-5-32-544",
"fileGroup": "S-1-5-32-544",
"accessTime": 1721742837000,
"modifyTime": 1721742837000,
"changeTime": 1721742803000,
"instanceNo": "23****68",
"hashScanResult": "notMalware",
"memo": null,
"memberNo": 26***90,
"restoreTime": 1722999457076,
"quarantineTime": 1722999351039,
"weight": 29,
"commandStatus": "restored",
"commandResult": "OK",
"isRestore": true,
"isQuarantine": true,
"isExcepted": false,
"lastUpdatedTime": 1722999457125,
"resultCode": 0,
"platform": "VPC",
"serverName": "{servername}",
"containerName": null,
"k8sName": null,
"k8sType": null,
"podName": null,
"isDeleted": false
},
{
"suspicionFileId": "2024072323001500000229",
"detectionId": "2024072323001500000230",
"hostName": null,
"osType": "WINDOWS",
"fileOriginName": "{web-root-path}/{suspicious-object-name}",
"quarantineFileName": "{web-root-path}/{quarantined-object-name}",
"fileSize": 98,
"sha1": "********************************",
"privateIPofServer": "***.***.***.***",
"fileAuthority": "[{\"BUILTIN/Administrators\":\"(I)(F)\"},{\"BUILTIN/IIS_IUSRS\":\"(I)(RX)\"},{\"BUILTIN/Users\":\"(I)(RX)\"},{\"NT AUTHORITY/SYSTEM\":\"(I)(F)\"},{\"NT SERVICE/TrustedInstaller\":\"(I)(F)\"}]",
"fileOwner": "S-1-5-32-544",
"fileGroup": "S-1-5-32-544",
"accessTime": 1721742837000,
"modifyTime": 1721742837000,
"changeTime": 1721742803000,
"instanceNo": "23****68",
"hashScanResult": "notMalware",
"memo": null,
"memberNo": 26***90,
"restoreTime": 1721743312629,
"quarantineTime": 1721743240602,
"weight": 29,
"commandStatus": "restored",
"commandResult": "OK",
"isRestore": true,
"isQuarantine": true,
"isExcepted": false,
"lastUpdatedTime": 1721743312629,
"resultCode": 0,
"platform": "VPC",
"serverName": "{servername}",
"containerName": null,
"k8sName": null,
"k8sType": null,
"podName": null,
"isDeleted": false
}
],
"totalCount": 2,
"pageSize": 2,
"pageIndex": 0,
"totalPages": 1
}
}
이 문서가 도움이 되었습니까?