コンテンツにスキップ

AWS WAF

AWS WAF のメトリクスを収集します。このインテグレーションでは WAFv2 API とスクリプト ID integration_aws_wafv2 を使用します。

設定

Func のインストール

Guance のインテグレーション - 拡張機能 - ホステッド Func の有効化を推奨します。前提条件はすべて自動的にインストールされるため、そのままスクリプトのインストールに進んでください。

Func を自前でデプロイする場合はFunc の自前デプロイを参照してください

スクリプトのインストール

ヒント: 要件を満たす Amazon AK を事前に用意してください(簡単にするため、グローバルの読み取り専用権限 ReadOnlyAccess を直接付与しても構いません)

マネージド版の有効化スクリプト

  1. Guance コンソールにログインします
  2. 【インテグレーション】メニューをクリックし、【クラウドアカウント管理】を選択します。
  3. [クラウドアカウントを追加] をクリックし、[AWS] を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順をスキップしてください
  4. [テスト] をクリックし、成功したら [保存] をクリックします。失敗した場合は、関連設定が正しいか確認して再度テストしてください
  5. 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
  6. クラウドアカウントの詳細ページで【インテグレーション】をクリックし、未インストール 一覧から AWS WAF を探して【インストール】をクリックします。

手動有効化スクリプト

  1. Func コンソールにログインし、【スクリプトマーケット】から Guance のスクリプトマーケットを開いて、integration_aws_wafv2 を検索します。

  2. [インストール] をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します

  3. 【起動スクリプトをデプロイ】をクリックします。システムが Startup スクリプトセットを作成し、対応する起動スクリプトを自動設定します。

  4. 有効化後、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。[実行] をクリックすると、定期実行を待たずにすぐ 1 回実行できます。少し待ってから、実行タスクの記録と対応するログを確認してください

検証

  1. [管理 / 自動トリガー設定]で、対象タスクの自動トリガー設定が存在することを確認し、タスク履歴とログに異常がないか確認します。
  2. Guance の「インフラストラクチャ - リソースディレクトリ」で資産情報が存在するか確認します
  3. 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 のフィールドは今後の更新で変更される可能性があります

フィードバック

このページは役に立ちましたか?