すべてのプロダクト
Search
ドキュメントセンター

Web Application Firewall:CreateDefenseRule

最終更新日:Sep 09, 2026

Web コア保護ルールを作成します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-waf:CreateDefenseRule

create

*すべてのリソース。

*

  • acs:ResourceGroupId
なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

InstanceId

string

必須

WAF インスタンスのインスタンス ID。

説明

DescribeInstance 操作を呼び出して、現在の WAF インスタンスのインスタンス ID をクエリできます。

waf_v2_public_cn-****

TemplateId

integer

任意

作成する保護ルールの保護テンプレートの ID。

説明

このパラメーターは、DefenseType が template に設定されている場合にのみ必須です。 同じ保護テンプレート内に作成できるルール数には上限があります。具体的な制限については、ルールの数量制限 を参照してください。ルール数が上限に達した場合、 CreateDefenseTemplate 操作を呼び出して新しい保護テンプレートを作成できます。また、 ModifyDefenseRule 操作を呼び出して既存のルールを変更することもできます。

1122

DefenseScene

string

必須

作成する WAF 保護シナリオ。

保護ルールタイプ DefenseType が template (テンプレート) に設定されている場合の有効な値:

  • waf_group (グループ): 基本保護。

  • waf_base: 新バージョンの Web コア保護。

  • antiscan: スキャン保護。

  • ip_blacklist: IP ブラックリスト。

  • custom_acl: カスタムルール。

  • whitelist: ホワイトリスト。

  • region_block: 地域ブラックリスト。

  • custom_response: レガシーカスタム応答。

  • cc: HTTP フラッド保護。

  • tamperproof: Web 改ざん防止。

  • dlp: 情報漏洩防止。

  • spike_throttle: ピークトラフィックの速度制限。

  • bot_manager: ボット管理。

保護ルールタイプ DefenseType が resource (リソース) に設定されている場合の有効な値:

  • account_identifier: アカウント抽出。

  • custom_response: 新バージョンのカスタム応答。

  • waf_codec: デコード。

  • websdk: WebSDK 統合。

保護ルールタイプ DefenseType が global (グローバル) に設定されている場合の有効な値:

  • regular_custom: カスタム正規表現。

  • address_book: アドレス帳。

  • custom_response: 新バージョンのカスタム応答。

説明

グローバル構成のカスタム応答は、保護対象またはルールレベルで参照できます。カスタム応答ルールが異なるディメンションで参照される場合、実際の有効なロジックは次のとおりです: ルールレベル > 保護対象レベル > デフォルトページ。

グループ

Rules

string

必須

ルール構成内容。パラメーターの JSON 形式の配列から変換された文字列です。

説明

具体的なパラメーターは、指定された 保護ルールタイプ (DefenseScene) によって異なります。詳細については、保護ルールのパラメーター説明 を参照してください。

グループ

ResourceManagerResourceGroupId

string

任意

ドライランモードを有効にするかどうかを指定します。このパラメーターを指定しない場合、通常のリクエストが送信されます。有効な値:

  • true: ドライランリクエストが送信されます。システムは、指定された操作を実行せずに、リクエストが実行条件を満たしているかどうかのみをチェックします。ドライランが失敗した場合、対応するエラーコードが返されます。ドライランが成功した場合、エラーコード Defense.Control.DryRunOperation が返されます。

  • false: 通常のリクエストが送信されます。リクエストがチェックに合格した後、指定された操作が実行されます。

false

DefenseType

string

任意

Alibaba Cloud リソースグループの ID。

列挙値:

  • template :

    (デフォルト) テンプレート保護ルール。

  • resource :

    保護対象レベルのルール。

  • global :

    グローバルレベルのルール。

rg-acfm***q

RegionId

string

任意

保護ルールのタイプ。

列挙値:

  • template :

    (デフォルト) テンプレートベースの保護ルール。

  • resource :

    保護対象レベルのルール。

  • global :

    グローバルレベルのルール。

