AWS WAF を Google SecOps と統合する

このドキュメントでは、AWS WAF を Google Security Operations（Google SecOps）と統合する方法について説明します。

ユースケース

AWS WAF 統合により、次のことが可能になり、ウェブ アプリケーションを保護できます。

  • IP ブロックを自動化する: Google SecOps によって検出された悪意のある IP アドレスを AWS WAF IP セットに自動的に追加して、ネットワーク エッジでトラフィックをブロックします。
  • アクセス制御リスト（ACL）を管理する: ウェブ ACL を動的に作成して更新し、新たな脅威に対応します。
  • グローバル セキュリティとリージョン セキュリティをオーケストレートする: リージョン リソース（ALB など）とグローバル リソース（Amazon CloudFront）の両方のルールを 1 つのインターフェースから管理します。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
AWS アクセスキー ID 文字列 なし ○ 統合で使用する AWS アクセスキー ID。
AWS シークレット キー パスワード なし ○ 統合で使用する AWS シークレット キー。
AWS のデフォルト リージョン 文字列 なし はい 統合で使用する AWS のデフォルト リージョン（例: us-west-2）。

AWS WAF の Regional スコープは、ここで設定したリージョンに対応します。CloudFront スコープはグローバルであり、このリージョンに依存しませんが、Regional で作成されたリソースはこの値にスコープされます。

複数の AWS リージョンにわたって AWS WAF リソースを管理するには、リージョンごとに個別の統合インスタンスを構成する必要があります。

Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

Ping

AWS WAF への接続をテストします。

パラメータ

なし

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功した場合:「指定された接続パラメータを使用して AWS WAF サーバーに正常に接続されました。」

アクションが失敗し、ハンドブックの実行が停止します。

成功しなかった場合:「AWS WAF サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)

 全般

IP セットを作成する

エンティティに基づいて、AWS WAF で IP セットを作成します。

IP セットは次の形式で作成されます。

