使用智能威胁 JavaScript API - AWS WAF、AWS Firewall Manager 和 AWS Shield Advanced

使用智能威胁 JavaScript API

本节提供了如何在客户端应用程序中使用智能威胁 JavaScript API 的说明。

智能威胁 API 提供了针对用户的浏览器运行静默质询的操作，以及处理提供成功质询证明和验证码响应的 AWS WAF 令牌的操作。

首先在测试环境中实施 JavaScript 集成，然后在生产环境中实施。有关其他编码指导，请参阅以下各节。

使用智能威胁 API

  1. 安装 API

    如果您使用验证码 API，可以跳过此步骤。当您安装验证码 API时，脚本会自动安装智能威胁 API。

    1. 登录 AWS Management Console，然后打开 AWS WAF 控制台，网址为：https://console.aws.amazon.com/wafv2/。

    2. 在导航窗格中，选择 应用程序集成。在应用程序集成页面上，您可以看到选项卡式选项。

    3. 选择智能威胁集成

    4. 在该选项卡中，选择要与之集成的Web ACL。Web ACL 列表仅包括使用 AWSManagedRulesACFPRuleSet 托管规则组、AWSManagedRulesATPRuleSet 托管规则组或 AWSManagedRulesBotControlRuleSet 托管规则组的目标保护级别的 Web ACL。

    5. 打开 JavaScript 软件开发工具包窗格，然后复制脚本标签以便在集成中使用。

    6. 在应用程序页面代码的 <head> 部分中，插入您为 Web ACL 复制的脚本标记。此包含会使您的客户端应用程序在页面加载时自动在后台检索令牌。

      <head>
    <script type="text/javascript" src="Web ACL integration URL/challenge.js” defer></script>
<head>

      此 <script> 列表使用 defer 属性进行配置，但如果您想让页面有不同的行为，则可以将设置更改为 async。

  2. （可选）为客户端的令牌添加域配置 – 默认情况下，在 AWS WAF 创建令牌时，它使用与 Web ACL 关联的资源的主机域。要为 JavaScript API 提供其他域名，请按照 提供用于令牌的域名 中的指导进行操作。

  3. 对智能威胁集成进行编码 – 编写代码以确保在客户端向受保护的端点发送请求之前完成令牌检索。如果您已经在使用 fetch API 进行调用，则可以替换 AWS WAF 集成 fetch 封装器。如果您不使用 fetch API，则可以改用 AWS WAF 集成 getToken 操作。有关编码指导，请参阅以下部分。

  4. 在您的 Web ACL 中添加令牌验证 – 在您的 Web ACL 中添加至少一条规则，用于检查您的客户端发送的 Web 请求中是否存在有效的质询令牌。您可以使用规则组来检查和监控质询令牌，例如机器人控制功能托管规则组的目标级别，也可以使用 Challenge 规则操作进行检查，如 在 AWS WAF 中使用 CAPTCHA 和 Challenge 中所述。

    新增的 Web ACL 可验证对受保护端点的请求是否包含您在客户端集成中获取的令牌。包含有效、未过期令牌的请求将通过 Challenge 检查，并且不会向您的客户发送另一个静默质询。

  5. （可选）阻止缺少令牌的请求 – 如果您将 API 与 ACFP 托管规则组、ATP 托管规则组或机器人控制功能规则组的目标规则一起使用，则这些规则不会阻止缺少令牌的请求。要阻止缺少令牌的请求，请按照 阻止没有有效 AWS WAF 令牌的请求 中的指导进行操作。

主题