テンプレート

Resource

string

任意

WAF インスタンスが存在するリージョン。有効な値:

  • cn-hangzhou: 中国本土。

  • ap-southeast-1: 中国本土以外。

cn-hangzhou

任意

作成するルールに関連付けられた保護対象。

説明

このパラメーターは、DefenseType が resource (リソース) に設定されている場合にのみ必須です。

sec****-waf

保護ルールのパラメーター説明

ルールの数量制限

同じ保護テンプレート内では、基本保護シナリオ (DefenseScene) 用に作成できるルール数に上限があります。以下のシナリオには固定の制限があります。他のシナリオの制限は、WAF インスタンスのエディションによって異なります。詳細については、エディション間の機能比較 を参照してください。

保護シナリオDefenseSceneルール数量制限説明
基本 Web 保護waf_group3基本保護ルールグループタイプ (protectionType) ごとに 1 つのルール。
新バージョンの Web コア保護waf_base1
スキャン保護antiscan3スキャン保護サブタイプ (protectionType) ごとに 1 つのルール: 高頻度スキャンブロック、ディレクトリトラバーサルブロック、スキャンツールブロック。
地域ブラックリストregion_block1
レガシーカスタム応答custom_response1この制限は、DefenseType が template に設定されている場合のレガシーカスタム応答に適用されます。新バージョンのカスタム応答については、エディション間の機能比較 を参照してください。
HTTP フラッド保護cc1
ボット管理bot_manager—シナリオベースのルールにおける各ルールタグ (botRuleDetail.ruleKey) ごとに 1 つのルール。
デコードwaf_codec1
アカウント抽出account_identifier1
WebSDK 統合websdk1
説明

保護ルールタイプ DefenseType が template に設定されており、対象テンプレート内の対象シナリオのルール数が上限に達している場合、作成は失敗します。この場合、 CreateDefenseTemplate 操作を呼び出して新しい保護テンプレートを作成できます。また、 ModifyDefenseRule 操作を呼び出して既存のルールを変更することもできます。

テンプレートベースの保護ルール (template)

保護ルールタイプ DefenseType が template に設定されている場合、具体的なルール構成内容は次のとおりです。

基本保護ルールグループ (waf_group)

パラメーターの説明

名前タイプ必須例説明
statusIntegerはい1基本保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値:
- 0: 無効。
- 1 (デフォルト): 有効。




actionStringはいblock基本保護ルールのアクション。有効な値:
- block: ブロック。
- monitor: 監視。




policyIdLongいいえ1012基本保護ルールグループの ID。デフォルト値: 1012 (中ルールグループ)。
protectionTypeStringいいえsema基本保護ルールのタイプ。有効な値:
- regular (デフォルト): 正規表現ベースの保護。
- sema: セマンティックベースの保護。




configStringいいえ{"nonInjectionSql":1}JSON 文字列形式のカスタム構成。詳細については、config の詳細構成を参照してください。

config の詳細構成

  • protectionType が sema に設定されている場合 (セマンティックベースの保護として構成された基本 Web 保護ルール)

名前タイプ必須例説明
nonInjectionSqlIntegerはい1非インジェクション攻撃検出のステータス。有効な値:
- 0: 無効。
- 1 (デフォルト): 有効。




例

{
    "DefenseScene": "waf_group",
    "TemplateId": 322,
    "InstaneId": "waf_cn****",
    "Rules": "[{\"status\":1,\"policyId\":1012,\"action\":\"block\"},{\"status\":1,\"action\":\"block\",\"protectionType\":\"sema\",\"config\":\"{\\\"nonInjectionSql\\\":1}\"}]"
}

新バージョンの Web コア保護ルール (waf_base)

パラメーターの説明

名前タイプ必須例説明
autoUpdateBooleanはいtrue自動更新を有効にするかどうかを指定します。有効な値:
- true: 自動更新を有効にします。
- false: 自動更新を無効にします。




