2.1. XC Consoleの設定

本節では、XC ConsoleでのBot Dedenseの設定を紹介します。

  1. XC Consoleのトップページより、 Bot Defense をクリックします。
../../_images/console_top2.png
  1. Manage > Applications より、 + Add Application をクリックします。
../../_images/Manage-Application.png
  1. Protected Application 設定を入力します。
../../_images/Metadata.png
  • Name : 任意の名前を入力します。
  • Application Region : US、EU、Asiaから選択します。
  • Connector Type : Amazon CloudFrontを選択します。
  • Amazon CloudFront : Configureをクリックし、詳細項目設定します。
  1. 詳細項目を設定します。
../../_images/Application_detail.png
  1. Amazon Reference Information を入力します。
AWS Configuration は、Apply Distribution Configuration Manually、Select AWS CloudFront Distribution by ID、Select AWS CloudFrontt Dustribution by tag matchingから選択できますが、本ドキュメントでは、設定が簡単なSelect CoudFront Distribution by ID を選択し、Configureをクリックします。
../../_images/Amazon_reference_Information.png
  • ID : Amazon CloudFrontのDistribution IDを入力します。
  1. Protected Endpoints の情報を入力します。
../../_images/protected_endpoint2.png
  • Name : 任意の名前を入力します。
  • Domain Matcher : Any Domain (全てのドメインを対象)、Domain (特定のドメインを指定)を選択します。本ドキュメントではAny Domainを指定します。
  • Path : 保護対象のパスを選択します。本ドキュメントではカート追加のパス(/products/add_cart*)を入力します。
  • Query : 必要な場合Query Parameterを入力。本ドキュメントでは空白にします。
  • HTTP Methods : HTTP MethodをGET(XHR/Fetch)、POST、PUTから選択します。本ドキュメントはカート追加の例になるのでPOSTを選択します。
  • Endpoint Label : コンソールからモニターする際のラベリングを設定します。本ドキュメントでは、Flow LabelをShopping & Gift Cards、Flow LabelをAdd to Cartにします。
  • Client Type : Web Client、Mobile Client、Web And Mobile Clientから選択。本ドキュメントではWeb Clientを選択します。
  • Mitigate : Continue (リクエストはログだけされてOriginに転送)、Redirect (指定されたページにリダイレクト)、Block (リクエストはブロックし、ブロックページで応答)に設定します。本ドキュメントではBlockで設定します。
  • Status : ブロックページで応答するときのレスポンスコードを指定します。
  • Content Type : Content Typeを選択します。
  • Body : Blockページをカスタマイズします。

必要事項を設定後、右下の Apply ボタンを2回クリックします。

  1. Web Client Java Script Settings の設定
Web Client Java Script Settings で、Specify JavaScript Insertion Rulesを選択し、Specify JavaScript Insertion RulesでConfigureをクリックします。
../../_images/JavaScript_Insertion.png
  • Web Client JavaScript Path : Bot判定が行われるJavaScriptのPathを指定します。Defaultでは、/common.jsになります。他のWebアプリケーションと同じ名前は避けます。セキュリティのためにF5を連想する名前も避けることをお勧めします。
  • Web Client JavaScript Mode : Asnyc JS with no Caching、Async JS with Caching、Sync JS with no Caching、Sync JS with Cachingから選択します。※ Async: JavaScriptは読み込まれるとすぐに実行され、ページの読み込みをブロックすることはありません。Sync: JavaScriptが読み込まれ、実行されるまで、ページの読み込みが継続されません。
  1. JavaScript Insertion Paths の設定
JavaScript Insertion Paths で、 + Add Item をクリックします。
../../_images/js_insertion1.png
  • Name : 任意の名前を設定します。
  • Domain Matcher : Any Domain、またはDomain (ドメイン指定)を選択します。本ドキュメントではAny Domainを選択します。
  • Path : Prefix(PathのPrefix)、Path(Path名の完全一致)、Glob(“*”で複数文字にマッチし、?で一文字にマッチするよう記載可能)を選択します。本ドキュメントでは、Prefixを選択します。
  • Prefix : Path Prefixを記述します。

必要な事項を設定したら、Apply をクリックします。 例では、/prodcts/listの例を示していますが、+ Add Item をクリックして/products/detailのエントリも追加します。

必要な事項を設定したら、Apply をクリックします。

  1. Mobile Settings の設定
Activate Mobile SDKで、Mobile SDKを利用する場合は、Enable Mobile SDK、利用しない場合は、Disable Mobile SDKを選択します。本ドキュメントでは、Disable Mobile SDKを選択します。
  1. More Options につきまして
../../_images/more_options.png
  • Trusted Client Rules : Bot Defenseの処理をスキップさせたいクライアントがある場合はここで設定します。
  • Logs : Amazon CloudFront ConnectorのLambdaのログのログレベルを設定します。
  • Header Name For Continue Mitigation Action : Mitigation ActionをContitnueに設定し、Add Headerの設定をした場合のHeaderの名前
  • Timeout(ms) : Bot判定のタイムアウト
  • Body Sample Size Limit :　解析のために送信するリクエストボディのサイズの制限

必要な事項を設定したら、Apply をクリックします。 最後に、Save and Exit をクリックします。

  1. 設定を適用するためのconfigのjsonファイルとインストーラーのダウンロード
../../_images/download.png

次の章で説明するAmazon CloudFrontに設定を適用するためのConfigのjsonファイルとインストーラーをダウンロードします。

Configファイル名: <App Name>.json
Installerファイル名: f5tool