fortinet.fortios.fortios_firewall_local_in_policy 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置用户定义的 IPv4 本地入站策略。

注意

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

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

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

要在 playbook 中使用它，请指定：fortinet.fortios.fortios_firewall_local_in_policy。

fortinet.fortios 2.0.0 中的新增功能

概要 

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

要求 

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

ansible>=2.15

参数 

参数	注释
access_token 字符串	基于令牌的身份验证。从 Fortigate 的 GUI 生成。
enable_log 布尔值	启用/禁用任务的日志记录。选项 `false` ←（默认） `true`
firewall_local_in_policy 字典	配置用户定义的 IPv4 本地入站策略。
action 字符串	对匹配策略的流量执行的操作。选项 `"accept"` `"deny"`
comments 字符串	评论。
dstaddr 列表 / elements=字典	来自可用选项的目标地址对象。
name 字符串 / 必需	地址名称。源 firewall.address.name firewall.addrgrp.name system.external-resource.name。
dstaddr_negate 字符串	启用后，dstaddr 指定目标地址不能是什么。选项 `"enable"` `"disable"`
ha_mgmt_intf_only 字符串	启用/禁用仅将 HA 管理接口专用于本地入站策略。选项 `"enable"` `"disable"`
internet_service_src 字符串	启用/禁用在此本地入站策略的源中使用 Internet 服务。如果启用，则不使用源地址。选项 `"enable"` `"disable"`
internet_service_src_custom 列表 / elements=字典	自定义 Internet 服务源名称。
name 字符串 / 必需	自定义 Internet 服务名称。源 firewall.internet-service-custom.name。
internet_service_src_custom_group 列表 / elements=字典	自定义 Internet 服务源组名称。
name 字符串 / 必需	自定义 Internet 服务组名称。源 firewall.internet-service-custom-group.name。
internet_service_src_group 列表 / elements=字典	Internet 服务源组名称。
name 字符串 / 必需	Internet 服务组名称。源 firewall.internet-service-group.name。
internet_service_src_name 列表 / elements=字典	Internet 服务源名称。
name 字符串 / 必需	Internet 服务名称。源 firewall.internet-service-name.name。
internet_service_src_negate 字符串	启用后，internet-service-src 指定服务不能是什么。选项 `"enable"` `"disable"`
intf 字符串	来自可用选项的传入接口名称。源 system.zone.name system.interface.name。
intf_dict 列表 / elements=字典	来自可用选项的传入接口名称。
name 字符串 / 必需	地址名称。源 system.zone.name system.interface.name。
logtraffic 字符串	启用/禁用本地入站流量日志记录。选项 `"enable"` `"disable"`
policyid 整数 / 必需	用户定义的本地入站策略 ID。请参阅 <a href=’#notes’>备注</a>。
schedule 字符串	来自可用选项的计划对象。源 firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group .name。
service 列表 / elements=字典	来自可用选项的服务对象。
name 字符串 / 必需	服务名称。源 firewall.service.custom.name firewall.service.group.name。
service_negate 字符串	启用后，service 指定服务不能是什么。选项 `"enable"` `"disable"`
srcaddr 列表 / elements=字典	来自可用选项的源地址对象。
name 字符串 / 必需	地址名称。源 firewall.address.name firewall.addrgrp.name system.external-resource.name。
srcaddr_negate 字符串	启用后，srcaddr 指定源地址不能是什么。选项 `"enable"` `"disable"`
status 字符串	启用/禁用此本地入站策略。选项 `"enable"` `"disable"`
uuid 字符串	通用唯一标识符 (UUID；自动分配，但可以手动重置)。
virtual_patch 字符串	启用/禁用虚拟补丁。选项 `"enable"` `"disable"`
member_path 字符串	要操作的成员属性路径。如果存在多个属性，则用斜杠字符分隔。标记为 member_path 的参数对于执行成员操作是合法的。
member_state 字符串	在指定属性路径下添加或删除成员。指定 member_state 时，将忽略 state 选项。选项 `"present"` `"absent"`
state 字符串 / 必需	指示是创建还是删除对象。选项 `"present"` `"absent"`
vdom 字符串	虚拟域，在先前定义的那些域中。vdom 是 FortiGate 的虚拟实例，可以配置并用作不同的单元。默认值： `"root"`

备注 

注意

我们强烈建议您使用自己的值作为 policyid，而不是 0，而“0”是一个特殊的占位符，允许后端为对象分配最新的可用编号，但它确实有局限性。请在问答中找到更多详细信息。
旧版 fortiosapi 已被弃用，httpapi 是运行 playbook 的首选方式
该模块支持 check_mode。

示例 

- name: Configure user defined IPv4 local-in policies.
  fortinet.fortios.fortios_firewall_local_in_policy:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      firewall_local_in_policy:
          action: "accept"
          comments: "<your_own_value>"
          dstaddr:
              -
                  name: "default_name_6 (source firewall.address.name firewall.addrgrp.name system.external-resource.name)"
          dstaddr_negate: "enable"
          ha_mgmt_intf_only: "enable"
          internet_service_src: "enable"
          internet_service_src_custom:
              -
                  name: "default_name_11 (source firewall.internet-service-custom.name)"
          internet_service_src_custom_group:
              -
                  name: "default_name_13 (source firewall.internet-service-custom-group.name)"
          internet_service_src_group:
              -
                  name: "default_name_15 (source firewall.internet-service-group.name)"
          internet_service_src_name:
              -
                  name: "default_name_17 (source firewall.internet-service-name.name)"
          internet_service_src_negate: "enable"
          intf: "<your_own_value> (source system.zone.name system.interface.name)"
          intf_dict:
              -
                  name: "default_name_21 (source system.zone.name system.interface.name)"
          logtraffic: "enable"
          policyid: "<you_own_value>"
          schedule: "<your_own_value> (source firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group.name)"
          service:
              -
                  name: "default_name_26 (source firewall.service.custom.name firewall.service.group.name)"
          service_negate: "enable"
          srcaddr:
              -
                  name: "default_name_29 (source firewall.address.name firewall.addrgrp.name system.external-resource.name)"
          srcaddr_negate: "enable"
          status: "enable"
          uuid: "<your_own_value>"
          virtual_patch: "enable"

返回值 

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

键	描述
构建字符串	Fortigate 镜像的构建编号返回：总是示例： `"1547"`
http_method 字符串	上次用于将内容配置到 FortiGate 的方法返回：总是示例： `"PUT"`
http_status 字符串	上次应用操作时 FortiGate 给出的最后结果返回：总是示例： `"200"`
mkey 字符串	上次调用 FortiGate 时使用的主键 (id) 返回：成功示例： `"id"`
name 字符串	用于满足请求的表名返回：总是示例： `"urlfilter"`
路径字符串	用于满足请求的表的路径返回：总是示例： `"webfilter"`
修订字符串	内部修订号返回：总是示例： `"17.0.2.10658"`
序列号字符串	设备的序列号返回：总是示例： `"FGVMEVYYQT3AB5352"`
status 字符串	操作结果的指示返回：总是示例： `"success"`
vdom 字符串	使用的虚拟域返回：总是示例： `"root"`
版本字符串	FortiGate 的版本返回：总是示例： `"v5.6.3"`

作者

Link Zheng (@chillancezen)
Jie Xue (@JieX19)
Hongbin Lu (@fgtdev-hblu)
Frank Shen (@frankshen01)
Miguel Angel Munoz (@mamunozgonzalez)
Nicolas Thomas (@thomnico)