configArrayはい[{"ruleType":"system","ruleDetail":[{"ruleId":13000412,"ruleStatus":1,"ruleAction":"block"}]}]変更するルール構成。詳細については、config の詳細構成を参照してください。
重要 DescribeBaseSystemRules 操作を呼び出してこのテンプレートのシステム保護ルール構成をクエリし、DescribeDefenseRules 操作を呼び出してこのテンプレートのカスタム正規表現ルール構成をクエリできます。

config の詳細構成

名前タイプ必須例説明
ruleTypeStringはいsystemルールタイプ。有効な値:
- system: 基本保護のシステムルール。
- custom: 基本保護のカスタム正規表現ルール。




ruleBatchOperationConfigStringいいえdefaultバッチルール変更操作。このフィールドが空でない場合、RuleDetail フィールドは空である必要があります。有効な値:
- default: デフォルトに復元。
- all_on: すべてのルールを有効化。
- all_off: すべてのルールを無効化。
- all_block: すべてのルールアクションをブロックに設定。
- all_monitor: すべてのルールアクションを監視に設定。













ruleDetailArrayいいえ[{"ruleId":13000412,"ruleStatus":1,"ruleAction":"block"}]]変更するルール構成。フィールド:
- ruleId: ルール ID。
- ruleStatus: ルールステータス。
- ruleAction: ルールアクション。







例

{
    "DefenseScene": "waf_base",
    "TemplateId": 322,
    "InstaneId": "waf_cn****",
    "Rules": "[{\"autoUpdate\":true,\"config\":[{\"ruleType\":\"system\",\"ruleDetail\":[{\"ruleId\":13000412,\"ruleStatus\":1,\"ruleAction\":\"block\"}]}]}]"
}

スキャン保護ルール (antiscan)

パラメーターの説明

名前タイプ必須例説明
protectionTypeStringはいhighfreqスキャン保護ルールのサブタイプ。有効な値:
- highfreq: 高頻度スキャンブロック。
- dirscan: ディレクトリトラバーサルブロック。
- scantools: スキャンツールブロック。







statusIntegerはい1保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値:
- 0: 無効。
- 1 (デフォルト): 有効。




actionStringはいblock保護ルールのアクション。有効な値:
- block: ブロック。
- monitor: 監視。




actionExternalJSONいいえ{"responseRuleId":123444}保護ルールアクションの拡張構成。新バージョンのカスタム応答のみがこの構成をサポートします。action が block に設定されている場合、カスタムブロックページを指定できます。
configStringいいえ{"target":"remote_addr","interval":60,"ttl":180,"count":20}JSON 文字列形式のカスタム構成。詳細については、config の詳細構成 を参照してください。

config の詳細構成

  • protectionType が highfreq に設定されている場合 (高頻度スキャンブロックとして構成されたスキャン保護ルール)

名前タイプ必須例説明
targetStringはいremote_addr統計のオブジェクトタイプ。有効な値:
- remote_addr (デフォルト): IP アドレス。
- cookie.acw_tc: セッション。
- header: カスタムヘッダー。カスタムヘッダーを選択する場合、subkey パラメーターでカウントするヘッダー内容を指定する必要があります。
- queryarg: クエリ引数。クエリ引数を選択する場合、subkey パラメーターでカウントするカスタムパラメーター名を指定する必要があります。
- cookie: カスタム Cookie。カスタム Cookie を選択する場合、subkey パラメーターでカウントする Cookie 内容を指定する必要があります。













subKeyStringいいえabc統計対象のサブ機能。このパラメーターは、target パラメーターが cookie、header、または queryarg に設定されている場合に必須です。
intervalIntegerいいえ60検出期間 (秒単位)。デフォルト値: 60。
有効な値: 5 ~ 1800。

ttlIntegerいいえ1800ブロック期間 (秒単位)。デフォルト値: 1800。
有効な値: 60 ~ 86400。

countIntegerいいえ20基本保護ルールがトリガーされる最大回数。デフォルト値: 20。
有効な値: 3 ~ 50000。

