**の新しいコンソールエクスペリエンスの紹介 AWS WAF**

更新されたエクスペリエンスを使用して、コンソールの任意の場所で AWS WAF 機能にアクセスできるようになりました。詳細については、[「コンソールの使用](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-console.html)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS WAF モバイル SDK の仕組み
<a name="waf-mobile-sdk-how-it-works"></a>

このセクションでは、 AWS WAF モバイル SDK クラス、プロパティ、およびオペレーションがどのように連携するかについて説明します。

モバイル SDK は、トークンの取得と利用のために使用できる設定可能なトークンプロバイダーを提供します。トークンプロバイダーは、許可するリクエストが正規の顧客からのものであることを検証します。保護するリソースに AWS リクエストを送信するときは AWS WAF、Cookie にトークンを含めてリクエストを検証します。トークン cookie は手動で処理することも、トークンプロバイダーに処理させることもできます。

このセクションでは、モバイル SDK に含まれるクラス、プロパティ、およびメソッド間のインタラクションについて説明します。SDK の仕様については、「[AWS WAF モバイル SDK 仕様](waf-mobile-sdk-specification.md)」を参照してください。

## トークンの取得とキャッシュ
<a name="waf-mobile-sdk-how-token-basics"></a>

モバイルアプリケーションでトークンプロバイダーインスタンスを作成するときに、トークンとトークンの取得を管理する方法を設定します。主に、アプリケーションのウェブリクエストで使用するための、有効で期限切れになっていないトークンを維持する方法を選択できます。
+ **[Background refresh enabled]** (バックグラウンド更新が有効) - これがデフォルトのトランスコードプリセットです。トークンプロバイダーは、バックグラウンドでトークンを自動的に更新し、キャッシュします。バックグラウンド更新が有効になっている場合、`getToken()` を呼び出すと、オペレーションはキャッシュされたトークンを取得します。

  トークンプロバイダーは、設定可能な間隔でトークンの更新を実行します。これにより、アプリケーションがアクティブな間、期限切れでないトークンは常にキャッシュ内で利用可能な状態となります。アプリケーションが非アクティブ状態の間、バックグラウンドの更新が一時停止されます。詳細については、「[アプリケーションが非アクティブ状態になった後のトークンの取得](#waf-mobile-sdk-how-back-from-inactive)」を参照してください。
+ **[Background refresh disabled]** (バックグラウンド更新が無効) - バックグラウンドトークンの更新を無効にして、オンデマンドでのみトークンを取得できます。オンデマンドで取得されたトークンはキャッシュされません。また、必要に応じて複数のトークンを取得できます。各トークンは、取得する他のトークンとは独立しており、有効期限を計算するために使用される独自のタイムスタンプを備えています。

  バックグラウンド更新が無効になっている場合のトークンの取得には、次の選択肢があります。
  + **`getToken()`** – バックグラウンド更新を無効に`getToken()`して を呼び出すと、呼び出しは同期的に新しいトークンを取得します AWS WAF。これは、メインスレッドで呼び出すと、アプリケーションの応答性に影響する可能性のあるブロッキング呼び出しである場合があります。
  + **`onTokenReady(WAFTokenResultCallback)`** - この呼び出しは、新しいトークンを非同期的に取得し、トークンの準備ができたときに提供された結果コールバックをバックグラウンドスレッドで呼び出します。

### トークンプロバイダーが失敗したトークンの取得を再試行する方法
<a name="waf-mobile-sdk-how-token-retrieval-retries"></a>

トークンプロバイダーは、取得に失敗したときにトークンの取得を自動的に再試行します。再試行は、開始の再試行の待ち時間が 100 ミリ秒のエクスポネンシャルバックオフを使用して最初に実行されます。エクスポネンシャル再試行の詳細については、「[AWSでのエラー再試行とエクスポネンシャルバックオフ](https://docs.aws.amazon.com/general/latest/gr/api-retries.html)」を参照してください。

再試行回数が設定された `maxRetryCount` に達すると、トークンプロバイダーは、トークン取得のタイプに応じて、試行を停止するか、`maxErrorTokenRefreshDelayMsec` ミリ秒ごとの試行に切り替えます。
+ **`onTokenReady()`** – トークンプロバイダーは、試行間の待機時間を `maxErrorTokenRefreshDelayMsec` ミリ秒に切り替えて、トークン取得の試行を続行します。
+ **バックグラウンド更新** – トークンプロバイダーは、試行間の待機時間を `maxErrorTokenRefreshDelayMsec` ミリ秒に切り替えて、トークンの取得の試行を続行します。
+ **バックグラウンド更新が無効になっている場合のオンデマンド `getToken()` 呼び出し** – トークンプロバイダーはトークンの取得の試行を停止し、前のトークン値を返します。前のトークンがない場合は null 値を返します。

## トークン取得の再試行シナリオ
<a name="waf-mobile-sdk-how-token-retrieval-retry-scenarios"></a>

トークンプロバイダーがトークンを取得しようとすると、トークンの取得フローのどこでトークンの取得が失敗するかに応じて、自動再試行が発生する可能性があります。このセクションでは、自動再試行が表示される可能性のある場所を一覧表示します。
+ **/inputs または /verify による AWS WAF チャレンジの取得または検証:**
  +  AWS WAF チャレンジを取得して検証するリクエストが行われて失敗すると、自動再試行が発生する可能性があります。
  + ここで自動再試行が `socketTimeoutException` エラーとともに発生することがあります。これには、次のような複数の原因が考えられます。
    + 低ネットワーク帯域幅: ネットワーク接続設定を確認する
    + ミューテーションされたアプリケーション統合 URL: AWS WAF コンソールに表示される内容から統合 URL が変更されていないことを確認します。
  + 自動再試行カウントは、`maxRetryCount()` 関数で設定できます
+ **トークンの更新:**
  + トークンハンドラーを介してトークンの更新リクエストが行われると、自動再試行が発生する可能性があります。
  + ここでの自動再試行数は、`maxRetryCount()` 関数で設定できます。

自動再試行のない設定は、`maxRetryCount(0)` を設定することで可能です。

## トークンイミュニティ時間とバックグラウンド更新
<a name="waf-mobile-sdk-how-token-immunity"></a>

ウェブ ACL で設定したトークンイミュニティ時間は、 AWS WAF モバイル SDK で設定したトークン更新間隔とは無関係です。バックグラウンド更新を有効にすると、SDK は `tokenRefreshDelaySec()` を使用して指定した間隔でトークンを更新します。これにより、設定されたイミュニティ時間に応じて、複数の有効なトークンが同時に存在する可能性があります。

複数の有効なトークンを防ぐには、バックグラウンド更新を無効にし、`getToken()` 関数を使用してモバイルアプリでトークンのライフサイクルを管理できます。

## アプリケーションが非アクティブ状態になった後のトークンの取得
<a name="waf-mobile-sdk-how-back-from-inactive"></a>

バックグラウンド更新は、アプリケーションがアプリケーションタイプについてアクティブであるとみなされる場合にのみ実行されます。
+ **iOS** – バックグラウンド更新は、アプリケーションがフォアグラウンドにあるときに実行されます。
+ **Android** - バックグラウンドの更新は、アプリケーションがフォアグラウンドまたはバックグラウンドのいずれにあるかにかかわらず、アプリケーションが閉じられていないときに実行されます。

アプリケーションが設定された `tokenRefreshDelaySec` 秒より長くバックグラウンド更新をサポートしない状態のままである場合、トークンプロバイダーはバックグラウンド更新を一時停止します。例えば、iOS アプリケーションの場合、`tokenRefreshDelaySec` が 300 で、300 秒以を超える時間にわたって、アプリケーションが閉じられていたり、バックグラウンド状態になっていたりすると、トークンプロバイダーはトークンの更新を停止します。アプリケーションがアクティブな状態に戻ると、トークンプロバイダーは自動的にバックグラウンド更新を再開します。

アプリケーションがアクティブ状態に戻ったら、トークンプロバイダーが新しいトークンを取得してキャッシュしたときに通知を受け取ることができるように `onTokenReady()` を呼び出します。キャッシュには最新の有効なトークンがまだ含まれていない可能性があるため、単に `getToken()` を呼び出さないでください。

## アプリケーション統合 URL
<a name="waf-mobile-sdk-application-integration-url"></a>

 AWS WAF モバイル SDK アプリケーション統合 URL は、アプリケーション統合を有効にしたウェブ ACL を指します。この URL は、リクエストを正しいバックエンドサーバーにルーティングし、顧客に関連付けます。ハードセキュリティコントロールとして機能しないため、統合 URL を公開してもセキュリティリスクは生じません。

提供された統合 URL を技術的に変更しても、トークンを取得できます。ただし、チャレンジ解決率の可視性が失われたり、`socketTimeoutException` エラーによるトークンの取得の失敗が発生する可能性があるため、これはお勧めしません。

## 依存関係
<a name="waf-mobile-sdk-dependencies"></a>

ダウンロード可能な各 AWS WAF モバイル SDK には、SDK の特定バージョンの依存関係を一覧表示する README ファイルが含まれています。お使いのバージョンのモバイル SDK の依存関係については、README を参照してください。

## 難読化/ProGuard (Android SDK のみ)
<a name="waf-mobile-sdk-obfuscation"></a>

ProGuard などの難読化または最小化製品を使用する場合は、モバイル SDK が正しく動作するように特定の名前空間を除外する必要がある場合があります。お使いのバージョンのモバイル SDK の README をチェックして、名前空間と除外ルールのリストを見つけます。