---
title: "Webshell Behavior Detectorの概要"
slug: "security-webshellbehaviordetector"
updated: 2026-09-17T09:58:26Z
published: 2026-09-17T09:58:26Z
canonical: "api.ncloud-docs.com/security-webshellbehaviordetector"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webshell Behavior Detectorの概要

VPC環境で利用できます。

Webshell Behavior Detectorは、ウェブシェルと疑われる行為を行動ベースでリアルタイムで検知し、迅速に対処できるよう通知を提供する NAVERクラウドプラットフォームのサービスです。Webshell Behavior Detectorサービスでは、Webshell、Excepted Webshell、Quarantine、Exception Rule、Deleted Exception Rule、Notification、Detection Setting機能に関する APIを RESTful形式で提供します。

## Webshell Behavior Detectorの共通設定

Webshell Behavior Detector APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://wbd.apigw.ntruss.com/api/v1/
```

#### リクエストヘッダ

ヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix timestamp形式 |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 |
| `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 |
| `Content-type` | Required | リクエストデータの形式`application/json` |
| `X-NCP-USE_PLATFORM_TYPE` | Required | 利用中のプラットフォーム環境 - `VPC` |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | 400 | Platform must be not null. | プラットフォームヘッダ漏れ |
| 200 | 8008 | Invalid file status.The status of file is quarantineFailed | 隔離失敗して無効なファイル |
| 200 | 8004 | Invaliddata.The detection data deleted is false, excepted is false. | 削除または例外失敗して無効なデータ |

参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

## Webshell Behavior Detector API

Webshell Behavior Detectorサービスで提供する APIの説明は次の通りです。

### Webshell

ウェブシェル行為検知履歴関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [GetWebshell](/docs/ja/security-webshellbehaviordetector-webshell-getwebshell) | ウェブシェル行為検知履歴を照会 |
| [UpdateWebshellMemo](/docs/ja/security-webshellbehaviordetector-webshell-updatewebshellmemo) | ウェブシェル行為検知履歴のメモを更新 |
| [DeleteWebshell](/docs/ja/security-webshellbehaviordetector-webshell-deletewebshell) | ウェブシェル行為検知履歴を削除 |
| [SearchWebshell](/docs/ja/security-webshellbehaviordetector-webshell-searchwebshell) | ウェブシェル行為検知履歴を検索 |
| [GetWebshellSuspiciousObject](/docs/ja/security-webshellbehaviordetector-webshell-getwebshellsuspiciousobject) | ウェブシェルと疑われるファイルを照会 |
| [QuarantineWebshellSuspiciousObject](/docs/ja/security-webshellbehaviordetector-webshell-quarantinewebshellsuspiciousobject) | ウェブシェルと疑われるファイルを隔離 |
| [RecoverWebshellSuspiciousObject](/docs/ja/security-webshellbehaviordetector-webshell-recoverwebshellsuspiciousobject) | 隔離されたウェブシェルと疑われるファイルを復旧 |
| [UpdateWebshellSuspiciousObjectMemo](/docs/ja/security-webshellbehaviordetector-webshell-updatewebshellsuspiciousobjectmemo) | ウェブシェルと疑われるファイルのメモを更新 |

### ExceptedWebshell

検知されたウェブシェル行為の例外処理関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [GetExceptedWebshell](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-getexceptedwebshell) | 例外処理されたウェブシェル行為の検知履歴を照会 |
| [RevokeExceptedWebshell](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-revokeexceptedwebshell) | 例外処理されたウェブシェル行為の検知履歴に対し例外をキャンセル |
| [UpdateExceptedWebshellMemo](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-updateexceptedwebshellmemo) | 例外処理されたウェブシェル行為検知履歴のメモを更新 |
| [SearchExceptedWebshell](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-searchexceptedwebshell) | 例外処理されたウェブシェル行為検知履歴を検索 |
| [GetExceptedWebshellSuspiciousObject](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-getexceptedwebshellsuspiciousobject) | 例外処理されたウェブシェル行為検知履歴の疑わしいファイルを照会 |
| [QuarantineExceptedWebshellSuspiciousObject](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-quarantineexceptedwebshellsuspiciousobject) | 例外処理されたウェブシェル行為検知履歴の疑わしいファイルを隔離 |
| [RecoverExceptedWebshellSuspiciousObject](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-recoverexceptedwebshellsuspiciousobject) | 例外処理されたウェブシェル行為検知履歴の疑わしいファイルを復旧 |
| [UpdateExceptedWebshellSuspiciousObjectMemo](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-updateexceptedwebshellsuspiciousobjectmemo) | 例外処理されたウェブシェル行為検知履歴の疑わしいファイルメモを更新 |

### Quarantine

