fortinet.fortimanager.fmgr_pkg_firewall_securitypolicy 模块 – 配置 NGFW IPv4/IPv6 应用策略。
注意
此模块是 fortinet.fortimanager 集合 (版本 2.8.2) 的一部分。
如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install fortinet.fortimanager。
要在剧本中使用它，请指定： fortinet.fortimanager.fmgr_pkg_firewall_securitypolicy。
fortinet.fortimanager 2.1.0 中的新增功能
概要
此模块能够配置 FortiManager 设备。
示例包含所有参数和值，在使用前需要根据数据源进行调整。
参数
参数 |
注释 |
|---|---|
无需使用用户名和密码即可访问 FortiManager 的令牌。 |
|
请求 URL 中的参数 (adom)。 |
|
仅当模块模式与 FortiManager API 结构不同时才设置为 True，模块将继续执行而无需验证参数。 选项
|
|
启用/禁用任务日志记录。 选项
|
|
使用 FortiCloud API 访问令牌验证 Ansible 客户端。 |
|
请求 URL 中的参数 (pkg)。 |
|
设置的顶级参数。 |
|
分配的策略块。 |
|
策略操作 选项
|
|
(列表或字符串) 应用类别 ID 列表。 |
|
(列表或字符串) 应用组名称。 |
|
(列表) 应用 ID 列表。 |
|
现有应用列表的名称。 |
|
现有杀毒软件配置文件的名称。 |
|
现有 CASB 配置文件的名称。 |
|
现有 CIFS 配置文件的名称。 |
|
注释。 |
|
现有 Diameter 过滤配置文件的名称。 |
|
现有 DLP 配置文件的名称。 |
|
现有 DLP 传感器的名称。 |
|
现有 DNS 过滤配置文件的名称。 |
|
(列表或字符串) 目标 IPv4 地址名称和地址组名称。 |
|
(列表或字符串) 目标 IPv4 地址名称和地址组名称。 |
|
(列表或字符串) 目标 IPv6 地址名称和地址组名称。 |
|
启用时，dstaddr6 指定目标地址不能是什么。 选项
|
|
启用时，dstaddr/dstaddr6 指定目标地址不能是什么。 选项
|
|
(列表或字符串) 出站 |
|
现有邮件过滤配置文件的名称。 |
|
启用/禁用允许的应用程序的默认应用程序端口强制执行。 选项
|
|
现有文件过滤器配置文件的名称。 |
|
(列表或字符串) FSSO 组的名称。 |
|
GUI 处于全局视图模式时显示的策略标签。 |
|
(列表或字符串) 可以使用此策略进行身份验证的用户组名称。 |
|
现有 ICAP 配置文件的名称。 |
|
启用/禁用为此策略使用 Internet 服务。 选项
|
|
启用/禁用为此策略使用 IPv6 Internet 服务。 选项
|
|
(列表) 自定义 IPv6 Internet 服务名称。 |
|
(列表) 自定义 IPv6 Internet 服务组名称。 |
|
(列表) Internet 服务组名称。 |
|
(列表) IPv6 Internet 服务名称。 |
|
启用后，internet-service6 指定服务**不能**是什么。 选项
|
|
启用/禁用在此策略的源中使用 IPv6 Internet 服务。 选项
|
|
(列表) 自定义 IPv6 Internet 服务源名称。 |
|
(列表) 自定义 Internet Service6 源组名称。 |
|
(列表) Internet Service6 源组名称。 |
|
(列表) IPv6 Internet 服务源名称。 |
|
启用后，internet-service6-src 指定服务**不能**是什么。 选项
|
|
(列表或字符串) 自定义 Internet 服务名称。 |
|
(列表或字符串) 自定义 Internet 服务组名称。 |
|
(列表或字符串) Internet 服务组名称。 |
|
(列表或字符串) Internet 服务 ID。 |
|
(列表或字符串) Internet 服务名称。 |
|
启用后，internet-service 指定服务**不能**是什么。 选项
|
|
启用/禁用在此策略的源中使用 Internet 服务。 选项
|
|
(列表或字符串) 自定义 Internet 服务源名称。 |
|
(列表或字符串) 自定义 Internet 服务源组名称。 |
|
(列表或字符串) Internet 服务源组名称。 |
|
(列表或字符串) Internet 服务源 ID。 |
|
(列表或字符串) Internet 服务源名称。 |
|
启用后，internet-service-src 指定服务**不能**是什么。 选项
|
|
现有 IPS 传感器的名称。 |
|
现有 VoIP 的名称。 |
|
启用后允许所有内容，但记录所有有意义的数据以收集安全信息。 选项
|
|
启用或禁用日志记录。 选项
|
|
会话开始时记录日志。 选项
|
|
现有 MMS 配置文件的名称。 |
|
策略名称。 |
|
启用/禁用 NAT46。 选项
|
|
启用/禁用 NAT64。 选项
|
|
策略 ID。 |
|
配置文件组的名称。 |
|
现有协议选项配置文件的名称。 |
|
确定防火墙策略是只允许安全配置文件组还是单个配置文件。 选项
|
|
调度名称。 |
|
现有 SCTP 过滤器配置文件的名称。 |
|
启用后，当会话被防火墙策略拒绝或阻止时发送回复。 选项
|
|
(列表或字符串) 服务和服务组名称。 |
|
启用后，service 指定服务**不能**是什么。 选项
|
|
(列表或字符串) 源 IPv4 地址名称和地址组名称。 |
|
(列表或字符串) 源 IPv4 地址名称和地址组名称。 |
|
(列表或字符串) 源 IPv6 地址名称和地址组名称。 |
|
启用后，srcaddr6 指定源地址**不能**是什么。 选项
|
|
启用后，srcaddr/srcaddr6 指定源地址**不能**是什么。 选项
|
|
(列表或字符串) 入站 |
|
现有 SSH 过滤器配置文件的名称。 |
|
现有 SSL SSH 配置文件的名称。 |
|
启用或禁用此策略。 选项
|
|
(列表或字符串) URL 类别 ID 列表。 |
|
(列表或字符串) 可以使用此策略进行身份验证的单个用户的名称。 |
|
启用安全配置文件。 选项
|
|
通用唯一标识符 |
|
现有 VideoFilter 配置文件的名称。 |
|
现有虚拟补丁配置文件的名称。 |
|
现有 VoIP 配置文件的名称。 |
|
现有 Web 过滤器配置文件的名称。 |
|
底层 Json RPC 请求的覆盖方法。 选项
|
|
将覆盖失败条件的 rc 代码列表。 |
|
将覆盖成功条件的 rc 代码列表。 |
|
创建、更新或删除对象的指令。 选项
|
|
在工作区模式下锁定 FortiManager 的 adom，值可以是全局的和其他值，包括 root。 |
|
等待其他用户释放工作区锁的最大时间（秒）。 默认值: |
备注
注意
从 2.4.0 版本开始，所有输入参数都使用下划线命名约定（snake_case）。请将诸如“var-name”之类的参数更改为“var_name”。旧的参数名称仍然可用，但您会收到弃用警告。您可以通过在 ansible.cfg 中设置 deprecation_warnings=False 来忽略此警告。
此 FortiManager 模块支持在工作区锁定模式下运行，顶级参数 workspace_locking_adom 和 workspace_locking_timeout 有助于完成此工作。
要创建或更新对象，请使用 state present 指令。
要删除对象，请使用 state absent 指令。
通常情况下，当返回非零 rc 时，运行一个模块可能会失败。您还可以使用参数 rc_failed 和 rc_succeeded 覆盖失败或成功的条件。
示例
- name: Example playbook (generated based on argument schema)
hosts: fortimanagers
connection: httpapi
vars:
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_httpapi_port: 443
tasks:
- name: Configure NGFW IPv4/IPv6 application policies.
fortinet.fortimanager.fmgr_pkg_firewall_securitypolicy:
# bypass_validation: false
workspace_locking_adom: <value in [global, custom adom including root]>
workspace_locking_timeout: 300
# rc_succeeded: [0, -2, -3, ...]
# rc_failed: [-2, -3, ...]
adom: <your own value>
pkg: <your own value>
state: present # <value in [present, absent]>
pkg_firewall_securitypolicy:
action: <value in [deny, accept]>
app_category: <list or string>
app_group: <list or string>
application: <list or integer>
application_list: <string>
av_profile: <string>
cifs_profile: <string>
comments: <string>
dlp_sensor: <string>
dnsfilter_profile: <string>
dstaddr4: <list or string>
dstaddr6: <list or string>
dstintf: <list or string>
emailfilter_profile: <string>
enforce_default_app_port: <value in [disable, enable]>
groups: <list or string>
icap_profile: <string>
internet_service: <value in [disable, enable]>
internet_service_custom: <list or string>
internet_service_custom_group: <list or string>
internet_service_group: <list or string>
internet_service_id: <list or string>
internet_service_negate: <value in [disable, enable]>
internet_service_src: <value in [disable, enable]>
internet_service_src_custom: <list or string>
internet_service_src_custom_group: <list or string>
internet_service_src_group: <list or string>
internet_service_src_id: <list or string>
internet_service_src_negate: <value in [disable, enable]>
ips_sensor: <string>
logtraffic: <value in [disable, all, utm]>
logtraffic_start: <value in [disable, enable]>
mms_profile: <string>
name: <string>
policyid: <integer>
profile_group: <string>
profile_protocol_options: <string>
profile_type: <value in [single, group]>
schedule: <string>
service: <list or string>
service_negate: <value in [disable, enable]>
srcaddr4: <list or string>
srcaddr6: <list or string>
srcintf: <list or string>
ssh_filter_profile: <string>
ssl_ssh_profile: <string>
status: <value in [disable, enable]>
url_category: <list or string>
users: <list or string>
utm_status: <value in [disable, enable]>
uuid: <string>
voip_profile: <string>
webfilter_profile: <string>
fsso_groups: <list or string>
global_label: <string>
send_deny_packet: <value in [disable, enable]>
dstaddr: <list or string>
internet_service_name: <list or string>
internet_service_src_name: <list or string>
srcaddr: <list or string>
dstaddr_negate: <value in [disable, enable]>
file_filter_profile: <string>
srcaddr_negate: <value in [disable, enable]>
learning_mode: <value in [disable, enable]>
videofilter_profile: <string>
_policy_block: <integer>
dlp_profile: <string>
nat46: <value in [disable, enable]>
nat64: <value in [disable, enable]>
sctp_filter_profile: <string>
internet_service6: <value in [disable, enable]>
internet_service6_custom: <list or string>
internet_service6_custom_group: <list or string>
internet_service6_group: <list or string>
internet_service6_name: <list or string>
internet_service6_negate: <value in [disable, enable]>
internet_service6_src: <value in [disable, enable]>
internet_service6_src_custom: <list or string>
internet_service6_src_custom_group: <list or string>
internet_service6_src_group: <list or string>
internet_service6_src_name: <list or string>
internet_service6_src_negate: <value in [disable, enable]>
casb_profile: <string>
diameter_filter_profile: <string>
dstaddr6_negate: <value in [disable, enable]>
ips_voip_filter: <string>
srcaddr6_negate: <value in [disable, enable]>
virtual_patch_profile: <string>
返回值
常见的返回值已在 此处 记录，以下是此模块特有的字段
键 |
描述 |
|---|---|
请求的结果。 返回：始终 |
|
请求的完整 URL。 返回：始终 示例： |
|
API 请求的状态。 返回：始终 示例： |
|
API 响应。 返回：始终 |
|
API 响应的描述性消息。 返回：始终 示例： |
|
目标系统的信息。 返回：始终 |
|
请求的状态。 返回：始终 示例： |
|
如果剧本中使用的参数不受当前 FortiManager 版本支持，则会发出警告。 返回：复杂类型 |