f5networks.f5_modules.bigip_asm_policy_manage 模块 – 管理 BIG-IP ASM 策略

注意

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

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

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

要在剧本中使用它，请指定：f5networks.f5_modules.bigip_asm_policy_manage。

f5networks.f5_modules 1.0.0 中的新增功能

概要

• 管理 BIG-IP ASM 策略，从模板创建策略，并管理全局策略设置。

参数

参数	注释
active 布尔值	如果为 true，则应用并激活现有非活动策略。如果为 false，则停用现有活动策略。通常只有在要激活新的或现有策略的情况下才应为 true。 在 TMOS v14 及更高版本中，停用策略会导致策略与任何其他关联对象分离，因此为了防止意外解除关联，已删除了默认选项 false。 选择 false true
apply 布尔值 在 f5networks.f5_modules 1.4.0 中添加	如果为 true，则在策略有待处理的更改时应用该策略。 此参数在 TMOS v14.x 及更高版本上受支持。 选择 false true
name 字符串 / 必需	要管理或创建的 ASM 策略。
partition 字符串	在其上管理资源的设备分区。 默认值： "Common"
provider 字典 在 f5networks.f5_modules 1.0.0 中添加	包含连接详细信息的字典对象。
auth_provider 字符串	配置身份验证提供程序，以便从远程设备获取身份验证令牌。 此选项主要在处理 BIG-IQ 设备时使用。
no_f5_teem 布尔值	如果为 yes，则不会将 TEEM 遥测数据发送到 F5。 您可以通过设置环境变量 F5_TELEMETRY_OFF 来省略此选项。 先前使用的变量 F5_TEEM 已弃用，因为其名称令人困惑。 选择 false ←（默认） true
password 别名：pass, pwd 字符串 / 必需	用于连接到 BIG-IP 或 BIG-IQ 的用户帐户的密码。 您可以通过设置环境变量 F5_PASSWORD 来省略此选项。
server 字符串 / 必需	BIG-IP 主机或 BIG-IQ 主机。 您可以通过设置环境变量 F5_SERVER 来省略此选项。
server_port 整数	BIG-IP 服务器端口。 您可以通过设置环境变量 F5_SERVER_PORT 来省略此选项。 默认值： 443
timeout 整数	指定与网络设备进行通信（用于连接或发送命令）的超时时间（以秒为单位）。如果在操作完成之前超时，则模块将报错。
transport 字符串	配置连接到远程设备时要使用的传输连接。 选择 "rest" ←（默认）
user 字符串 / 必需	连接到 BIG-IP 或 BIG-IQ 的用户名。此用户必须在设备上具有管理权限。 您可以通过设置环境变量 F5_USER 来省略此选项。
validate_certs 布尔值	如果为 no，则不验证 SSL 证书。仅在个人控制的使用自签名证书的站点上使用此选项。 您可以通过设置环境变量 F5_VALIDATE_CERTS 来省略此选项。 选择 false true ←（默认）
state 字符串	当 state 为 present 并且提供了 template 参数时，将使用给定的策略 name 从模板创建新的 ASM 策略。 当 state 为 present 并且未提供 template 参数时，将使用给定的策略 name 创建新的空白 ASM 策略。 当 state 为 absent 时，确保删除该策略，即使它当前处于活动状态。 选择 "present" ←（默认） "absent"
template 字符串	一个内置的 ASM 策略模板。如果该模板不存在，则会引发错误。 创建策略后，此值将无法更改。 Comprehensive、Drupal、Fundamental、Joomla、Vulnerability Assessment Baseline 和 Wordpress 模板仅在 BIG-IP 版本 >= 13 上可用。 选择 "ActiveSync v1.0 v2.0 (http)" "ActiveSync v1.0 v2.0 (https)" "Comprehensive" "Drupal" "Fundamental" "Joomla" "LotusDomino 6.5 (http)" "LotusDomino 6.5 (https)" "OWA Exchange 2003 (http)" "OWA Exchange 2003 (https)" "OWA Exchange 2003 with ActiveSync (http)" "OWA Exchange 2003 with ActiveSync (https)" "OWA Exchange 2007 (http)" "OWA Exchange 2007 (https)" "OWA Exchange 2007 with ActiveSync (http)" "OWA Exchange 2007 with ActiveSync (https)" "OWA Exchange 2010 (http)" "OWA Exchange 2010 (https)" "Oracle 10g Portal (http)" "Oracle 10g Portal (https)" "Oracle Applications 11i (http)" "Oracle Applications 11i (https)" "PeopleSoft Portal 9 (http)" "PeopleSoft Portal 9 (https)" "Rapid Deployment Policy" "SAP NetWeaver 7 (http)" "SAP NetWeaver 7 (https)" "SharePoint 2003 (http)" "SharePoint 2003 (https)" "SharePoint 2007 (http)" "SharePoint 2007 (https)" "SharePoint 2010 (http)" "SharePoint 2010 (https)" "Vulnerability Assessment Baseline" "Wordpress"

说明

注意

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

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

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

示例

- name: Create ASM policy from template
  bigip_asm_policy:
    name: new_sharepoint_policy
    template: SharePoint 2007 (http)
    state: present
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Create blank ASM policy
  bigip_asm_policy:
    name: new_blank_policy
    state: present
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Create blank ASM policy and activate
  bigip_asm_policy_manage:
    name: new_blank_policy
    active: true
    state: present
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Activate ASM policy
  bigip_asm_policy_manage:
    name: inactive_policy
    active: true
    state: present
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Deactivate ASM policy
  bigip_asm_policy_manage:
    name: active_policy
    state: present
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

返回值

通用返回值记录在此处，以下是此模块独有的字段

键	描述
active 布尔值	在激活/停用 ASM 策略时设置。 返回: 已更改 示例: true
apply 布尔值	在将待处理的更改应用于 ASM 策略时设置。 返回: 当目标策略有待处理的更改时，返回已更改 示例: true
name 字符串	要管理/创建的 ASM 策略的名称。 返回: 已更改 示例: "Asm_APP1_Transparent"
state 字符串	在目标设备上执行的操作。 返回: 已更改 示例: "absent"
template 字符串	内置 ASM 策略模板的名称。 返回: 已更改 示例: "OWA Exchange 2007 (https)"

作者

• Wojciech Wypior (@wojtek0806)

集合链接

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