Web コア保護ルールを作成します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
yundun-waf:CreateDefenseRule |
create |
*すべてのリソース。
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| InstanceId |
string |
必須 |
WAF インスタンスのインスタンス ID。 説明
DescribeInstance 操作を呼び出して、現在の WAF インスタンスのインスタンス ID をクエリできます。 |
waf_v2_public_cn-**** |
| TemplateId |
integer |
任意 |
作成する保護ルールの保護テンプレートの ID。 説明
このパラメーターは、DefenseType が template に設定されている場合にのみ必須です。 同じ保護テンプレート内に作成できるルール数には上限があります。具体的な制限については、ルールの数量制限 を参照してください。ルール数が上限に達した場合、 CreateDefenseTemplate 操作を呼び出して新しい保護テンプレートを作成できます。また、 ModifyDefenseRule 操作を呼び出して既存のルールを変更することもできます。 |
1122 |
| DefenseScene |
string |
必須 |
作成する WAF 保護シナリオ。 保護ルールタイプ DefenseType が template (テンプレート) に設定されている場合の有効な値:
保護ルールタイプ DefenseType が resource (リソース) に設定されている場合の有効な値:
保護ルールタイプ DefenseType が global (グローバル) に設定されている場合の有効な値:
説明
グローバル構成のカスタム応答は、保護対象またはルールレベルで参照できます。カスタム応答ルールが異なるディメンションで参照される場合、実際の有効なロジックは次のとおりです: ルールレベル > 保護対象レベル > デフォルトページ。 |
グループ |
| Rules |
string |
必須 |
ルール構成内容。パラメーターの JSON 形式の配列から変換された文字列です。 説明
具体的なパラメーターは、指定された 保護ルールタイプ (DefenseScene) によって異なります。詳細については、保護ルールのパラメーター説明 を参照してください。 |
グループ |
| ResourceManagerResourceGroupId |
string |
任意 |
ドライランモードを有効にするかどうかを指定します。このパラメーターを指定しない場合、通常のリクエストが送信されます。有効な値:
|
false |
| DefenseType |
string |
任意 |
Alibaba Cloud リソースグループの ID。 列挙値:
|
rg-acfm***q |
| RegionId |
string |
任意 |
保護ルールのタイプ。 列挙値:
|
テンプレート |
| Resource |
string |
任意 |
WAF インスタンスが存在するリージョン。有効な値:
|
cn-hangzhou |
|
任意 |
作成するルールに関連付けられた保護対象。 説明
このパラメーターは、DefenseType が resource (リソース) に設定されている場合にのみ必須です。 |
sec****-waf |
保護ルールのパラメーター説明
ルールの数量制限
同じ保護テンプレート内では、基本保護シナリオ (DefenseScene) 用に作成できるルール数に上限があります。以下のシナリオには固定の制限があります。他のシナリオの制限は、WAF インスタンスのエディションによって異なります。詳細については、エディション間の機能比較 を参照してください。
| 保護シナリオ | DefenseScene | ルール数量制限 | 説明 |
| 基本 Web 保護 | waf_group | 3 | 基本保護ルールグループタイプ (protectionType) ごとに 1 つのルール。 |
| 新バージョンの Web コア保護 | waf_base | 1 | |
| スキャン保護 | antiscan | 3 | スキャン保護サブタイプ (protectionType) ごとに 1 つのルール: 高頻度スキャンブロック、ディレクトリトラバーサルブロック、スキャンツールブロック。 |
| 地域ブラックリスト | region_block | 1 | |
| レガシーカスタム応答 | custom_response | 1 | この制限は、DefenseType が template に設定されている場合のレガシーカスタム応答に適用されます。新バージョンのカスタム応答については、エディション間の機能比較 を参照してください。 |
| HTTP フラッド保護 | cc | 1 | |
| ボット管理 | bot_manager | — | シナリオベースのルールにおける各ルールタグ (botRuleDetail.ruleKey) ごとに 1 つのルール。 |
| デコード | waf_codec | 1 | |
| アカウント抽出 | account_identifier | 1 | |
| WebSDK 統合 | websdk | 1 |
保護ルールタイプ DefenseType が template に設定されており、対象テンプレート内の対象シナリオのルール数が上限に達している場合、作成は失敗します。この場合、 CreateDefenseTemplate 操作を呼び出して新しい保護テンプレートを作成できます。また、 ModifyDefenseRule 操作を呼び出して既存のルールを変更することもできます。
テンプレートベースの保護ルール (template)
保護ルールタイプ DefenseType が template に設定されている場合、具体的なルール構成内容は次のとおりです。
基本保護ルールグループ (waf_group)
パラメーターの説明
| 名前 | タイプ | 必須 | 例 | 説明 |
| status | Integer | はい | 1 | 基本保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値: - 0: 無効。 - 1 (デフォルト): 有効。 |
| action | String | はい | block | 基本保護ルールのアクション。有効な値: - block: ブロック。 - monitor: 監視。 |
| policyId | Long | いいえ | 1012 | 基本保護ルールグループの ID。デフォルト値: 1012 (中ルールグループ)。 |
| protectionType | String | いいえ | sema | 基本保護ルールのタイプ。有効な値: - regular (デフォルト): 正規表現ベースの保護。 - sema: セマンティックベースの保護。 |
| config | String | いいえ | {"nonInjectionSql":1} | JSON 文字列形式のカスタム構成。詳細については、config の詳細構成を参照してください。 |
config の詳細構成
protectionType が sema に設定されている場合 (セマンティックベースの保護として構成された基本 Web 保護ルール)
| 名前 | タイプ | 必須 | 例 | 説明 |
| nonInjectionSql | Integer | はい | 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)
パラメーターの説明
| 名前 | タイプ | 必須 | 例 | 説明 |
| autoUpdate | Boolean | はい | true | 自動更新を有効にするかどうかを指定します。有効な値: - true: 自動更新を有効にします。 - false: 自動更新を無効にします。 |
| config | Array | はい | [{"ruleType":"system","ruleDetail":[{"ruleId":13000412,"ruleStatus":1,"ruleAction":"block"}]}] | 変更するルール構成。詳細については、config の詳細構成を参照してください。 重要 DescribeBaseSystemRules 操作を呼び出してこのテンプレートのシステム保護ルール構成をクエリし、DescribeDefenseRules 操作を呼び出してこのテンプレートのカスタム正規表現ルール構成をクエリできます。 |
config の詳細構成
| 名前 | タイプ | 必須 | 例 | 説明 |
| ruleType | String | はい | system | ルールタイプ。有効な値: - system: 基本保護のシステムルール。 - custom: 基本保護のカスタム正規表現ルール。 |
| ruleBatchOperationConfig | String | いいえ | default | バッチルール変更操作。このフィールドが空でない場合、RuleDetail フィールドは空である必要があります。有効な値: - default: デフォルトに復元。 - all_on: すべてのルールを有効化。 - all_off: すべてのルールを無効化。 - all_block: すべてのルールアクションをブロックに設定。 - all_monitor: すべてのルールアクションを監視に設定。 |
| ruleDetail | Array | いいえ | [{"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)
パラメーターの説明
| 名前 | タイプ | 必須 | 例 | 説明 |
| protectionType | String | はい | highfreq | スキャン保護ルールのサブタイプ。有効な値: - highfreq: 高頻度スキャンブロック。 - dirscan: ディレクトリトラバーサルブロック。 - scantools: スキャンツールブロック。 |
| status | Integer | はい | 1 | 保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値: - 0: 無効。 - 1 (デフォルト): 有効。 |
| action | String | はい | block | 保護ルールのアクション。有効な値: - block: ブロック。 - monitor: 監視。 |
| actionExternal | JSON | いいえ | {"responseRuleId":123444} | 保護ルールアクションの拡張構成。新バージョンのカスタム応答のみがこの構成をサポートします。action が block に設定されている場合、カスタムブロックページを指定できます。 |
| config | String | いいえ | {"target":"remote_addr","interval":60,"ttl":180,"count":20} | JSON 文字列形式のカスタム構成。詳細については、config の詳細構成 を参照してください。 |
config の詳細構成
protectionType が highfreq に設定されている場合 (高頻度スキャンブロックとして構成されたスキャン保護ルール)
| 名前 | タイプ | 必須 | 例 | 説明 |
| target | String | はい | remote_addr | 統計のオブジェクトタイプ。有効な値: - remote_addr (デフォルト): IP アドレス。 - cookie.acw_tc: セッション。 - header: カスタムヘッダー。カスタムヘッダーを選択する場合、subkey パラメーターでカウントするヘッダー内容を指定する必要があります。 - queryarg: クエリ引数。クエリ引数を選択する場合、subkey パラメーターでカウントするカスタムパラメーター名を指定する必要があります。 - cookie: カスタム Cookie。カスタム Cookie を選択する場合、subkey パラメーターでカウントする Cookie 内容を指定する必要があります。 |
| subKey | String | いいえ | abc | 統計対象のサブ機能。このパラメーターは、target パラメーターが cookie、header、または queryarg に設定されている場合に必須です。 |
| interval | Integer | いいえ | 60 | 検出期間 (秒単位)。デフォルト値: 60。 有効な値: 5 ~ 1800。 |
| ttl | Integer | いいえ | 1800 | ブロック期間 (秒単位)。デフォルト値: 1800。 有効な値: 60 ~ 86400。 |
| count | Integer | いいえ | 20 | 基本保護ルールがトリガーされる最大回数。デフォルト値: 20。 有効な値: 3 ~ 50000。 |
| ruleIdCount | Integer | いいえ | 2 | トリガーされたルールの最大数。デフォルト値: 2。 有効な値: 1 ~ 50。 |
protectionType が dirscan に設定されている場合 (ディレクトリトラバーサルブロックとして構成されたスキャン保護ルール)
| 名前 | タイプ | 必須 | 例 | 説明 |
| target | String | はい | remote_addr | 統計およびブロックのオブジェクト。有効な値: - remote_addr (デフォルト): IP アドレス。 - cookie.acw_tc: セッション。 - header: カスタムヘッダー。 - queryarg: クエリ引数。 - cookie: カスタム Cookie。 |
| subKey | String | いいえ | 1 | 統計およびブロック対象のサブ機能。このパラメーターは、target が header、queryarg、または cookie に設定されている場合にのみ構成します。 |
| interval | Integer | いいえ | 60 | 検出期間 (秒単位)。デフォルト値: 60。 有効な値: 5 ~ 1800。 |
| ttl | Integer | いいえ | 1800 | ブロック期間 (秒単位)。デフォルト値: 1800。 有効な値: 60 ~ 86400。 |
| count | Integer | いいえ | 20 | 基本保護ルールがトリガーされる最大回数。デフォルト値: 20。 有効な値: 3 ~ 50000。 |
| weight | Float | いいえ | 2 | 404 応答コードの割合。デフォルト値: 0.7。 有効な値: 0.01 ~ 1.0、小数点以下 2 桁まで正確。 |
| uriNum | Integer | いいえ | 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)
パラメーターの説明
| 名前 | タイプ | 必須 | 例 | 説明 |
| name | String | はい | iptest | IP ブラックリストルールの名前。名前は 1 ~ 255 文字で、漢字、英字、数字、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。 |
| status | Integer | はい | 1 | 保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値: - 0: 無効。 - 1 (デフォルト): 有効。 |
| action | String | はい | block | 保護ルールのアクション。有効な値: - block: ブロック。 - monitor: 監視。 |
| actionExternal | JSON | いいえ | {"responseRuleId":123444} | 保護ルールアクションの拡張構成。新バージョンのカスタム応答のみがこの構成をサポートします。action が block に設定されている場合、カスタムブロックページを指定できます。 |
| remoteAddr | Array | はい | ["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)
パラメーターの説明
| 名前 | タイプ | 必須 | 例 | 説明 |
| name | String | はい | iptest | カスタム ACL ルールの名前。名前は 1 ~ 255 文字で、漢字、英字、数字、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。 |
| status | Integer | はい | 1 | 保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値: - 0: 無効。 - 1 (デフォルト): 有効。 |
| action | String | はい | block | 保護ルールのアクション。有効な値: - block: ブロック。 - monitor: 監視。 - js: JavaScript チャレンジ。 - captcha: スライダー CAPTCHA。 - captcha_strict: 厳格なスライダー CAPTCHA。 注意 カスタム ACL ルールでサポートされる保護ルールアクションは、WAF コンソール に表示されるカスタムルールアクションに準じます。 |
| actionExternal | JSON | いいえ | {"responseRuleId":123444} | 保護ルールアクションの拡張構成。新バージョンのカスタム応答のみがこの構成をサポートします。action が block に設定されている場合、カスタムブロックページを指定できます。action が captcha または captcha_strict に設定されている場合、カスタムスライダー CAPTCHA ページを指定できます。 |
| conditions | Array | はい | [{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}] | ACL ルールのトラフィック特性。JSON 文字列形式で記述されます。最大 5 つの一致条件がサポートされています。詳細については、保護ルールのパラメーター設定 の conditions 構成の説明を参照してください。 |
| ccStatus | Integer | はい | 1 | 速度制限を有効にするかどうかを指定します。有効な値: - 0: 速度制限を無効にします。 - 1: 速度制限を有効にします。 |
| ratelimit | JSON | いいえ | {"target":"remote_addr","interval":5,"threshold":2,"ttl":1800,"status":{"code":404,"count":2}} | 詳細な速度制限構成。JSON 文字列形式で記述されます。このパラメーターは、ccStatus が 1 に設定されている場合にのみ構成します。詳細については、保護ルールのパラメーター設定 の ratelimit の詳細構成を参照してください。 |
| effect | String | いいえ | rule | 速度制限のスコープ。このパラメーターは、ccStatus が 1 に設定されている場合にのみ構成します。有効な値: - service: 速度制限は保護対象に有効になります。 - rule: 速度制限は単一のルールに有効になります。 |
| grayStatus | Integer | いいえ | 1 | ルールのカナリアリリースを有効にするかどうかを指定します。有効な値: - 0 (デフォルト): カナリアリリースを無効にします。 - 1: カナリアリリースを有効にします。 |
| grayConfig | JSON | いいえ | {"grayTarget":"header","grayRate":80,"graySubKey":"test"} | ルールのカナリアリリース環境構成。JSON 文字列形式で記述されます。このパラメーターは、grayStatus が 1 に設定されている場合にのみ構成します。詳細については、保護ルールのパラメーター設定 の grayConfig の詳細構成を参照してください。 |
| timeConfig | JSON | いいえ | {"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)
パラメーターの説明
| 名前 | タイプ | 必須 | 例 | 説明 |
| name | String | はい | whitelistTest | ホワイトリストルールの名前。名前は 1 ~ 255 文字で、漢字、英字、数字、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。 |
| status | Integer | はい | 1 | 保護ルールのステータス。このパラメーターは、保護ルールの作成にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値: - 0: 無効。 - 1 (デフォルト): 有効。 |
| conditions | Array | はい | [{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}] | ホワイトリストのトラフィック特性。JSON 文字列形式で記述されます。最大 5 つの一致条件がサポートされています。詳細については、保護ルールのパラメーター設定 の conditions 構成の説明を参照してください。 |
| tags | Array | はい | ["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: ピークトラフィックの速度制限保護。 |
| regularRules | Array | いいえ | [ "111111", "222222" ] | スキップする正規表現ルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定の基本保護正規表現ルールに設定されている場合 (tags パラメーターが regular_rule に設定されている場合) にのみ構成します。 |
| regularTypes | Array | いいえ | [ "xss", "css" ] | スキップする正規表現ルールタイプのリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが Web アプリケーション正規表現タイプに設定されている場合 (tags パラメーターが regular_type に設定されている場合) にのみ構成します。有効な値: - sqli: SQL インジェクション。 - xss: クロスサイトスクリプティング。 - code_exec: コード実行。 - crlf: CRLF。 - lfilei: ローカルファイルインクルージョン。 - rfilei: リモートファイルインクルージョン。 - webshell: WebShell。 - csrf: CSRF。 - other: その他。 |
| regularFields | Array | いいえ | [{"key":"URL"},{"key":"Header","subKey":"abc"}] | スキップする基本保護フィールドのリスト。JSON 文字列形式で記述されます。最大 5 つの一致条件がサポートされています。詳細については、regularFields の詳細構成 を参照してください。このパラメーターは、ホワイトリストモジュールが特定の基本保護フィールドに設定されている場合 (tags パラメーターが regular_field に設定されている場合) にのみ構成します。 |
| customRules | Array | いいえ | [ "111111", "222222" ] | スキップするカスタムルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定のカスタムルールに設定されている場合 (tags パラメーターが customrule_rule に設定されている場合) にのみ構成します。 |
| blacklistRules | Array | いいえ | [ "111111", "222222" ] | スキップする IP ブラックリストルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定の IP ブラックリストルールに設定されている場合 (tags パラメーターが blacklist_rule に設定されている場合) にのみ構成します。 |
| botRules | Array | いいえ | [ "111111", "222222" ] | スキップするボットシナリオ保護ルール ID のリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定のボットシナリオ保護ルール ID に設定されている場合 (tags パラメーターが antibot_scene_rule に設定されている場合) にのみ構成します。 |
| botLables | Array | いいえ | [ "abc", "cdcc" ] | スキップするボットシナリオ保護ルールタイプのリスト。形式は ["XX1", "XX2",...] です。このパラメーターは、ホワイトリストモジュールが特定のボットシナリオ保護ルールタイプに設定されている場合 (tags パラメーターが antibot_scene_label に設定されている場合) にのみ構成します。 DescribeBotRuleLabels 操作を呼び出して、ボットルールタイプ情報をクエリできます。 |
regularFields の詳細構成
| 名前 | タイプ | 必須 | 例 | 説明 |
| key | String | はい | 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 パラメーター。 |
| subKey | String | いいえ | 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)
パラメーターの説明
| 名前 | タイプ | 必須 | 例 | 説明 |
| responseType | String | 必須 | response_block | カスタムレスポンスのタイプ。値を response_block に設定します。これはブロックレスポンスを示します。 |
| status | Integer | 必須 | 1 | 保護ルールのステータス。このパラメーターは、保護ルールの作成時にのみ使用されます。保護ルールのステータスを変更するには、 ModifyDefenseRuleStatus 操作の RuleStatus パラメーターを使用します。有効な値: - 0: 無効。 - 1 (デフォルト): 有効。 |
| config | String | 必須 | {"responseCode":400,"responseHeaders":[{"key":"custom","value":"123"},{"key":"aaa","value":"2223"}],"responseContent":"HelloWorld"} | JSON 文字列で記述されたカスタム設定情報。詳細については、「config の詳細設定」を参照してください。 |
config の詳細設定
| 名前 | タイプ | 必須 | 例 | 説明 |
| responseCode | Integer | 必須 | 400 | レスポンスコード。 |
| responseHeaders | Array | 任意 | [{"key":"custom","value":"123"},{"key":"aaaa","value":"2223"}] | JSON 文字列で記述されたカスタムレスポンスヘッダーのリスト。key はヘッダーフィールドを指定し、value はヘッダー値を指定します。 |
| responseContent | String | 必須 | 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. | 保護ルールの構成が無効です。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。