fortinet.fortios.fortios_firewall_profile_group 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置配置文件组。

注意

此模块是 fortinet.fortios 集合 (版本 2.3.8) 的一部分。

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

要安装它，请使用：ansible-galaxy collection install fortinet.fortios。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在剧本中使用它，请指定：fortinet.fortios.fortios_firewall_profile_group。

fortinet.fortios 2.0.0 中的新增功能

概要

  • 此模块能够通过允许用户设置和修改防火墙功能和 profile_group 类别来配置 FortiGate 或 FortiOS (FOS) 设备。示例包括所有参数，在使用前需要将值调整为数据源。已在 FOS v6.0.0 上测试。

要求

执行此模块的主机需要以下要求。

  • ansible>=2.15

参数

参数

注释

access_token

字符串

基于令牌的身份验证。从 Fortigate 的 GUI 生成。

enable_log

布尔值

启用/禁用任务的日志记录。

选项

  • false ← (默认)

  • true

firewall_profile_group

字典

配置配置文件组。

application_list

字符串

现有应用程序列表的名称。来源 application.list.name。

av_profile

字符串

现有防病毒配置文件的名称。来源 antivirus.profile.name。

casb_profile

字符串

现有 CASB 配置文件的名称。来源 casb.profile.name。

cifs_profile

字符串

现有 CIFS 配置文件的名称。来源 cifs.profile.name。

diameter_filter_profile

字符串

现有 Diameter 过滤器配置文件的名称。来源 diameter-filter.profile.name。

dlp_profile

字符串

现有 DLP 配置文件的名称。来源 dlp.profile.name。

dlp_sensor

字符串

现有 DLP 传感器的名称。来源 dlp.sensor.name。

dnsfilter_profile

字符串

现有 DNS 过滤器配置文件的名称。来源 dnsfilter.profile.name。

emailfilter_profile

字符串

现有电子邮件过滤器配置文件的名称。来源 emailfilter.profile.name。

file_filter_profile

字符串

现有文件过滤器配置文件的名称。来源 file-filter.profile.name。

icap_profile

字符串

现有 ICAP 配置文件的名称。来源 icap.profile.name。

ips_sensor

字符串

现有 IPS 传感器的名称。来源 ips.sensor.name。

ips_voip_filter

字符串

现有 VoIP (ips) 配置文件的名称。来源 voip.profile.name。

mms_profile

字符串

现有 MMS 配置文件的名称。来源 firewall.mms-profile.name。

name

字符串 / 必需

配置文件组名称。

profile_protocol_options

字符串

现有协议选项配置文件的名称。来源 firewall.profile-protocol-options.name。

sctp_filter_profile

字符串

现有 SCTP 过滤器配置文件的名称。来源 sctp-filter.profile.name。

spamfilter_profile

字符串

现有垃圾邮件过滤器配置文件的名称。来源 spamfilter.profile.name。

ssh_filter_profile

字符串

现有 SSH 过滤器配置文件的名称。来源 ssh-filter.profile.name。

ssl_ssh_profile

字符串

现有 SSL SSH 配置文件的名称。来源 firewall.ssl-ssh-profile.name。

videofilter_profile

字符串

现有 VideoFilter 配置文件的名称。来源 videofilter.profile.name。

virtual_patch_profile

字符串

现有虚拟补丁配置文件的名称。来源 virtual-patch.profile.name。

voip_profile

字符串

现有 VoIP (voipd) 配置文件的名称。来源 voip.profile.name。

waf_profile

字符串

现有 Web 应用防火墙配置文件的名称。来源 waf.profile.name。

webfilter_profile

字符串

现有 Web 过滤器配置文件的名称。来源 webfilter.profile.name。

member_path

字符串

要操作的成员属性路径。

如果有多个属性，则用斜杠字符分隔。

标有 member_path 的参数对于执行成员操作是合法的。

member_state

字符串

在指定的属性路径下添加或删除成员。