ruleIdCountIntegerいいえ2トリガーされたルールの最大数。デフォルト値: 2。
有効な値: 1 ~ 50。

  • protectionType が dirscan に設定されている場合 (ディレクトリトラバーサルブロックとして構成されたスキャン保護ルール)

名前タイプ必須例説明
targetStringはいremote_addr統計およびブロックのオブジェクト。有効な値:
- remote_addr (デフォルト): IP アドレス。
- cookie.acw_tc: セッション。
- header: カスタムヘッダー。
- queryarg: クエリ引数。
- cookie: カスタム Cookie。













subKeyStringいいえ1統計およびブロック対象のサブ機能。このパラメーターは、target が header、queryarg、または cookie に設定されている場合にのみ構成します。
intervalIntegerいいえ60検出期間 (秒単位)。デフォルト値: 60。
有効な値: 5 ~ 1800。

ttlIntegerいいえ1800ブロック期間 (秒単位)。デフォルト値: 1800。
有効な値: 60 ~ 86400。

countIntegerいいえ20基本保護ルールがトリガーされる最大回数。デフォルト値: 20。
有効な値: 3 ~ 50000。

weightFloatいいえ2404 応答コードの割合。デフォルト値: 0.7。
有効な値: 0.01 ~ 1.0、小数点以下 2 桁まで正確。

uriNumIntegerいいえ2存在しないディレクトリの最大数。デフォルト値: 50。
有効な値: 2 ~ 50000。

例

{
    "InstanceId": "waf_v2_public_****",
    "TemplateId": 2222,
    "DefenseScene": "antiscan",
    "Rules": "[{\"protectionType\":\"scantools\",\"action\":\"block\",\"status\":1},{\"protectionType\":\"dirscan\",\"status\":1,\"action\":\"block\",\"config\":\"{\\\"target\\\":\\\"remote_addr\\\",\\\"interval\\\":10,\\\"ttl\\\":1800,\\\"weight\\\":0.7,\\\"uriNum\\\":50,\\\"count\\\":50}\"},{\"protectionType\":\"highfreq\",\"status\":1,\"action\":\"block\",\"config\":\"{\\\"target\\\":\\\"remote_addr\\\",\\\"interval\\\":60,\\\"ttl\\\":1800,\\\"count\\\":20,\\\"ruleIdCount\\\":2}\"}]"
}

IP ブラックリストルール (ip_blacklist)

パラメーターの説明

名前タイプ必須例説明
nameStringはいiptestIP ブラックリストルールの名前。名前は 1 ~ 255 文字で、漢字、英字、数字、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。
statusIntegerはい1保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値:
- 0: 無効。
- 1 (デフォルト): 有効。




actionStringはいblock保護ルールのアクション。有効な値:
- block: ブロック。
- monitor: 監視。




actionExternalJSONいいえ{"responseRuleId":123444}保護ルールアクションの拡張構成。新バージョンのカスタム応答のみがこの構成をサポートします。action が block に設定されている場合、カスタムブロックページを指定できます。
remoteAddrArrayはい["1.1.XX.XX", "3.1.XX.XX/24"]ブラックリストに追加する IP アドレスのリスト。形式は ["ip1","ip2",...] です。

例

{
    "InstanceId": "waf_v2_public_****",
    "TemplateId": 2222,
    "DefenseScene": "ip_blacklist",
    "Rules": "[{\"name\":\"iptest1\",\"remoteAddr\":[\"1.1.1.2\",\"3.3.3.3/24\"],\"action\":\"monitor\",\"status\":1},{\"name\":\"iptest2\",\"remoteAddr\":[\"4.4.4.4\",\"5.5.5.5/32\"],\"action\":\"block\",\"status\":1}]"
}

カスタムルール (custom_acl)

パラメーターの説明

名前タイプ必須例説明
nameStringはいiptestカスタム ACL ルールの名前。名前は 1 ~ 255 文字で、漢字、英字、数字、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。
statusIntegerはい1保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値:
- 0: 無効。
- 1 (デフォルト): 有効。




