f5networks.f5_modules.bigip_asm_policy_signature_set 模块 – 管理 ASM 策略上的签名集

注意

此模块是 f5networks.f5_modules 集合（版本 1.32.1）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install f5networks.f5_modules。

要在 playbook 中使用它，请指定：f5networks.f5_modules.bigip_asm_policy_signature_set。

f5networks.f5_modules 1.0.0 中的新增功能

概要

• 管理 ASM 策略上的签名集。

参数

参数	注释
告警 布尔值	指定当请求与签名集中包含的签名匹配时，安全策略是否在“统计信息”屏幕中记录请求数据。 选择 false true
阻止 布尔值	当安全策略强制模式为“阻止”时有效。 确定系统如何处理与签名集中包含的签名匹配的请求。 当 true 时，系统会阻止所有与签名匹配的请求，并为客户端提供支持 ID 号。 当 false 时，系统会接受这些请求。 选择 false true
学习 布尔值	指定安全策略是否学习所有与签名集中包含的签名匹配的请求。 选择 false true
名称 字符串 / 必需	指定要应用到 ASM 策略或从 ASM 策略中删除的签名集的名称。 除了设备附带的内置签名集外，您还可以创建和使用自定义签名集。 当 所有 响应 签名 时，配置攻击签名池中可以审查响应的所有签名。 当 所有 签名 时，配置攻击签名池中的所有攻击签名。 当 Apache Struts 签名 时，配置针对 Apache Struts Web 服务器的攻击的签名。仅在 13.x 及更高版本中可用。 当 Apache Tomcat 签名 时，配置针对 Apache Tomcat Web 服务器的攻击的签名。仅在 13.x 及更高版本中可用。 当 Cisco 签名 时，配置针对 Cisco 系统的攻击的签名。仅在 13.x 及更高版本中可用。 当 命令 执行 签名 时，配置涉及通过执行命令进行的攻击的签名。 当 跨站 脚本 签名 时，配置针对跨站脚本技术引起的攻击的签名。 当 目录 索引 签名 时，配置针对浏览目录列表的攻击的签名。 当 通用 检测 签名 时，配置针对众所周知或常见的 Web 和应用程序攻击的签名。 当 HTTP 响应 拆分 签名 时，配置针对利用未经清理的响应的攻击的签名。 当 高 精度 检测 规避 签名 时，配置在识别规避攻击时具有高精度且产生少量误报的签名。仅在 13.x 及更高版本中可用。 当 高 精度 签名 时，配置在识别规避攻击时具有高精度且产生少量误报的签名。 当 IIS 和 Windows 签名 时，配置针对 Microsoft IIS 和基于 Windows 的系统的攻击的签名。仅在 13.x 及更高版本中可用。 当 信息 泄漏 签名 时，配置针对寻找系统数据或调试信息（显示系统易受攻击的位置）的攻击的签名。 当 Java Servlet/JSP 签名 时，配置针对基于 Java Servlet 和 Java Server Pages (JSP) 的应用程序的攻击的签名。仅在 13.x 及更高版本中可用。 当 低 精度 签名 时，配置在识别攻击时可能导致更多误报的签名。 当 中 精度 签名 时，配置在识别攻击时具有中等精度的签名。 当 操作系统 命令 注入 签名 时，配置针对尝试通过易受攻击的应用程序运行系统级命令的攻击的签名。 当 OWA 签名 时，配置针对 Microsoft Outlook Web Access (OWA) 应用程序的攻击的签名。 当 其他 应用程序 攻击 签名 时，配置针对各种攻击的签名，包括会话固定、本地文件访问、注入尝试、标头篡改等，这些攻击会影响许多应用程序。 当 路径 遍历 签名 时，配置针对尝试访问存储在 Web 根文件夹之外的文件和目录的攻击的签名。 当 Predictable Resource Location Signatures 时，配置旨在针对通过强制浏览或目录和文件枚举来试图揭示隐藏网站内容和功能的攻击的签名。 当 Remote File Include Signatures 时，配置旨在针对试图利用远程文件包含漏洞的攻击的签名，该漏洞可能使远程攻击者能够在托管应用程序的服务器上执行任意命令。 当 SQL Injection Signatures 时，配置旨在针对试图使用来自客户端的输入数据向应用程序插入（注入）SQL 查询的攻击的签名。 当 Server Side Code Injection Signatures 时，配置旨在针对服务器端的代码注入攻击的签名。 当 WebSphere signatures 时，配置旨在针对使用 WebSphere 集成的许多计算平台的攻击的签名，包括通用数据库、Microsoft Windows、IIS、Microsoft SQL Server、Apache、Oracle、Unix/Linux、IBM DB2、PostgreSQL 和 XML。 当 XPath Injection Signatures 时，配置旨在针对当网站使用用户提供的信息来构建 XML 数据的 XPath 查询时，试图访问数据结构或绕过权限的攻击的签名。
分区 字符串	此参数仅在标识 ASM 策略时使用。 默认值： "Common"
policy_name 字符串 / 必需	指定要添加或删除签名集的现有 ASM 策略的名称。
提供程序 字典 在 f5networks.f5_modules 1.0.0 中添加	一个包含连接详细信息的 dict 对象。
auth_provider 字符串	配置身份验证提供程序以从远程设备获取身份验证令牌。 此选项在与 BIG-IQ 设备一起工作时真正使用。
no_f5_teem 布尔值	如果为 yes，则不会将 TEEM 遥测数据发送到 F5。 您可以通过设置环境变量 F5_TELEMETRY_OFF 来省略此选项。 先前使用的变量 F5_TEEM 已弃用，因为其名称容易引起混淆。 选择 false ← （默认） true
密码 别名：pass, pwd 字符串 / 必需	用于连接到 BIG-IP 或 BIG-IQ 的用户帐户的密码。 您可以通过设置环境变量 F5_PASSWORD 来省略此选项。
服务器 字符串 / 必需	BIG-IP 主机或 BIG-IQ 主机。 您可以通过设置环境变量 F5_SERVER 来省略此选项。
server_port 整数	BIG-IP 服务器端口。 您可以通过设置环境变量 F5_SERVER_PORT 来省略此选项。 默认值： 443
超时 整数	指定与网络设备通信的超时时间（以秒为单位），用于连接或发送命令。如果操作完成前超时，模块将出错。
传输 字符串	配置连接到远程设备时使用的传输连接。 选择 "rest" ← （默认）
用户 字符串 / 必需	用于连接到 BIG-IP 或 BIG-IQ 的用户名。此用户必须具有设备上的管理权限。 您可以通过设置环境变量 F5_USER 来省略此选项。
validate_certs 布尔值	如果为 no，则不会验证 SSL 证书。仅在您个人控制的使用自签名证书的站点上使用此选项。 您可以通过设置环境变量 F5_VALIDATE_CERTS 来省略此选项。 选择 false true ← （默认）
状态 字符串	当为 present 时，确保资源存在。 当为 absent 时，确保资源被删除。 选择 "present" ← （默认） "absent"

