fortinet.fortios.fortios_log_threat_weight 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置威胁权重设置。

注意

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

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

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

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

fortinet.fortios 2.0.0 中的新增功能

概要

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

要求

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

  • ansible>=2.15

参数

参数

注释

access_token

字符串

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

enable_log

布尔值

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

选项

  • false ← (默认)

  • true

log_threat_weight

字典

配置威胁权重设置。

application

列表 / 元素=字典

应用程序控制威胁权重设置。

category

整数

应用程序类别。

id

整数 / 必填

条目 ID。请参见 <a href='#notes'>备注</a>。

level

字符串

应用程序事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

blocked_connection

字符串

被阻止连接的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

botnet_connection_detected

字符串

检测到的僵尸网络连接的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

failed_connection

字符串

连接失败的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

geolocation

列表 / 元素=字典

基于地理位置的威胁权重设置。

country

字符串

国家代码。

id

整数 / 必填

条目 ID。请参见 <a href='#notes'>备注</a>。

level

字符串

基于地理位置的事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

ips

字典

IPS 威胁权重设置。

critical_severity

字符串

IPS 严重事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

high_severity

字符串

IPS 高严重性事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

info_severity

字符串

IPS 信息严重性事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

low_severity

字符串

IPS 低严重性事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

medium_severity

字符串

IPS 中等严重性事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

level

字典

威胁权重级别的分数映射。

critical

整数

严重级别分数值 (1 - 100)。

high

整数

高级别分数值 (1 - 100)。

low

整数

低级别分数值 (1 - 100)。

medium

整数

中等级别分数值 (1 - 100)。

malware

字典

防病毒恶意软件威胁权重设置。

botnet_connection

字符串

检测到的僵尸网络连接的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

command_blocked

字符串

检测到的被阻止命令的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

content_disarm

字符串

检测到的病毒（内容清除）的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

ems_threat_feed

字符串

检测到的病毒（EMS 威胁源）的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

file_blocked

字符串

检测到的被阻止文件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

fortiai

字符串

FortiAI 检测到的病毒的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

fortindr

字符串

FortiNDR 检测到的病毒的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

fortisandbox

字符串

FortiSandbox 检测到的病毒的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

fsa_high_risk

字符串

FortiSandbox 检测到的高风险恶意软件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

fsa_malicious

字符串

FortiSandbox 检测到的恶意恶意软件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

fsa_medium_risk

字符串

FortiSandbox 检测到的中风险恶意软件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

inline_block

字符串

通过内联阻止检测到的恶意软件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

malware_list

字符串

检测到的病毒（恶意软件列表）的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

mimefragmented

字符串

检测到的 mimefragmented 的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

oversized

字符串

检测到的超大文件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

switch_proto

字符串

检测到的 switch proto 的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

virus_blocked

字符串

检测到的病毒（已阻止）的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

virus_file_type_executable

字符串

检测到的病毒（文件类型可执行）的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

virus_infected

字符串

检测到的病毒（已感染）的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

virus_outbreak_prevention

字符串

病毒（疫情预防）事件的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

virus_scan_error

字符串

检测到的病毒（扫描错误）的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

status

字符串

启用/禁用威胁权重功能。

选项

  • "enable"

  • "disable"

url_block_detected

字符串

URL 阻止的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

web

列表 / 元素=字典

Web 过滤威胁权重设置。

category

整数

Web 类别过滤匹配的威胁权重分数。

id

整数 / 必填

条目 ID。请参见 <a href='#notes'>备注</a>。

level

字符串

Web 类别过滤匹配的威胁权重分数。

选项

  • "disable"

  • "low"

  • "medium"

  • "high"

  • "critical"

member_path

字符串

要操作的成员属性路径。

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

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

member_state

字符串

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

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

选项

  • "present"

  • "absent"

vdom

字符串

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

默认值： "root"

备注

注意

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

示例

- name: Configure threat weight settings.
  fortinet.fortios.fortios_log_threat_weight:
      vdom: "{{ vdom }}"
      log_threat_weight:
          application:
              -
                  category: "0"
                  id: "5"
                  level: "disable"
          blocked_connection: "disable"
          botnet_connection_detected: "disable"
          failed_connection: "disable"
          geolocation:
              -
                  country: "<your_own_value>"
                  id: "12"
                  level: "disable"
          ips:
              critical_severity: "disable"
              high_severity: "disable"
              info_severity: "disable"
              low_severity: "disable"
              medium_severity: "disable"
          level:
              critical: "50"
              high: "30"
              low: "5"
              medium: "10"
          malware:
              botnet_connection: "disable"
              command_blocked: "disable"
              content_disarm: "disable"
              ems_threat_feed: "disable"
              file_blocked: "disable"
              fortiai: "disable"
              fortindr: "disable"
              fortisandbox: "disable"
              fsa_high_risk: "disable"
              fsa_malicious: "disable"
              fsa_medium_risk: "disable"
              inline_block: "disable"
              malware_list: "disable"
              mimefragmented: "disable"
              oversized: "disable"
              switch_proto: "disable"
              virus_blocked: "disable"
              virus_file_type_executable: "disable"
              virus_infected: "disable"
              virus_outbreak_prevention: "disable"
              virus_scan_error: "disable"
          status: "enable"
          url_block_detected: "disable"
          web:
              -
                  category: "0"
                  id: "51"
                  level: "disable"

返回值

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

键

描述

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)