AWS WAF
AWS WAF のメトリクスを収集します。このインテグレーションでは WAFv2 API とスクリプト ID integration_aws_wafv2 を使用します。
設定¶
Func のインストール¶
Guance のインテグレーション - 拡張機能 - ホステッド Func の有効化を推奨します。前提条件はすべて自動的にインストールされるため、そのままスクリプトのインストールに進んでください。
Func を自前でデプロイする場合はFunc の自前デプロイを参照してください
スクリプトのインストール¶
ヒント: 要件を満たす Amazon AK を事前に用意してください(簡単にするため、グローバルの読み取り専用権限
ReadOnlyAccessを直接付与しても構いません)
マネージド版の有効化スクリプト¶
- Guance コンソールにログインします
- 【インテグレーション】メニューをクリックし、【クラウドアカウント管理】を選択します。
- [クラウドアカウントを追加] をクリックし、[AWS] を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順をスキップしてください
- [テスト] をクリックし、成功したら [保存] をクリックします。失敗した場合は、関連設定が正しいか確認して再度テストしてください
- 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
- クラウドアカウントの詳細ページで【インテグレーション】をクリックし、
未インストール一覧からAWS WAFを探して【インストール】をクリックします。
手動有効化スクリプト¶
-
Func コンソールにログインし、【スクリプトマーケット】から Guance のスクリプトマーケットを開いて、
integration_aws_wafv2を検索します。 -
[インストール] をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します
-
【起動スクリプトをデプロイ】をクリックします。システムが
Startupスクリプトセットを作成し、対応する起動スクリプトを自動設定します。 -
有効化後、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。[実行] をクリックすると、定期実行を待たずにすぐ 1 回実行できます。少し待ってから、実行タスクの記録と対応するログを確認してください
検証¶
- [管理 / 自動トリガー設定]で、対象タスクの自動トリガー設定が存在することを確認し、タスク履歴とログに異常がないか確認します。
- Guance の「インフラストラクチャ - リソースディレクトリ」で資産情報が存在するか確認します
- Guance の「メトリクス」で対応する監視データがあるか確認します
メトリクス¶
AWS WAF のメトリクスは aws_AWS/WAFV2 メトリクスセット下にあり、以下は一部メトリクスの説明、および単位と統計データです。
| メトリクス | 説明 | 単位 |
|---|---|---|
AllowedRequests |
許可された Web リクエスト数 | count |
BlockedRequests |
ブロックされた Web リクエスト数 | count |
RequestsWithValidChallengeToken |
チャレンジコントロールが適用され、チャレンジトークンが有効な Web リクエスト数 | count |
SampleBlockedRequest |
Block 操作が実行されたサンプルリクエスト数 | count |
CaptchaRequests |
CAPTCHA コントロールが適用された Web リクエスト数 | count |
PassedRequests |
通過したリクエスト数。これはルールグループの評価は通過したが、どのルールグループルールにも一致しなかったリクエストにのみ使用されます | count |
RequestsWithValidChallengeToken |
チャレンジコントロールが適用され、チャレンジトークンが有効な Web リクエスト数 | count |
SampleAllowedRequest |
Allow 操作が実行されたサンプルリクエスト数 | count |
SampleCaptchaRequest |
CAPTCHA 操作が実行されたサンプルリクエスト数 | count |
SampleChallengeRequest |
Challenge 操作が実行されたサンプルリクエスト数 | count |
SampleCountRequest |
Count 操作が実行されたサンプルリクエスト数 | count |
オブジェクト¶
収集された AWS WAF オブジェクトデータ構造で、オブジェクトデータは「基礎インフラ - リソースディレクトリ」で確認できます
{
"measurement": "aws_wafv2",
"tags": {
"Id" : "91d10100-xxxxxxxxx-89fb90d1f566",
"ARN" : "arn:aws:wafv2:us-east-1:87626xxxxx4:regional/webacl/test-123/446cc7d0-d87e-xxxxxxxxxx",
"Capacity" : "CN",
"LabelNamespace" : "awswaf:87626xxxxx4:webacl:test-us-east-1:xxxxx",
"ManagedByFirewallManager" : "False",
"RegionId" : "ap-southeast-1"
},
"fields": {
"LockToken" : "6fe50442-fdfe-4dd5-ba54-5xxxxxxxxxxx",
"Description" : "test-123",
"AssociationConfig" : "{xxxxxxx}",
"CaptchaConfig" : "{xxxxxxx}",
"ChallengeConfig" : "{xxxxxxx}",
"CustomResponseBodies" : "xxxxxxx",
"DefaultAction" : "{"Allow": {}}",
"PostProcessFirewallManagerRuleGroups" : "Success",
"PreProcessFirewallManagerRuleGroups" : "{xxxxxxxx}",
"Rules" : "{Rules}",
"TokenDomains" : "xxxxxxxx",
"VisibilityConfig" : "{xxxxxxx}"
}
}
注意:
tags、fieldsのフィールドは今後の更新で変更される可能性があります