検疫関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [GetQuarantine](/docs/ja/security-webshellbehaviordetector-quarantine-getquarantine) | 隔離されたウェブシェルと疑われるファイルを照会 |
| [RecoverQuarantine](/docs/ja/security-webshellbehaviordetector-quarantine-recoverquarantine) | 隔離されたウェブシェルと疑われるファイルを復旧 |
| [SearchQuarantine](/docs/ja/security-webshellbehaviordetector-quarantine-searchquarantine) | 隔離されたウェブシェルと疑われるファイルを検索 |
| [UpdateQuarantineMemo](/docs/ja/security-webshellbehaviordetector-quarantine-updatequarantinememo) | 隔離されたウェブシェルと疑われるファイルメモを更新 |

### ExceptionRule

例外ルール関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [GetExceptionRule](/docs/ja/security-webshellbehaviordetector-exceptionrule-getexceptionrule) | 例外ルールを照会 |
| [SearchExceptionRule](/docs/ja/security-webshellbehaviordetector-exceptionrule-searchexceptionrule) | 例外ルールを検索 |
| [UpdateExceptionRuleMemo](/docs/ja/security-webshellbehaviordetector-exceptionrule-updateexceptionrulememo) | 例外ルールメモを更新 |
| [DeleteExceptionRule](/docs/ja/security-webshellbehaviordetector-exceptionrule-deleteexceptionrule) | 例外ルールを削除 |

### DeletedExceptionRule

削除された例外ルール関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [GetDeletedExceptionRule](/docs/ja/security-webshellbehaviordetector-deletedexceptionrule-getdeletedexceptionrule) | 削除された例外ルールを照会 |
| [SearchDeletedExceptionRule](/docs/ja/security-webshellbehaviordetector-deletedexceptionrule-searchdeletedexceptionrule) | 削除された例外ルールを検索 |
| [UpdateDeletedExceptionRuleMemo](/docs/ja/security-webshellbehaviordetector-deletedexceptionrule-updatedeletedexceptionrulememo) | 削除された例外ルールメモを更新 |
| [RecoverDeletedExceptionRule](/docs/ja/security-webshellbehaviordetector-deletedexceptionrule-recoverdeletedexceptionrule) | 削除された例外ルールを復旧 |

### Notification

通知設定関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [GetNotificationInterval](/docs/ja/security-webshellbehaviordetector-notification-getnotificationinterval) | 設定された通知間隔を照会 |
| [UpdateNotificationInterval](/docs/ja/security-webshellbehaviordetector-notification-updatenotificationinterval) | 通知間隔を設定 |

### Detection Setting

検知設定関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [GetDetectionTarget](/docs/ja/security-webshellbehaviordetector-detectionsetting-getdetectiontarget) | 検知対象を照会 |
| [SearchDetectionTarget](/docs/ja/security-webshellbehaviordetector-detectionsetting-searchdetectiontarget) | 検知対象を検索 |
| [ActivateAgent](/docs/ja/security-webshellbehaviordetector-detectionsetting-activateagent) | サーバにインストールされたエージェントを有効化 |
| [DeactivateAgent](/docs/ja/security-webshellbehaviordetector-detectionsetting-deactivateagent) | サーバにインストールされたエージェントを無効化 |
| [UpdateDetectionTargetMemo](/docs/ja/security-webshellbehaviordetector-detectionsetting-updatedetectiontargetmemo) | 検知対象メモを更新 |

## Webshell Behavior Detector関連リソース

Webshell Behavior Detector APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- Webshell Behavior Detector APIの使用方法
  - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi#1-%EC%9D%B8%EC%A6%9D%ED%82%A4-%EC%83%9D%EC%84%B1): リクエストヘッダに追加する署名の作成方法
  - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Webshell Behavior Detectorサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
  - [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに追加する API Keyを発行
  - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法
- Webshell Behavior Detectorサービスの使用方法
  - [Webshell Behavior Detectorご利用ガイド](https://guide.ncloud-docs.com/docs/ja/wbd-wbdoverview): NAVERクラウドプラットフォームコンソールで Webshell Behavior Detectorを使用する方法
  - [Ncloud使用環境ガイド](/docs/ja/environment-environment-1-1): VPC、Classic環境とサポートの有無に関するご利用ガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/security/webshellBehaviorDetector): Webshell Behavior Detectorの料金体系、Webshell Behavior Detectorの特徴と詳細機能のサマリー
  - [サービス関連の最新のお知らせ](https://www.ncloud.com/intro/news): Webshell Behavior Detector関連の最新共有ニュース
  - [よくある質問](https://www.ncloud.com/support/faq/all?searchKeyword=webshell%20behavior%20detector&page=1): Webshell Behavior Detectorユーザーからのよくある質問
  - [お問い合わせ](https://www.ncloud.com/support/question): ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