actionStringはいblock保護ルールのアクション。有効な値:
- block: ブロック。
- monitor: 監視。
- js: JavaScript チャレンジ。
- captcha: スライダー CAPTCHA。
- captcha_strict: 厳格なスライダー CAPTCHA。
注意 カスタム ACL ルールでサポートされる保護ルールアクションは、WAF コンソール に表示されるカスタムルールアクションに準じます。
















actionExternalJSONいいえ{"responseRuleId":123444}保護ルールアクションの拡張構成。新バージョンのカスタム応答のみがこの構成をサポートします。action が block に設定されている場合、カスタムブロックページを指定できます。action が captcha または captcha_strict に設定されている場合、カスタムスライダー CAPTCHA ページを指定できます。
conditionsArrayはい[{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}]ACL ルールのトラフィック特性。JSON 文字列形式で記述されます。最大 5 つの一致条件がサポートされています。詳細については、保護ルールのパラメーター設定 の conditions 構成の説明を参照してください。
ccStatusIntegerはい1速度制限を有効にするかどうかを指定します。有効な値:
- 0: 速度制限を無効にします。
- 1: 速度制限を有効にします。




ratelimitJSONいいえ{"target":"remote_addr","interval":5,"threshold":2,"ttl":1800,"status":{"code":404,"count":2}}詳細な速度制限構成。JSON 文字列形式で記述されます。このパラメーターは、ccStatus が 1 に設定されている場合にのみ構成します。詳細については、保護ルールのパラメーター設定 の ratelimit の詳細構成を参照してください。
effectStringいいえrule速度制限のスコープ。このパラメーターは、ccStatus が 1 に設定されている場合にのみ構成します。有効な値:
- service: 速度制限は保護対象に有効になります。
- rule: 速度制限は単一のルールに有効になります。




grayStatusIntegerいいえ1ルールのカナリアリリースを有効にするかどうかを指定します。有効な値:
- 0 (デフォルト): カナリアリリースを無効にします。
- 1: カナリアリリースを有効にします。




grayConfigJSONいいえ{"grayTarget":"header","grayRate":80,"graySubKey":"test"}ルールのカナリアリリース環境構成。JSON 文字列形式で記述されます。このパラメーターは、grayStatus が 1 に設定されている場合にのみ構成します。詳細については、保護ルールのパラメーター設定 の grayConfig の詳細構成を参照してください。
timeConfigJSONいいえ{"timeScope":"period","timeZone":8,"timePeriods":[{"start":1758771729787,"end":1758816000000}]}ルールのスケジュール構成。JSON 文字列形式で記述されます。詳細については、保護ルールのパラメーター設定 の timeConfig の詳細構成を参照してください。

例

{
    "InstanceId": "waf_v2_public_****",
    "TemplateId": 6242,
    "DefenseScene": "custom_acl",
    "Rules":"[{\"name\":\"acl_test\",\"action\":\"block\",\"conditions\":[{\"key\":\"URL\",\"opValue\":\"contain\",\"values\":\"abc\"}],\"ratelimit\":{\"target\":\"remote_addr\",\"interval\":5,\"threshold\":2,\"ttl\":1800,\"status\":{\"code\":404,\"count\":2}},\"ccStatus\":1,\"effect\":\"rule\",\"status\":1,\"origin\":\"custom\",\"timeConfig\":{\"timeScope\":\"cycle\",\"timeZone\":8,\"weekTimePeriods\":[{\"day\":\"1\",\"dayPeriods\":[{\"start\":0,\"end\":51644084}]},{\"day\":\"1,2,5\",\"dayPeriods\":[{\"start\":0,\"end\":42928908}]}]},\"grayStatus\":1,\"grayConfig\":{\"grayRate\":80,\"graySubKey\":\"test\",\"grayTarget\":\"header\"}}]"
}

