AWS WAF 移动设备SDK规格

检索 WAFToken 的 String 表示形式。

如果启用了后台刷新，则会返回缓存的令牌。如果禁用了后台刷新，则会同步阻塞调用 AWS WAF 以检索新令牌。

指示令牌提供程序刷新令牌并在活动令牌准备就绪时调用提供的回调。当令牌被缓存并准备就绪时，令牌提供程序将在后台线程中调用您的回调。在应用程序首次加载和恢复活动状态时调用此函数。有关返回活动状态的更多信息，请参阅 在应用程序处于非活动状态后检索令牌。

对于 Android 或 iOS 应用程序，您可以设置 WAFTokenResultCallback 为希望令牌提供程序在请求的令牌准备就绪时调用的操作。您的 WAFTokenResultCallback 实施必须采用参数 WAFToken，SdkError。对于 iOS 应用程序，您可以交替创建内联函数。

指示存储WAFTokenProvider指定的 AWS WAF token 进入SDK的 cookie 管理器。默认情况下，只有在首次获取令牌和刷新令牌时，才会将其添加到 Cookie 存储中。如果应用程序出于任何原因清除共享 Cookie 存储，则SDK不会自动添加 AWS WAF 令牌返回，直到下次刷新。

应用程序集成URL。从那里得到这个 AWS WAF 控制台或通过getWebACLAPI呼叫。

必需：是

类型：特定于应用程序。URL对于 iOS，请参阅 iOS URL。对于安卓系统，请参阅 java.net。URL

表示您是否希望令牌提供程序在后台刷新令牌。如果您设置了此选项，则令牌提供程序会根据管理自动令牌刷新活动的配置设置在后台刷新您的令牌。

必需：否

类型：Boolean

默认值：TRUE

要在令牌中使用的域名，用于令牌获取和 Cookie 存储。例如，example.com 或 aws.amazon.com。这通常是您与网络关联的资源的主机域ACL，您将在其中发送网络请求。对于ACFP托管规则组AWSManagedRulesACFPRuleSet，这通常是一个与您在规则组配置中提供的账户创建路径中的域相匹配的单个域。对于ATP托管规则组AWSManagedRulesATPRuleSet，这通常是一个与您在规则组配置中提供的登录路径中的域相匹配的单个域。

不允许使用公共后缀。例如，您不能使用 gov.au 或 co.uk 作为令牌域。

域名必须是 AWS WAF 将根据受保护的主机域和 Web ACL 的令牌域列表接受。有关更多信息，请参阅 AWS WAF Web ACL 令牌域列表配置。

必需：是

类型：String

尝试失败后，重复令牌刷新之前等待的最长时间（以毫秒为单位）。此值在令牌检索失败且重试 maxRetryCount 次后使用。

必需：否

类型：Integer

默认值：5000（5 秒）

允许的最小值：1（1 毫秒）

允许的最大值：30000（30 秒）

请求令牌时使用指数回退执行的最大重试次数。

必需：否

类型：Integer

默认值：如果启用了背景刷新，则为 5。否则为 3。

允许的最小值：0

允许的最大值：10

表示您是否希望SDK的 cookie 管理器在您的请求中添加令牌 Cookie。默认情况下，这会向所有请求添加一个令牌 Cookie。Cookie 管理器会向任何路径在 tokenCookiePath 中指定的路径之下的请求添加令牌 Cookie。

必需：否

类型：Boolean

默认值：TRUE

当 setTokenCookie 是 TRUE 时使用。表示您希望的 Cookie 管理器在其中添加令牌 cookie 的顶级路径。SDK管理员会将令牌 Cookie 添加到您发送到该路径的所有请求以及所有子路径中。

例如，如果您将其设置为 /web/login，则管理器将包含发送到 /web/login 的所有内容及其任何子路径的令牌 Cookie，例如 /web/login/help。它不包括发送到其他路径的请求的令牌，例如 /、/web 或 /web/order。

必需：否

类型：String

默认值：/

用于背景刷新。后台令牌刷新之间的最长时间（以秒为单位）。

必需：否

类型：Integer

默认值：88

允许的最小值：88

允许的最大值：300（5 分钟）