翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS WAF V2 のアクション、リソース、および条件キー
AWS WAF V2 (サービスプレフィックス: wafv2) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。
リファレンス:
-
このサービスを設定する方法について説明します。
-
このサービスで使用可能な API オペレーションのリストを表示します。
-
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。
AWS WAF V2 で定義されるアクション
IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、 AWSでオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。
[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。
注記
リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。
以下の表の列の詳細については、「アクションテーブル」を参照してください。
| アクション | 説明 | アクセスレベル | リソースタイプ (* 必須) | 条件キー | 依存アクション |
|---|---|---|---|---|---|
| AssociateWebACL | WebACL をリソースに関連付けるアクセス許可を付与 | Write |
apigateway:SetWebACL apprunner:AssociateWebAcl appsync:SetWebACL cognito-idp:AssociateWebACL ec2:AssociateVerifiedAccessInstanceWebAcl elasticloadbalancing:SetWebAcl |
||
| CheckCapacity | 指定したスコープとルールのセットについて、ウェブ ACL キャパシティーユニット (WCU) 要件を計算する許可を付与 | 読み取り | |||
| CreateAPIKey | JavaScript クライアントアプリケーションの CAPTCHA API の統合で使用する API キーを作成するアクセス許可を付与します | 書き込み | |||
| CreateIPSet | IPSet を作成する許可を付与 | 書き込み | |||
| CreateRegexPatternSet | を作成する許可を付与 RegexPatternSet | 書き込み | |||
| CreateRuleGroup | を作成する許可を付与 RuleGroup | 書き込み | |||
| CreateWebACL | WebACL を作成する許可を付与 | 書き込み | |||
| DeleteAPIKey | API キーを削除する許可を付与 | 書き込み | |||
| DeleteFirewallManagerRuleGroups | Firewall Manager によって管理されなくなった場合、WebACL FirewallManagedRulesGroups から削除するアクセス許可を付与します | 書き込み | |||
| DeleteIPSet | IPSet を削除する許可を付与。 | 書き込み | |||
| DeleteLoggingConfiguration | WebACL LoggingConfiguration から を削除する許可を付与 | 書き込み | |||
| DeletePermissionPolicy | PermissionPolicy の を削除するアクセス許可を付与します RuleGroup | 権限の管理 | |||
| DeleteRegexPatternSet | を削除するアクセス許可を付与します RegexPatternSet | 書き込み | |||
| DeleteRuleGroup | を削除するアクセス許可を付与します RuleGroup | 書き込み | |||
| DeleteWebACL | WebACL を削除する許可を付与 | 書き込み | |||
| DescribeAllManagedProducts | マネージドルールグループの製品情報を取得する許可を付与 | 読み取り | |||
| DescribeManagedProductsByVendor | 指定されたベンダーによるマネージドルールグループの製品情報を取得する許可を付与 | 読み取り | |||
| DescribeManagedRuleGroup | マネージドルールグループの高レベル情報を取得する許可を付与 | 読み取り | |||
| DisassociateFirewallManager [アクセス許可のみ] | WebACL から Firewall Manager の関連付けを解除する許可を付与 | 書き込み | |||
| DisassociateWebACL | アプリケーションリソースから WebACL の関連付けを解除する許可を付与 | 書き込み |
apigateway:SetWebACL apprunner:DisassociateWebAcl appsync:SetWebACL cognito-idp:DisassociateWebACL ec2:DisassociateVerifiedAccessInstanceWebAcl elasticloadbalancing:SetWebAcl |
||
| GenerateMobileSdkReleaseUrl | モバイル SDK の指定したリリースの署名済みダウンロード URL を生成するアクセス許可を付与 | 読み取り | |||
| GetDecryptedAPIKey | API キーを復号化された形式で返す許可を付与します。これは、キーのために定義したトークンドメインを確認するためにします。 | 読み取り | |||
| GetIPSet | IPSet の詳細を取得するアクセス許可を付与 | 読み取り | |||
| GetLoggingConfiguration | WebACL LoggingConfiguration の を取得するアクセス許可を付与します | 読み取り | |||
| GetManagedRuleSet | に関する詳細を取得するアクセス許可を付与します ManagedRuleSet | 読み取り | |||
| GetMobileSdkRelease | リリースノートやタグなど、指定したモバイル SDK リリースの情報を取得するアクセス許可を付与 | 読み取り | |||
| GetPermissionPolicy | PermissionPolicy の を取得する許可を付与 RuleGroup | 読み取り | |||
| GetRateBasedStatementManagedKeys | レートベースのルールによって現在ブロックされているキーを取得する許可を付与 | 読み取り | |||
| GetRegexPatternSet | に関する詳細を取得するアクセス許可を付与します RegexPatternSet | 読み取り | |||
| GetRuleGroup | に関する詳細を取得するアクセス許可を付与します RuleGroup | 読み取り | |||
| GetSampledRequests | ウェブリクエストのサンプリングに関する詳細情報を取得する許可を付与 | Read | |||
| GetWebACL | WebACL の詳細を取得する許可を付与 | Read | |||
| GetWebACLForResource | リソースに関連付けられている WebACL を取得する許可を付与 | 読み取り |
apprunner:DescribeWebAclForService cognito-idp:GetWebACLForResource ec2:GetVerifiedAccessInstanceWebAcl wafv2:GetWebACL |
||
| ListAPIKeys | 指定された範囲のために定義した API キーのリストを取得する許可を付与 | リスト | |||
| ListAvailableManagedRuleGroupVersions | 使用可能なマネージドルールグループのバージョンを取得する許可を付与 | リスト | |||
| ListAvailableManagedRuleGroups | 使用可能なマネージドルールグループの配列を取得する許可を付与 | リスト | |||
| ListIPSets | 管理する IP セットの IP SetSummary オブジェクトの配列を取得する許可を付与 | リスト | |||
| ListLoggingConfigurations | LoggingConfiguration オブジェクトの配列を取得する許可を付与 | リスト | |||
| ListManagedRuleSets | ManagedRuleSet オブジェクトの配列を取得する許可を付与 | リスト | |||
| ListMobileSdkReleases | モバイル SDK や指定したデバイスプラットフォームのリリース済みリストを取得するアクセス許可を付与 | リスト | |||
| ListRegexPatternSets | 管理する正規表現パターンセットの RegexPatternSetSummary オブジェクトの配列を取得するアクセス許可を付与します | リスト | |||
| ListResourcesForWebACL | ウェブ ACL に関連付けられているリソースの Amazon リソースネーム (ARN) の配列を取得する許可を付与。 | リスト |
apprunner:ListAssociatedServicesForWebAcl cognito-idp:ListResourcesForWebACL ec2:DescribeVerifiedAccessInstanceWebAclAssociations |
||
| ListRuleGroups | 管理するルールグループの RuleGroupSummary オブジェクトの配列を取得するアクセス許可を付与します | リスト | |||
| ListTagsForResource | リソースのタグを一覧表示する許可を付与 | Read | |||
| ListWebACLs | 管理するウェブ ACL の WebACLSummary オブジェクトの配列を取得する許可を付与。 | リスト | |||
| PutFirewallManagerRuleGroups [アクセス許可のみ] | WebACL FirewallManagedRulesGroups で を作成するアクセス許可を付与します | 書き込み | |||
| PutLoggingConfiguration | を有効にしてウェブ ACL のログ記録 LoggingConfigurationを開始するアクセス許可を付与します | 書き込み |
iam:CreateServiceLinkedRole |
||
| PutManagedRuleSetVersions | の新しいバージョンの作成または既存のバージョンの更新を有効にするアクセス許可を付与します ManagedRuleSet | 書き込み | |||
| PutPermissionPolicy | アカウント間でルールグループを共有するために使用する IAM ポリシーをリソースにアタッチするアクセス許可を付与 | 権限の管理 | |||
| TagResource | タグを AWS リソースに関連付けるアクセス許可を付与します | タグ付け | |||
| UntagResource | AWS リソースからタグの関連付けを解除するアクセス許可を付与します | タグ付け | |||
| UpdateIPSet | IPSet を更新する許可を付与 | 書き込み | |||
| UpdateManagedRuleSetVersionExpiryDate | でバージョンの有効期限を更新する許可を付与 ManagedRuleSet | 書き込み | |||
| UpdateRegexPatternSet | を更新する許可を付与 RegexPatternSet | 書き込み | |||
| UpdateRuleGroup | を更新する許可を付与 RuleGroup | 書き込み | |||
| UpdateWebACL | WebACL を更新する許可を付与 | 書き込み | |||
AWS WAF V2 で定義されるリソースタイプ
以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。
| リソースタイプ | ARN | 条件キー |
|---|---|---|
| webacl |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/webacl/${Name}/${Id}
|
|
| ipset |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/ipset/${Name}/${Id}
|
|
| managedruleset |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/managedruleset/${Name}/${Id}
|
|
| rulegroup |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/rulegroup/${Name}/${Id}
|
|
| regexpatternset |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/regexpatternset/${Name}/${Id}
|
|
| loadbalancer/app/ |
arn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId}
|
|
| apigateway |
arn:${Partition}:apigateway:${Region}::/restapis/${ApiId}/stages/${StageName}
|
|
| appsync |
arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}
|
|
| userpool |
arn:${Partition}:cognito-idp:${Region}:${Account}:userpool/${UserPoolId}
|
|
| apprunner |
arn:${Partition}:apprunner:${Region}:${Account}:service/${ServiceName}/${ServiceId}
|
|
| verified-access-instance |
arn:${Partition}:ec2:${Region}:${Account}:verified-access-instance/${VerifiedAccessInstanceId}
|
AWS WAF V2 の条件キー
AWS WAF V2 では、IAM ポリシーの Condition要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。
すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。
| 条件キー | 説明 | タイプ |
|---|---|---|
| aws:RequestTag/${TagKey} | 各タグの許可された値のセットでアクセスをフィルタリングします | 文字列 |
| aws:ResourceTag/${TagKey} | リソースに関連付けられたタグ値でアクセスをフィルタリングします | 文字列 |
| aws:TagKeys | リクエスト内の必須タグの存在でアクセスをフィルタリングします | ArrayOfString |
| wafv2:LogDestinationResource | PutLoggingConfiguration API のログ送信先 ARN でアクセスをフィルタリングします | ARN |
| wafv2:LogScope | ログ記録設定 API のログスコープでアクセスをフィルタリングします | 文字列 |