ホワイトリストルール (whitelist)

パラメーターの説明

名前タイプ必須例説明
nameStringはいwhitelistTestホワイトリストルールの名前。名前は 1 ~ 255 文字で、漢字、英字、数字、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。
statusIntegerはい1保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値:
- 0: 無効。
- 1 (デフォルト): 有効。




conditionsArrayはい[{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}]ホワイトリストのトラフィック特性。JSON 文字列形式で記述されます。最大 5 つの一致条件がサポートされています。詳細については、保護ルールのパラメーター設定 の conditions 構成の説明を参照してください。
tagsArrayはい["waf", "regular"]ホワイトリストが適用されるモジュールのリスト。形式は ["XX1", "XX2",...] です。有効な値:
- waf: すべてのモジュール。
- customrule_rule: 特定のカスタムルール。
- customrule: カスタムルール。
- blacklist: IP ブラックリスト。
- blacklist_rule: 特定の IP ブラックリストルール。
- antiscan: スキャン保護。
- regular: 基本保護ルール。
- regular_rule: 特定の基本保護正規表現ルール。
- regular_type: 特定の基本保護正規表現ルールタイプ。
- regular_field: 特定の基本保護フィールド。
- major_protection: 大規模イベント保護。
- cc: HTTP フラッド保護。
- region_block: 地域ブラックリスト。
- antibot_scene: ボットシナリオ保護。
- antibot_scene_rule: 特定のボットシナリオ保護ルール ID。
- antibot_scene_label: 特定のボットシナリオ保護ルールタイプ。
- dlp: 情報漏洩防止。
- tamperproof: Web 改ざん防止。
- spike_throttle: ピークトラフィックの速度制限保護。























































regularRulesArrayいいえ[ "111111", "222222" ]スキップする正規表現ルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定の基本保護正規表現ルールに設定されている場合 (tags パラメーターが regular_rule に設定されている場合) にのみ構成します。
regularTypesArrayいいえ[ "xss", "css" ]スキップする正規表現ルールタイプのリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが Web アプリケーション正規表現タイプに設定されている場合 (tags パラメーターが regular_type に設定されている場合) にのみ構成します。有効な値:
- sqli: SQL インジェクション。
- xss: クロスサイトスクリプティング。
- code_exec: コード実行。
- crlf: CRLF。
- lfilei: ローカルファイルインクルージョン。
- rfilei: リモートファイルインクルージョン。
- webshell: WebShell。
- csrf: CSRF。
- other: その他。

























regularFieldsArrayいいえ[{"key":"URL"},{"key":"Header","subKey":"abc"}]スキップする基本保護フィールドのリスト。JSON 文字列形式で記述されます。最大 5 つの一致条件がサポートされています。詳細については、regularFields の詳細構成 を参照してください。このパラメーターは、ホワイトリストモジュールが特定の基本保護フィールドに設定されている場合 (tags パラメーターが regular_field に設定されている場合) にのみ構成します。
customRulesArrayいいえ[ "111111", "222222" ]スキップするカスタムルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定のカスタムルールに設定されている場合 (tags パラメーターが customrule_rule に設定されている場合) にのみ構成します。
blacklistRulesArrayいいえ[ "111111", "222222" ]スキップする IP ブラックリストルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定の IP ブラックリストルールに設定されている場合 (tags パラメーターが blacklist_rule に設定されている場合) にのみ構成します。
botRulesArrayいいえ[ "111111", "222222" ]スキップするボットシナリオ保護ルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定のボットシナリオ保護ルール ID に設定されている場合 (tags パラメーターが antibot_scene_rule に設定されている場合) にのみ構成します。
botLablesArrayいいえ[ "abc", "cdcc" ]スキップするボットシナリオ保護ルールタイプのリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定のボットシナリオ保護ルールタイプに設定されている場合 (tags パラメーターが antibot_scene_label に設定されている場合) にのみ構成します。 DescribeBotRuleLabels 操作を呼び出して、ボットルールタイプ情報をクエリできます。

