fortinet.fortimanager.fmgr_antivirus_profile 模块 – 配置防病毒配置文件。
注意
此模块是 fortinet.fortimanager 集合(版本 2.8.2)的一部分。
如果您正在使用 ansible
包,则可能已经安装了此集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install fortinet.fortimanager
。
要在剧本中使用它,请指定:fortinet.fortimanager.fmgr_antivirus_profile
。
fortinet.fortimanager 1.0.0 中的新增功能
概要
此模块能够配置 FortiManager 设备。
示例包括所有参数和值,这些参数和值需要在使用前调整为数据源。
参数
参数 |
注释 |
---|---|
无需使用用户名和密码即可访问 FortiManager 的令牌。 |
|
请求的 URL 中的参数 (adom)。 |
|
顶级参数集。 |
|
仅将匹配此 DLP 文件模式的文件提交到 FortiSandbox。 |
|
仅将匹配此 DLP 文件模式的文件提交到 FortiSandbox。 |
|
启用/禁用使用 FortiSandbox 签名数据库来补充 AV 签名数据库。 选项
|
|
不将匹配此 DLP 文件模式的文件提交到 FortiSandbox。 |
|
可以上传到 FortiSandbox 的最大文件大小 |
|
不将匹配此 DLP 文件模式的文件提交到 FortiSandbox。 |
|
启用/禁用防病毒文件阻止的日志记录。 选项
|
|
启用/禁用防病毒日志记录。 选项
|
|
Cifs。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 CIFS 防病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
注释。 |
|
内容解除。 |
|
启用/禁用将 CDR 用作确定分析可疑文件的辅助方法。 选项
|
|
启用/禁用在解除武装的文档中插入封面。 选项
|
|
启用/禁用仅检测可解除武装的文件,不更改内容。 选项
|
|
如果 CDR 引擎遇到无法恢复的错误,则采取的操作。 选项
|
|
启用/禁用剥离 Microsoft Office 文档中的 PowerPoint 操作事件。 选项
|
|
启用/禁用剥离 Microsoft Office 文档中的动态数据交换事件。 选项
|
|
启用/禁用剥离 Microsoft Office 文档中的嵌入对象。 选项
|
|
启用/禁用剥离 Microsoft Office 文档中的超链接。 选项
|
|
启用/禁用剥离 Microsoft Office 文档中的链接对象。 选项
|
|
启用/禁用剥离 Microsoft Office 文档中的宏。 选项
|
|
如果删除活动内容,则发送原始文件的目标位置。 选项
|
|
启用/禁用剥离将数据提交到其他目标的 PDF 文档操作。 选项
|
|
启用/禁用剥离访问其他 PDF 文档的 PDF 文档操作。 选项
|
|
启用/禁用剥离执行 JavaScript 代码的 PDF 文档操作。 选项
|
|
启用/禁用剥离启动其他应用程序的 PDF 文档操作。 选项
|
|
启用/禁用剥离播放电影的 PDF 文档操作。 选项
|
|
启用/禁用剥离播放声音的 PDF 文档操作。 选项
|
|
启用/禁用剥离 PDF 文档中的嵌入文件。 选项
|
|
启用/禁用剥离 PDF 文档中的超链接。 选项
|
|
启用/禁用剥离 PDF 文档中的 JavaScript 代码。 选项
|
|
执行反病毒扫描时启用/禁用 EMS 威胁源的使用。 选项
|
|
启用/禁用反病毒的扩展日志记录。 选项
|
|
(列表或字符串) 一个或多个外部恶意软件阻止列表。 |
|
启用/禁用外部阻止列表存档扫描。 选项
|
|
启用/禁用所有外部阻止列表。 选项
|
|
流/代理功能集。 选项
|
|
如果 FortiAI 遇到错误,则采取的行动。 选项
|
|
如果 FortiAI 遇到扫描超时,则采取的行动。 选项
|
|
如果 FortiNDR 遇到错误,则采取的行动。 选项
|
|
如果 FortiNDR 遇到扫描超时,则采取的行动。 选项
|
|
如果 FortiSandbox 内联扫描遇到错误,则采取的行动。 选项
|
|
可以上传到 FortiSandbox 的最大文件大小。 |
|
FortiSandbox 扫描模式。 选项
|
|
如果 FortiSandbox 内联扫描遇到扫描超时,则采取的行动。 选项
|
|
控制将哪些文件上传到 FortiSandbox 的设置。 选项
|
|
Ftp。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 FTP 反病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
Http。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
Av 优化。 选项
|
|
启用防病毒扫描服务。 选项
|
|
为此协议启用内容解除和重建。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 HTTP 反病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
配置 FortiGate 设备对未知内容编码采取的行动。 选项
|
|
Imap。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
为此协议启用内容解除和重建。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
将 Windows 可执行文件视为病毒,以便阻止或监控。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 IMAP 反病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
检查模式。 选项
|
|
Mapi。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
将 Windows 可执行文件视为病毒,以便阻止或监控。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 MAPI 反病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
启用/禁用使用移动恶意软件签名数据库。 选项
|
|
Nac 隔离。 |
|
隔离的持续时间。 |
|
启用/禁用将受感染的主机隔离到被禁止的用户列表。 选项
|
|
启用/禁用反病毒隔离日志记录。 选项
|
|
配置文件名称。 |
|
Nntp。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 NNTP 反病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
爆发防护。 |
|
启用/禁用外部恶意软件阻止列表。 选项
|
|
启用/禁用 FortiGuard 病毒爆发防护服务。 选项
|
|
启用/禁用爆发防护存档扫描。 选项
|
|
Pop3。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
为此协议启用内容解除和重建。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
将 Windows 可执行文件视为病毒,以便阻止或监控。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 POP3 防病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
为此配置文件定制的替换消息组。 |
|
在完整扫描模式和快速扫描模式之间选择。 选项
|
|
Smb。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
启用/禁用 SMB 防病毒扫描、监控和隔离。 选项
|
|
启用 FortiGuard 病毒爆发防护服务。 选项
|
|
Smtp。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
为此协议启用内容解除和重建。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
将 Windows 可执行文件视为病毒,以便阻止或监控。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 SMTP 防病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
Ssh。 |
|
选择要阻止的存档类型。 选项
|
|
选择要记录的存档类型。 选项
|
|
启用防病毒扫描服务。 选项
|
|
启用/禁用病毒模拟器。 选项
|
|
启用外部阻止列表。 选项
|
|
启用/禁用 FortiAI 对文件的扫描。 选项
|
|
启用 FortiNDR 对文件的扫描。 选项
|
|
启用 FortiSandbox 对文件的扫描。 选项
|
|
启用/禁用 SFTP 和 SCP 防病毒扫描、监控和隔离。 选项
|
|
启用病毒爆发预防服务。 选项
|
|
启用/禁用对受感染文件的隔离。 选项
|
|
仅当模块模式与 FortiManager API 结构不同时才设置为 True,模块继续执行而不验证参数。 选项
|
|
启用/禁用任务日志记录。 选项
|
|
使用 forticloud API 访问令牌验证 Ansible 客户端。 |
|
底层 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
hosts: fortimanagers
connection: httpapi
vars:
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_httpapi_port: 443
tasks:
- name: Configure AntiVirus profiles.
fortinet.fortimanager.fmgr_antivirus_profile:
adom: ansible
state: present
antivirus_profile:
analytics-db: disable
analytics-max-upload: 20
av-block-log: disable
av-virus-log: disable
comment: "test comment"
extended-log: disable
ftgd-analytics: disable
inspection-mode: proxy
mobile-malware-db: disable
name: "antivirus-profile"
scan-mode: quick
- name: Gathering fortimanager facts
hosts: fortimanagers
gather_facts: false
connection: httpapi
vars:
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_httpapi_port: 443
tasks:
- name: Retrieve all the antivirus profiles
fortinet.fortimanager.fmgr_fact:
facts:
selector: "antivirus_profile"
params:
adom: "ansible"
profile: "your_value"
返回值
常见返回值记录在 这里,以下是此模块独有的字段
键 |
描述 |
---|---|
请求的结果。 返回: 总是 |
|
请求的完整 URL。 返回: 总是 示例: |
|
api 请求的状态。 返回: 总是 示例: |
|
api 响应。 返回: 总是 |
|
api 响应的描述性消息。 返回: 总是 示例: |
|
目标系统的信息。 返回: 总是 |
|
请求的状态。 返回: 总是 示例: |
|
如果 playbook 中使用的参数不受当前 FortiManager 版本支持,则发出警告。 返回: 复杂 |