Siemplify_NAME_IP Type`

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
名前 文字列 なし はい IP セットの名前を指定します。注: このアクションにより、Siemplify_{Name}_{IP Type} の形式で IP セットが作成されます。名前は 1 ～ 128 文字にする必要があります。有効な文字: A ～ Z、a ～ z、0 ～ 9、-（ハイフン）、_（アンダースコア）。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい IP セットの作成範囲を指定します。[Both] を選択すると、リージョン スコープと Amazon CloudFront スコープに IP セットが作成されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
説明 文字列 なし いいえ IP セットの説明を指定します。
タグ CSV なし いいえ IP セットに追加する追加のタグを指定します。形式: key_1:value_1,key_2:value_1。

実行

このアクションは IP アドレス エンティティに対して実行されます。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
"Regional": ["IPv4_set", "IPv6_set"]
"Cloudfront":  ["IPv4_set", "IPv6_set"]
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、指定されたエンティティの少なくとも 1 つが IP セットの作成に使用された場合（is_success = true）: 「AWS WAF で、次の IP を使用して {0} {1} IP セット「{2}」が正常に作成されました: \n {3}」.format("Regional"/"Cloudfront", "IPv4"/"IPv6", full_name, entity.identifier list)

特定のエンティティを使用できなかった場合（is_success = true）: 「AWS WAF IP セットを作成するために次の IP を使用できませんでした\n: {0}」.format([entity.identifier])

すべてのエンティティを使用できなかった場合（is_success = false）: 「IP セットは作成されませんでした。理由: 指定された IP エンティティはいずれも有効ではありません。」

すべてのセットがすでに存在する場合（is_success=false）または一部のセットのみがすでに存在する場合（is_success=true）:「次の {0} IP パターンセット「{1}」はすでに存在します: \n.".format("Regional/CloudFront", list_of_full_names)

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「IP セットの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

IP を IP セットに追加する

AWS WAF の IP セットに IP アドレスを追加します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
IP セット名 CSV なし はい IP セット名のカンマ区切りリストを指定します。例: name_1,name_2
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい IP セットのスコープを指定します。[Both] を選択すると、Regional スコープと CloudFront スコープの IP セットに IP アドレスが追加されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。

実行

このアクションは IP アドレス エンティティに対して実行されます。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つの IP アドレスが 1 つの IP セットに追加された場合（is_success = true）: 「AWS WAF の {0} IP セット「{1}」に次の IP が正常に追加されました: \n {2}」.format("Regional"/"Cloudfront", full_name, entity.identifier list)

特定のエンティティをいずれかの IP セットに追加できなかった場合（is_success = true）: 「アクションは、AWS WAF の {0} IP セット「{1}」に次の IP を追加できませんでした\n: {2}」.format("Regional"/"Cloudfront", full_name,[entity.identifier])

いずれかの IP セットが見つからない場合（is_success = true）: 「アクションは、AWS WAF で次の「{0}」IP セットを見つけることができませんでした:\n {1}」.format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

選択したスコープで指定されたすべての IP セットが見つからない場合（is_success=false）:「指定された IP セットが見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「IP セットへの IP の追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

正規表現パターンセットを作成する

エンティティに基づいて AWS WAF で正規表現パターンセットを作成します。

正規表現パターンセットに含めることができるパターンは、セットごとに 10 個のみです。また、正規表現パターンセットの合計数は 10 個までです。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
名前 文字列 なし はい 正規表現パターンセットの名前を指定します。注: 名前は 1 ～ 128 文字にする必要があります。有効な文字: A ～ Z、a ～ z、0 ～ 9、-（ハイフン）、_（アンダースコア）。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい 正規表現パターンセットの作成スコープを指定します。[Both] が選択されている場合、アクションは Regional スコープと CloudFront スコープに設定された正規表現パターンを作成します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
説明 文字列 なし いいえ 正規表現パターンセットの説明を指定します。
タグ CSV なし いいえ 正規表現パターンセットに追加する追加のタグを指定します。形式: key_1:value_1,key_2:value_1。
ドメインパターン チェックボックス オン いいえ 有効にすると、このアクションは URL からドメイン部分を取得し、それに基づいて正規表現パターンを作成します。たとえば、http://test.com/folder は ^(http|https)(:\/\/)(\Qtest.com\E).*".format(entity) に変換されます。
IP パターン チェックボックス オン いいえ 有効にすると、このアクションは、未加工の値を使用する代わりに、IP アドレスから適切な正規表現パターンを構築します。たとえば、10.0.0.1 は ^(http|https)(:\/\/)(\Q10.0.1\E).*".format(entity) に変換されます。

実行

このアクションは次のエンティティに対して実行されます。

  • IP アドレス
  • URL

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
"Regional": "Regex_set"
"Cloudfront": "Regex_set"
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、提供されたエンティティの少なくとも 1 つが正規表現セットの作成に使用された場合（is_success = true）: 「AWS WAF で、次のエンティティを使用して {0} 正規表現パターンセット「{1}」が正常に作成されました: \n {2}」.format("Regional"/"Cloudfront", name, entity.identifier list)

10 個を超えるエンティティを使用して正規表現パターンセットを作成する場合: 「上限を超えているため、指定されたすべてのエンティティを使用して正規表現パターンセットを作成できませんでした。次のエンティティはスキップされました: {0}」.format(entity.identifier)

セットがすでに存在する場合（is_success=false）:「{0} 正規表現パターンセット「{1}」はすでに存在します。」.format("Regional/CloudFront", name)

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「正規表現パターンセットの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

ウェブ ACL を作成する

AWS WAF でウェブ ACL を作成します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
名前 文字列 なし はい ウェブ ACL の名前を指定します。注: 名前は 1 ～ 128 文字にする必要があります。有効な文字: A ～ Z、a ～ z、0 ～ 9、-（ハイフン）、_（アンダースコア）。
ルールのソースタイプ DDL

IP セット

値の例

IP セット

ルールグループ

 はい 使用するルールタイプを指定します。
ルールソース名 文字列 なし はい ウェブ ACL に使用するソースの名前を指定します。[Rule Source Type] が [IP Set] の場合、アクションはその名前の IP セットを検索します。[Rule Source Type] が [Rule Group] の場合、このアクションはその名前のルールグループを検索します。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい ウェブ ACL の作成スコープを指定します。[Both] を選択すると、Regional スコープと CloudFront スコープにウェブ ACL が作成されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
サンプリングされたリクエストを有効にする チェックボックス オフ はい 有効にすると、AWS WAF はルールに一致するウェブリクエストのサンプリングを保存します。
CloudWatch 指標を有効にする チェックボックス オフ はい 有効にすると、関連付けられたリソースが CloudWatch に指標を送信します。
CloudWatch の指標名 チェックボックス オフ はい CloudWatch 指標の名前を指定します。注: 名前は 1 ～ 128 文字にする必要があります。有効な文字: A ～ Z、a ～ z、0 ～ 9、-（ハイフン）、_（アンダースコア）。
デフォルトのアクション DDL

許可

値は次のいずれかです。

  • 許可
  • ブロック
 はい どのルールにも一致しないリクエストに対するデフォルトのアクションを指定します。
IP セットのアクション DDL

ブロック

値の例:

  • 許可
  • ブロック
  • 数
 いいえ IP セットに基づくルールのアクションを指定します。
ルールの優先順位 Integer なし はい ルールの優先度を指定します。ウェブ ACL の優先度は一意である必要があります。
説明 文字列 なし いいえ ウェブ ACL の説明を指定します。
タグ CSV なし いいえ ウェブ ACL に追加する追加のタグを指定します。形式: key_1:value_1,key_2:value_1。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
"Regional": "Web_Acl_name"
"Cloudfront": "Web_Acl_name"
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

利用可能な IP セットが正常に一覧表示され（is_success = true）、[Scope] が [Both] の場合: 「Regional スコープと CloudFront スコープでウェブ ACL {0} が正常に作成されました。」.format(name)

利用可能な IP セットが正常に一覧表示され（is_success = true）、"Scope" == "Regional" の場合: 「リージョンにウェブ ACL {0} が正常に作成されました。」.format(name)

利用可能な IP セットが正常に一覧表示され（is_success = true）、"Scope" == "Cloudfront" の場合: 「Cloudfront スコープでウェブ ACL {0} が正常に作成されました。」.format(name)

ウェブ ACL が存在する場合:

「The Web ACL {} already exists in {} scope.」という出力を表示します。format(web ACL name, scope).

IP セット / ルールグループが見つからなかった場合: 「アクションはウェブ ACL を作成できませんでした。Reason: {0} {1} wasn't found in AWS WAF".format("IP Set/Rule Group", Rule Source Name)

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「ウェブ ACL の作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

ウェブ ACL にルールを追加する

AWS WAF のウェブ ACL に、IP セットまたはルールグループに基づくルールを追加します。ウェブ ACL には最大 1,500 個のルールを含めることができます。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
ウェブ ACL 名 CSV なし はい

ウェブ ACL 名のカンマ区切りのリストを指定します。例: name_1,name_2
ルールのソースタイプ DDL

IP セット

値は次のいずれかです。

  • IP セット
  • ルールグループ
 はい 使用するルールタイプを指定します。
ルールソース名 文字列 なし はい ウェブ ACL に使用するソースの名前を指定します。[Rule Source Type] が [IP Set] の場合、アクションはその名前の IP セットを検索します。[Rule Source Type] が [Rule Group] の場合、このアクションはその名前のルールグループを検索します。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい 新しいルールのスコープを指定します。[Both] を選択すると、アクションによって Regional スコープと CloudFront スコープのウェブ ACL にルールが追加されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
ルールの優先順位 Integer なし はい ルールの優先度を指定します。ウェブ ACL の優先度は一意である必要があります。
IP セットのアクション DDL

ブロック

値の例:

  • 許可
  • ブロック
  • 数
 いいえ IP セットに基づくルールのアクションを指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つのルールが 1 つのウェブ ACL に追加された場合（is_success = true）:「AWS WAF の次の {0} ウェブ ACL「{1}」にルールが正常に追加されました」.format("Regional"/"Cloudfront", list of name)

いずれかのウェブ ACL が見つからない場合（is_success = true）: 「アクションは、AWS WAF で次の「{0}」ウェブ ACL を見つけることができませんでした:\n {1}」.format("Regional"/Cloudfront", list of Web ACLs that were not found in that scope)

スコープ内のウェブ ACL ごとに、同じ名前のルールがすでに存在する場合（is_success=true）:「AWS WAF のウェブ ACL に {0} 個のルールを追加できませんでした。理由: 名前が「{1}」の {0} は、次のウェブ ACL にすでに存在します:\n{2}」.format( rule source type, rule source name, list Web ACL with scope - structure {0} - {1}.format(scope, web acl name))

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「ウェブ ACL へのルールの追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

ルールグループを作成

AWS WAF でルールグループを作成します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
名前 文字列 なし はい ルールグループの名前を指定します。注: 名前は 1 ～ 128 文字にする必要があります。有効な文字: A ～ Z、a ～ z、0 ～ 9、-（ハイフン）、_（アンダースコア）。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい ルールグループの作成スコープを指定します。[両方] を選択すると、Regional スコープと CloudFront スコープにルール グループが作成されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
容量 Integer 100 はい ルールグループの容量を指定します。注: グループの作成後に容量を変更することはできません。最大値は 1,500 です。
サンプリングされたリクエストを有効にする チェックボックス オフ はい 有効にすると、AWS WAF はルールに一致するウェブリクエストのサンプリングを保存します。
CloudWatch 指標を有効にする チェックボックス オフ はい 有効にすると、関連付けられたリソースが CloudWatch に指標を送信します。
CloudWatch の指標名 チェックボックス オフ はい CloudWatch 指標の名前を指定します。注: 名前は 1 ～ 128 文字にする必要があります。有効な文字: A ～ Z、a ～ z、0 ～ 9、-（ハイフン）、_（アンダースコア）。
説明 文字列 なし いいえ ルールグループの説明を指定します。
タグ CSV なし いいえ ルールグループに追加する追加のタグを指定します。形式: key_1:value_1,key_2:value_1。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

利用可能な IP セットが正常に一覧表示され（is_success = true）、"Scope" == "Both" の場合: "Successfully created Rule Group {0} in Regional and CloudFront scopes.".format(name)

>利用可能な IP セットが正常に一覧表示され（is_success = true）、"Scope" == "Regional" の場合: 「ルールグループ {} は {} スコープにすでに存在します。」.format(web ACL name, scope)。

利用可能な IP セットが正常に一覧表示され（is_success = true）、"Scope" == "Cloudfront" の場合: "Successfully created Rule Group {0} in Cloudfront scope.".format(name)

ルールグループが存在する場合:「Cloudfront スコープにルールグループ {0} が正常に作成されました」.format(name)

ルールグループの作成に失敗した場合「アクションは、{} スコープでルールグループ {} を作成できませんでした」.format(ウェブ ACL 名、スコープ)。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「ルールグループの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

正規表現パターンセットにエンティティを追加する

エンティティに基づく文字列パターンを、AWS WAF で設定された正規表現パターンセットに追加します。

正規表現パターンセットに含めることができるパターンは、セットごとに 10 個までです。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
正規表現パターンセット名 CSV なし はい 正規表現パターンセット名のカンマ区切りのリスト（name_1,name_2 など）を指定します。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい 正規表現パターンセットのスコープ。[Both] が選択されている場合、このアクションは、エンティティに基づくパターンを Regional スコープと CloudFront スコープの両方の正規表現パターンセットに追加します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
ドメインパターン チェックボックス オン いいえ 有効にすると、アクションは URL からドメイン部分を取得し、それに基づいて正規表現パターンを作成します。たとえば、http://test.com/folder は ^(http|https)(:\/\/)(\Qtest.com\E).*".format(entity) に変換されます。
IP パターン チェックボックス オン

いいえ

 有効にすると、このアクションは、未加工の値を使用する代わりに、IP アドレスから適切な正規表現パターンを構築します。たとえば、10.0.0.1 は ^(http|https)(:\/\/)(\Q10.0.1\E).*".format(entity) に変換されます。

実行

このアクションは次のエンティティに対して実行されます。

  • IP アドレス
  • URL

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つのエンティティが 1 つの正規表現パターンセットに追加された場合（is_success = true）: 「AWS WAF の {0} 正規表現パターンセット「{1}」に次のエンティティ パターンが正常に追加されました: \n {2}」.format("Regional"/"Cloudfront", name, list of entity patterns)

正規表現パターンセットの作成に 10 個を超えるエンティティが使用される場合: "Action wasn't able to add patterns to {0} Regex Pattern Set {1} based on all of the provided entities, because the limit is exceeded. 次のエンティティはスキップされました: {2}".forma("Regional"/"Cloudfront", name, entity.identifier)

いずれかのセットが見つからない場合（is_success = true）: 「アクションは、AWS WAF で次の「{0}」正規表現パターンセットを見つけることができませんでした:\n {1}」.format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope)

選択したスコープで指定されたすべてのセットが見つからない場合（is_success=false）:「指定された正規表現パターンセットが見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「正規表現パターンセットへのエンティティの追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

正規表現パターンセットにパターンを追加する

AWS WAF で設定された正規表現パターンセットに文字列パターンを追加します。

正規表現パターンセットに含めることができるパターンは、セットごとに 10 個までです。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
正規表現パターンセット名 CSV なし はい 正規表現パターンセット名のカンマ区切りのリスト（name_1,name_2 など）を指定します。
パターン CSV なし はい 正規表現パターンセットに追加するパターンのカンマ区切りのリストを指定します（例: pattern_1,pattern_2）。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい 正規表現パターンセットのスコープ。[Both] が選択されている場合、このアクションは、エンティティに基づくパターンを Regional スコープと CloudFront スコープの両方の正規表現パターンセットに追加します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つのパターンが 1 つの正規表現パターンセットに追加された場合（is_success = true）:「AWS WAF の {0} 正規表現パターンセット「{1}」に次のパターンが正常に追加されました: \n {2}」.format("Regional"/"Cloudfront", name, list of patterns)

いずれかのセットが見つからない場合（is_success = true）:t "Action wasn't able to find the following '{0}' 正規表現パターンセット in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope).

選択したスコープで指定されたすべてのセットが見つからない場合（is_success=false）:「指定された正規表現パターンセットが見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「正規表現パターンセットへのパターンの追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

ウェブ ACL からルールを削除する

AWS WAF のウェブ ACL からルールを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
ウェブ ACL 名 CSV はい

ウェブ ACL 名のカンマ区切りのリストを指定します。例: name_1,name_2
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい ウェブ ACL の削除のスコープを指定します。[両方] を選択すると、Regional スコープと CloudFront スコープのウェブ ACL が削除されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
ルール名 文字列

なし

 はい 削除するルールの名前を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つのルールが 1 つのルールグループから削除された場合: print "Successfully removed a rule from the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

1 つのルールグループで失敗した場合: 「アクションは AWS WAF の次の {0} ウェブ ACL '{1}' からルールを削除できませんでした」と出力します。format("Regional"/"Cloudfront", list of names)

1 つの ACL でルールが見つからなかったため、1 つのウェブ ACL で失敗した場合: 「アクションは、AWS WAF の次の {0} ウェブ ACL '{1}' で指定されたルールを見つけることができませんでした」を印刷します。format("Regional"/"Cloudfront", list of names Web ACL)

いずれかのルールグループが見つからない場合: 「アクションは、AWS WAF で次の「{0}」ウェブ ACL を見つけることができませんでした:\n {1}」と出力します。format("Regional"/Cloudfront", そのスコープで見つからなかったルールグループのリスト)

指定されたすべてのセットが目的のスコープで見つからない場合: 「アクションで指定されたウェブ ACL が見つかりませんでした」と出力します。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「ウェブ ACL からルールを削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

ウェブ ACL を一覧表示する

AWS WAF で使用可能なウェブ ACL を一覧表示します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 ウェブ ACL のリストのスコープを指定します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
返されるウェブ ACL の最大数 Integer 50 いいえ 返されるウェブ ACL の数を指定します。デフォルトは 50 です。最大値は 100 です。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

利用可能な IP セットが正常に一覧表示され、「Scope」==「Both」の場合:「リージョン スコープと Cloudfront スコープで利用可能なウェブ ACL が正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され（is_success = true）、"Scope" == "Regional" の場合:「リージョン スコープで利用可能なウェブ ACL が正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され（is_success = true）、"Scope" == "Cloudfront" の場合:「Cloudfront スコープで利用可能なウェブ ACL が正常に一覧表示されました。」

使用可能な値がなく（is_success = false）、"Scope" == "Both" の場合:「リージョン スコープと Cloudfront スコープで使用可能なウェブ ACL が見つかりませんでした。」

利用可能な値がない場合（is_success = false）で、「Scope」==「Regional」の場合:「リージョン スコープで利用可能なウェブ ACL が見つかりませんでした。」

利用可能な値がない場合（is_success = false）で、「Scope」==「Cloudfront」の場合:「Cloudfront スコープで利用可能なウェブ ACL が見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「ウェブ ACL の一覧表示」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

ケースウォール テーブル

（「Scope」が「Regional」または「Both」の場合）

テーブル名: リージョン ルール ACL

テーブル列:

  • 名前
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

Case Wall テーブル

（[Scope] が [CloudFront] または [Both] の場合）

テーブル名: CloudFront ルール ACL

テーブル列:

  • Name
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

ルールグループからルールを削除する

AWS WAF のルールグループからルールを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
ルールグループ名 CSV はい ルールグループ名のカンマ区切りのリストを指定します。例: name_1,name_2
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい ルールグループの削除のスコープを指定します。[両方] を選択すると、Regional スコープと CloudFront スコープのルール グループが削除されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
ルール名 文字列

なし

 はい 削除するルールの名前を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つのルールが 1 つのルールグループから削除された場合: 「AWS WAF の次の {0} ルールグループ「{1}」からルールが正常に削除されました」.format("Regional"/"Cloudfront", list of names)

1 つのルールグループで失敗した場合: 「アクションは、AWS WAF の次の {0} ルールグループ「{1}」からルールを削除できませんでした。」.format("Regional"/"Cloudfront", list of names)

1 つのルールグループでルールが見つからなかったために、1 つのルールグループで失敗した場合: 「アクションでは、AWS WAF の次の {0} ルールグループ「{1}」で指定されたルールが見つかりませんでした。」.format("Regional"/"Cloudfront", ルールグループ名のリスト)

いずれかのルールグループが見つからない場合: 「アクションは、AWS WAF で次の「{0}」ルールグループを見つけることができませんでした:\n {1}」.format("Regional"/Cloudfront", そのスコープで見つからなかったルールグループのリスト)

指定されたすべてのセットが目的のスコープで見つからない場合: 「アクションは、指定されたルールグループを見つけることができませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

致命的なエラー、SDK エラー（認証情報が間違っている、サーバーへの接続がないなど）が報告される場合: "Error executing action "Remove Rule From Rule Group". 理由: {0}」.format(error.Stacktrace)

 全般

ルールグループを一覧表示する

AWS WAF で使用可能なルールグループを一覧表示します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 ルールグループのリストのスコープを指定します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
返されるルールグループの最大数 Integer 50 いいえ 返されるルールグループの数を指定します。デフォルトは 50 です。最大値は 100 です。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

利用可能な IP セットが正常に一覧表示され、「Scope」が「Both」の場合:「リージョン スコープと Cloudfront スコープで利用可能なルールグループが正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され、「Scope」==「Regional」の場合:「リージョン スコープで利用可能なルールグループが正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され、「Scope」==「Cloudfront」の場合:「Cloudfront スコープで利用可能なルールグループが正常に一覧表示されました。」>

使用可能な値がなく、「Scope」==「Both」の場合:「リージョン スコープと Cloudfront スコープで使用可能なルールグループが見つかりませんでした。」

使用可能な値がなく、「Scope」が「Regional」の場合:「リージョン スコープで使用可能なルールグループが見つかりませんでした。」

利用可能な値がなく、「Scope」==「Cloudfront」の場合:「Cloudfront スコープで利用可能なルールグループが見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

致命的なエラー、SDK エラー（認証情報が間違っている、サーバーへの接続がないなど）が報告される場合: "Error executing action "List Rule Groups". 理由: {0}」.format(error.Stacktrace)

 一般

ケースウォール テーブル

（「Scope」が「Regional」または「Both」の場合）

テーブル名: リージョン ルールグループ

テーブル列:

  • 名前
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

ケースウォール テーブル

（「Scope」が「CloudFront」または「Both」の場合）

テーブル名: CloudFront ルールグループ

テーブル列:

  • 名前
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

IP セットを一覧表示する

AWS WAF で使用可能な IP セットを一覧表示します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 IP セットのリストのスコープを指定します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
返される IP セットの最大数 Integer 50 いいえ 返される IP セットの数を指定します。デフォルトは 50 です。最大値は 100 です。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

利用可能な IP セットが正常に一覧表示され、「Scope」==「Both」の場合:「リージョン スコープと Cloudfront スコープで利用可能な IP セットが正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され、「Scope」==「Regional」の場合:「リージョン スコープで利用可能な IP セットが正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され、「Scope」==「Cloudfront」の場合:「Cloudfront スコープで利用可能な IP セットが正常に一覧表示されました。」

使用可能な値がなく、「Scope」==「Both」の場合: 「リージョン スコープと Cloudfront スコープで使用可能な IP セットが見つかりませんでした」と出力します。

使用可能な値がなく、「Scope」==「Regional」の場合:「リージョン スコープで使用可能な IP セットが見つかりませんでした。」

使用可能な値がなく、「Scope」==「Cloudfront」の場合:「Cloudfront スコープで使用可能な IP セットが見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

致命的なエラー、SDK エラー（認証情報が間違っている、サーバーへの接続がないなど）が報告される場合: "Error executing action "List IP Sets". 理由: {0}」.format(error.Stacktrace)

 一般

ケースウォール テーブル

（「Scope」が「Regional」または「Both」の場合）

テーブル名: リージョン ルールグループ

テーブル列:

  • 名前
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

ケースウォール テーブル

（「Scope」が「CloudFront」または「Both」の場合）

テーブル名: CloudFront ルールグループ

テーブル列:

  • 名前
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

正規表現パターンセットからパターンを削除する

AWS WAF の正規表現セットからパターンを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
正規表現パターンセット名 CSV はい 正規表現セット名のカンマ区切りのリストを指定します（例: name_1,name_2）。
パターン CSV はい 正規表現セットから削除するパターンのカンマ区切りのリストを指定します（例: pattern_1,pattern_2）。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい セットのスコープ。[Both] が選択されている場合、このアクションは Regional スコープと CloudFront スコープの両方の正規表現セットからパターンを削除します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つのパターンセットが 1 つの正規表現セットから削除された場合: 「AWS WAF の {0} 正規表現パターンセット「{1}」から次のパターンが正常に削除されました: \n {2}」.format("Regional"/"Cloudfront", full_name, list of entity patterns)

パターンがそのパターンセットに存在しなかった場合: 「AWS WAF の {0} 正規表現パターンセット「{1}」で次のパターンが見つかりませんでした: \n {2}」.format("Regional"/"Cloudfront", full_name, list of patterns)

すべての正規表現パターンセットからすべてのパターンを削除できなかった場合:「指定された正規表現パターンセットから削除されたパターンはありません。」

いずれかのパターンセットが見つからない場合: 「アクションは、AWS WAF で次の「{0}」正規表現パターンセットを見つけることができませんでした:\n {1}」.format("Regional"/Cloudfront",list of sets that were not found in that scope)

指定されたすべての正規表現パターンセットが、目的のスコープで見つからない場合: 「アクションは、指定された正規表現パターンセットを見つけられませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーが報告された場合:「アクション「正規表現パターンセットからパターンを削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

IP セットから IP を削除する

AWS WAF の IP セットから IP アドレスを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
IP セット名 CSV はい IP セット名のカンマ区切りリストを指定します。例: name_1,name_2
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい IP セットのスコープを指定します。[両方] を選択すると、Regional スコープと CloudFront スコープの IP セットから IP アドレスが削除されます。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。

実行

このアクションは IP エンティティに対して実行されます。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つの IP アドレスが 1 つの IP セットから削除された場合: 「AWS WAF の {0} IP セット「{1}」から次の IP が正常に削除されました: \n {2}」.format("Regional"/"Cloudfront", full_name, entity.identifier list)

IP がその IP セットに存在しなかった場合: 「以下の IP は AWS WAF の {0} IP セット '{1}' の一部ではありませんでした: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

すべての IP セットですべてのエンティティを削除できなかった場合:「指定された IP セットから削除された IP はありません。」

いずれかの IP セットが見つからない場合:P 「アクションは、AWS WAF で次の「{0}」IP セットを見つけることができませんでした:\n {1}」.format("Regional"/Cloudfront",そのスコープで見つからなかった IP セットのリスト)

指定されたすべての IP セットが目的のスコープで見つからない場合: 「アクションは、指定された IP セットを見つけられませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーが報告された場合:「アクション「IP セットから IP を削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

正規表現パターンセットを一覧表示する

AWS WAF で使用可能な正規表現セットを一覧表示します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 IP セットのリストのスコープを指定します。
返される正規表現パターンセットの最大数 Integer 5 いいえ 返される正規表現セットの数を指定します。デフォルトは 5 です。最大値は 10 です。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

利用可能な正規表現セットが正常に一覧表示され、「Scope」==「Both」の場合:「リージョン スコープと Cloudfront スコープで利用可能な正規表現パターン セットが正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され、「Scope」==「Regional」の場合:「リージョン スコープで利用可能な正規表現パターンセットが正常に一覧表示されました。」

利用可能な IP セットが正常に一覧表示され、「Scope」==「Cloudfront」の場合: 「Cloudfront スコープで利用可能な正規表現パターンセットが正常に一覧表示されました。」

使用可能な値がなく、「Scope」==「Both」の場合:「リージョン スコープと Cloudfront スコープで使用可能な正規表現パターンセットが見つかりませんでした。」

使用可能な値がなく、「Scope」が「Regional」の場合:「リージョン スコープで使用可能な正規表現パターンセットが見つかりませんでした。」

使用可能な値がなく、「Scope」==「Cloudfront」の場合:「Cloudfront スコープで使用可能な正規表現パターンセットが見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

致命的なエラー、SDK エラー（認証情報が間違っている、サーバーへの接続がないなど）が報告される場合: "Error executing action "List Regex Pattern Sets". 理由: {0}」.format(error.Stacktrace)

 一般

ケースウォール テーブル

（「Scope」が「Regional」または「Both」の場合）

テーブル名: リージョン ルールグループ

テーブル列:

  • 名前
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

ケースウォール テーブル

（「Scope」が「CloudFront」または「Both」の場合）

テーブル名: CloudFront ルールグループ

テーブル列:

  • 名前
  • ID
  • 説明
  • ロックトークン
  • ARN
 全般

正規表現パターンセットからエンティティを削除

AWS WAF で設定された正規表現セットから、エンティティに基づく文字列パターンを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
正規表現パターンセット名 CSV はい 正規表現セット名のカンマ区切りのリストを指定します（例: name_1,name_2）。
範囲 DDL

CloudFront

値は次のいずれかです。

  • CloudFront
  • リージョン
  • 両方
 はい セットのスコープ。[Both] が選択されている場合、このアクションは、Regional スコープと CloudFront スコープの正規表現セットからエンティティに基づいてパターンを削除します。

CloudFront は、Amazon CloudFront で使用されるリソースのグローバル スコープです。Regional は、AWS Default Region 統合パラメータで構成された特定の AWS リージョンを指します。
ドメインパターン チェックボックス 正しい いいえ

有効にすると、このアクションは URL からドメイン部分を取得し、正規表現セット内のドメイン部分に基づいて正規表現を検索します。たとえば、http://test.com/folder は ^(http|https)(:\/\/)(\Qtest.com\E).* に変換されます。
IP パターン チェックボックス 正しい いいえ 有効にすると、このアクションは、未加工の値ではなく、IP アドレスから正規表現を検索します。たとえば、10.0.0.1 は ^(http|https)(:\/\/)(\Q10.0.1\E).* に変換されます。

実行

このアクションは次のエンティティに対して実行されます。

  • IP アドレス
  • URL

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功し、少なくとも 1 つのエンティティが 1 つの IP セットから削除された場合: 「AWS WAF の {0} 正規表現パターンセット '{1}' から次のエンティティ パターンが正常に削除されました: \n {2}".format("Regional"/"Cloudfront", full_name, list of entity patterns)」

エンティティがその正規表現パターンセットに存在しない場合: 「AWS WAF の {0} 正規表現パターンセット「{1}」に次のパターンが見つかりませんでした: \n {2}」.format("Regional"/"Cloudfront", full_name, list of entity patterns)

すべての IP セットですべてのエンティティを削除できなかった場合:「指定された正規表現パターンセットからパターンが削除されませんでした。」

いずれかの IP セットが見つからない場合: 「アクションは、AWS WAF で次の '{0}' 正規表現パターンセットを見つけることができませんでした:\n {1}」.format("Regional"/Cloudfront",そのスコープで見つからなかった IP セットのリスト)

指定されたすべての正規表現パターンセットが、目的のスコープで見つからない場合: 「アクションは、指定された正規表現パターンセットを見つけられませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーが報告された場合:「アクション「正規表現パターンセットからエンティティを削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。