regularFields の詳細構成

名前タイプ必須例説明
keyStringはいURLスキップするフィールド。有効な値:
- URL-All: すべての URI 関連フィールド。
- URL: 指定された URI フィールド。
- URLPath: URI パス。
- Query-All: すべての Query 関連フィールド。
- Query-Arg: 指定された Query パラメーター。
- Cookie-All: すべての Cookie 関連フィールド。
- Cookie-Exact: 指定された Cookie 名。
- Header-All: すべての Header 関連フィールド。
- Header: 指定された Header フィールド。
- Body-All: すべての Body パラメーター。




























subKeyStringいいえabc指定されたフィールド。スキップするフィールド (key) が URLPath、Query-Arg、Cookie-Exact、または Header に設定されている場合にこのパラメーターを構成します。

例

{
    "InstanceId": "waf_v2_public_****",
    "TemplateId": 9242,
    "DefenseScene": "whitelist",
    "Rules":"[{\"name\":\"whitelistTest\",\"tags\":[\"regular_rule\",\"customrule\"],\"status\":1,\"origin\":\"custom\",\"conditions\":[{\"key\":\"URL\",\"opValue\":\"contain\",\"values\":\"/test\"},{\"key\":\"Header\",\"opValue\":\"eq\",\"values\":\"ffff\",\"subKey\":\"abc\"}],\"regularRules\":[\"123444\",\"444444\"]}]"
}

カスタム応答ルール (custom_response)

パラメーターの説明

名前タイプ必須例説明
responseTypeString必須response_blockカスタムレスポンスのタイプ。値を response_block に設定します。これはブロックレスポンスを示します。
statusInteger必須1保護ルールのステータス。このパラメーターは、保護ルールの作成時にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値:
- 0: 無効。
- 1 (デフォルト): 有効。




configString必須{"responseCode":400,"responseHeaders":[{"key":"custom","value":"123"},{"key":"aaa","value":"2223"}],"responseContent":"HelloWorld"}JSON 文字列で記述されたカスタム設定情報。詳細については、「config の詳細設定」を参照してください。

config の詳細設定

名前タイプ必須例説明
responseCodeInteger必須400レスポンスコード。
responseHeadersArray任意[{"key":"custom","value":"123"},{"key":"aaaa","value":"2223"}]JSON 文字列で記述されたカスタムレスポンスヘッダーのリスト。key はヘッダーフィールドを指定し、value はヘッダー値を指定します。
responseContentString必須helloworldカスタムレスポンスのコンテンツ。

レスポンスフィールド

フィールド

型

説明

例

object

レスポンス構造体。

RequestId

string

リクエストの ID。

26E46541-7AAB-5565-801D-F14DBDC5****

RuleIds

string

作成された保護ルールの ID。複数の保護ルール ID はカンマ (,) で区切られます。

22215,23354,462165

例

成功レスポンス

JSONJSON

{
  "RequestId": "26E46541-7AAB-5565-801D-F14DBDC5****",
  "RuleIds": "22215,23354,462165"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 Defense.Control.DefenseWhitelistBypassRuleNotExist The whitelist protection rule does not exist. ホワイトリストで指定された保護ルールが存在しません。ルール ID: %s。
400 Defense.Control.DefenseWhitelistConfigInvalid The whitelist rule is misconfigured. ホワイトリストルールの構成が無効です: %s。
400 Defense.Control.DefenseBookTypeInvalid The address book type is illegal. アドレス帳のタイプが無効です。
400 Defense.Control.DefenseThreatIntelligenceConfigInvalid Threat Intelligence Rule configuration error. 脅威インテリジェンスルールの構成が無効です。%s。
400 Defense.Control.DefenseIpCountOversize The number of IPs exceeds the limit. IP アドレス数が上限を超えています。
400 Defense.Control.InvalidDefenseRuleConfig Invalid protection rule configuration. %s. 保護ルールの構成が無効です。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。