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
}
}
この記事は役に立ちましたか?