GetExceptedWebshellSuspiciousObject
- 인쇄
- PDF
GetExceptedWebshellSuspiciousObject
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
예외 처리된 웹쉘 행위 탐지 내역 중 원하는 파일에 대한 상세 정보를 조회합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| GET | /exceptions/{exception-id}/suspicious-objects |
요청 헤더
Webshell Behavior Detector API에서 공통으로 사용하는 헤더에 대한 정보는 Webshell Behavior Detector 공통 헤더를 참조해 주십시오.
요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
exception-id | Integer | Required | 예외 처리된 웹쉘 행위 탐지 내역 ID
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request GET 'https://wbd.apigw.ntruss.com/api/v1/exceptions/2024072321234500000010/suspicious-objects' \
--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'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
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": [
{
"suspicionFileId": "2024072321234500000008",
"detectionId": "2024072321234500000010",
"hostName": "{hostname}",
"osType": "LINUX",
"fileOriginName": "{web-root-path}/{suspicious-object-name}",
"quarantineFileName": "{web-root-path}/{quarantined-object-name}",
"fileSize": 222,
"sha1": "********************************",
"privateIPofServer": "***.***.***.***",
"fileAuthority": "rw-r--r--",
"fileOwner": "root",
"fileGroup": "root",
"accessTime": 1721737308457,
"modifyTime": 1721362317000,
"changeTime": 1721737326361,
"instanceNo": "25****17",
"hashScanResult": "notMalware",
"memo": null,
"memberNo": 26***90,
"restoreTime": 1721737448315,
"quarantineTime": 1721737443431,
"weight": 29,
"commandStatus": "restored",
"commandResult": "OK",
"isRestore": true,
"isQuarantine": true,
"isExcepted": false,
"lastUpdatedTime": 1721737448341,
"resultCode": 0,
"platform": "VPC",
"serverName": "{servername}",
"containerName": "{containername}",
"k8sName": "my-pod-jsp",
"k8sType": "Pod",
"podName": "my-pod-jsp",
"isDeleted": false
}
]
}
이 문서가 도움이 되었습니까?