备注

注意

• 此模块主要用作在 Ansible Galaxy ASM Policy Role 中配置 ASM 策略的组件。

• 有关使用 Ansible 管理 F5 Networks 设备的更多信息，请参阅 https://ansible.org.cn/integrations/networks/f5。

• 需要 BIG-IP 软件版本 >= 12。

• F5 模块仅操作 F5 产品的运行配置。为了确保 BIG-IP 的特定配置持久保存到磁盘，请务必包含至少一个使用 f5networks.f5_modules.bigip_config 模块来保存运行配置的任务。有关正确使用模块以保存运行配置的信息，请参阅模块的文档。

示例

- name: Add Signature Set to ASM Policy
  bigip_asm_policy_signature_set:
    name: IIS and Windows Signatures
    policy_name: FooPolicy
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Remove Signature Set to ASM Policy
  bigip_asm_policy_signature_set:
    name: IIS and Windows Signatures
    policy_name: FooPolicy
    state: absent
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

返回值

常见返回值记录在此处，以下是此模块特有的字段

键	描述
告警 布尔值	指定安全策略是否在“统计信息”屏幕中记录请求数据。 返回： changed 示例： true
阻止 布尔值	确定系统如何处理与签名集中包含的签名匹配的请求。 返回： changed 示例： false
学习 布尔值	指定策略是否学习与签名集中包含的签名匹配的所有请求。 返回： changed 示例： true
名称 字符串	在 ASM 策略上添加/删除的签名集的名称。 返回： changed 示例： "Cisco Signatures"
policy_name 字符串	ASM 策略的名称。 返回： changed 示例： "FooPolicy"

作者

• Wojciech Wypior (@wojtek0806)

集合链接

• 问题跟踪器
• 主页
• 存储库（来源）