当指定 member_state 时，将忽略 state 选项。

选项

  • "present"

  • "absent"

state

字符串 / 必需

指示是创建还是删除对象。

选项

  • "present"

  • "absent"

vdom

字符串

虚拟域，在先前定义的虚拟域中。vdom 是 FortiGate 的虚拟实例，可以将其配置并用作不同的单元。

默认值： "root"

注释

注意

  • 旧版 fortiosapi 已弃用，httpapi 是运行剧本的首选方法。

  • 该模块支持 check_mode。

示例

- name: Configure profile groups.
  fortinet.fortios.fortios_firewall_profile_group:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      firewall_profile_group:
          application_list: "<your_own_value> (source application.list.name)"
          av_profile: "<your_own_value> (source antivirus.profile.name)"
          casb_profile: "<your_own_value> (source casb.profile.name)"
          cifs_profile: "<your_own_value> (source cifs.profile.name)"
          diameter_filter_profile: "<your_own_value> (source diameter-filter.profile.name)"
          dlp_profile: "<your_own_value> (source dlp.profile.name)"
          dlp_sensor: "<your_own_value> (source dlp.sensor.name)"
          dnsfilter_profile: "<your_own_value> (source dnsfilter.profile.name)"
          emailfilter_profile: "<your_own_value> (source emailfilter.profile.name)"
          file_filter_profile: "<your_own_value> (source file-filter.profile.name)"
          icap_profile: "<your_own_value> (source icap.profile.name)"
          ips_sensor: "<your_own_value> (source ips.sensor.name)"
          ips_voip_filter: "<your_own_value> (source voip.profile.name)"
          mms_profile: "<your_own_value> (source firewall.mms-profile.name)"
          name: "default_name_17"
          profile_protocol_options: "<your_own_value> (source firewall.profile-protocol-options.name)"
          sctp_filter_profile: "<your_own_value> (source sctp-filter.profile.name)"
          spamfilter_profile: "<your_own_value> (source spamfilter.profile.name)"
          ssh_filter_profile: "<your_own_value> (source ssh-filter.profile.name)"
          ssl_ssh_profile: "<your_own_value> (source firewall.ssl-ssh-profile.name)"
          videofilter_profile: "<your_own_value> (source videofilter.profile.name)"
          virtual_patch_profile: "<your_own_value> (source virtual-patch.profile.name)"
          voip_profile: "<your_own_value> (source voip.profile.name)"
          waf_profile: "<your_own_value> (source waf.profile.name)"
          webfilter_profile: "<your_own_value> (source webfilter.profile.name)"

返回值

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

键

描述

build

字符串

Fortigate 镜像的构建编号

返回：始终

示例： "1547"

http_method

字符串

最后用于将内容配置到 FortiGate 的方法

返回：始终

示例： "PUT"

http_status

字符串

FortiGate 在最后一次操作中给出的结果

返回：始终

示例： "200"

mkey

字符串

最后一次调用 FortiGate 时使用的主密钥 (ID)

返回： 成功

示例： "id"

name

字符串

用于完成请求的表名

返回：始终

示例： "urlfilter"

path

字符串

用于完成请求的表路径

返回：始终

示例： "webfilter"

revision

字符串

内部版本号

返回：始终

示例： "17.0.2.10658"

serial

字符串

设备的序列号

返回：始终

示例： "FGVMEVYYQT3AB5352"

status

字符串

操作结果指示

返回：始终

示例： "success"

vdom

字符串

使用的虚拟域

返回：始终

示例： "root"

version

字符串

FortiGate 的版本

返回：始终

示例： "v5.6.3"

作者

  • 郑琳 (@chillancezen)

  • 薛杰 (@JieX19)

  • 卢洪斌 (@fgtdev-hblu)

  • 沈方 (@frankshen01)

  • Miguel Angel Munoz (@mamunozgonzalez)

  • Nicolas Thomas (@thomnico)