fortinet.fortimanager.fmgr_antivirus_profile_smtp — Настройка параметров SMTP AntiVirus.

Примечание

Этот плагин входит в состав коллекции fortinet.fortimanager (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install fortinet.fortimanager.

Чтобы использовать его в книге задач, укажите: fortinet.fortimanager.fmgr_antivirus_profile_smtp.

В версии 2.10: модуля fortinet.fortimanager

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль позволяет настраивать устройство FortiManager.
Примеры включают все параметры и значения, которые необходимо настроить для источников данных перед использованием.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно			параметр (adom) в запрошенном URL-адресе
antivirus_profile_smtp словарь			настройки верхнего уровня
	archive-block список / элементы=строка	Варианты: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	нет описания
	archive-log список / элементы=строка	Варианты: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	нет описания
	content-disarm строка	Варианты: disable enable	Включить Content Disarm and Reconstruction для этого протокола.
	emulator строка	Варианты: disable enable	Включить/выключить эмулятор вирусов.
	executables строка	Варианты: default virus	Обрабатывать исполняемые файлы Windows как вирусы для блокирования или мониторинга.
	options список / элементы=строка	Варианты: scan file-filter quarantine avquery avmonitor	нет описания
	outbreak-prevention строка	Варианты: disabled files full-archive	Включить службу предотвращения вспышек вирусов FortiGuard.
bypass_validation булево		Варианты: нет ← да	устанавливать только в значение True, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполняться без проверки параметров
profile строка / обязательно			параметр (profile) в запрошенном URL-адресе
rc_failed список / элементы=строка			список кодов rc, при которых условия будут считаться выполненными с ошибкой
rc_succeeded список / элементы=строка			список кодов rc, при которых условия будут считаться выполненными успешно
state строка / обязательно		Варианты: present absent	директива для создания, обновления или удаления объекта
workspace_locking_adom строка			область, которую нужно заблокировать для FortiManager, работающего в режиме рабочей области, значение может быть global и другими, включая root
workspace_locking_timeout целое число		По умолчанию: 300	максимальное время в секундах ожидания, пока другой пользователь не освободит блокировку рабочей области

Примечания

Примечание

Поддерживается работа в режиме блокировки рабочей области в этом модуле FortiManager, параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout помогают в этом.
Для создания или обновления объекта используйте директиву state present.
Для удаления объекта используйте директиву state absent.
Обычно выполнение одного модуля может завершиться неудачей, если возвращается ненулевой rc. Также можно переопределить условия для возврата ошибки или успеха с помощью параметров rc_failed и rc_succeeded

Примеры

- hosts: fortimanager-inventory
  collections:
    - fortinet.fortimanager
  connection: httpapi
  vars:
     ansible_httpapi_use_ssl: True
     ansible_httpapi_validate_certs: False
     ansible_httpapi_port: 443
  tasks:
   - name: Configure SMTP AntiVirus options.
     fmgr_antivirus_profile_smtp:
        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>
        profile: <your own value>
        antivirus_profile_smtp:
           archive-block:
             - encrypted
             - corrupted
             - multipart
             - nested
             - mailbomb
             - unhandled
             - partiallycorrupted
             - fileslimit
             - timeout
           archive-log:
             - encrypted
             - corrupted
             - multipart
             - nested
             - mailbomb
             - unhandled
             - partiallycorrupted
             - fileslimit
             - timeout
           content-disarm: <value in [disable, enable]>
           emulator: <value in [disable, enable]>
           executables: <value in [default, virus]>
           options:
             - scan
             - file-filter
             - quarantine
             - avquery
             - avmonitor
           outbreak-prevention: <value in [disabled, files, full-archive]>

Возвращаемые значения

Общие возвращаемые значения описаны в документации. Ниже приведены поля, уникальные для этого модуля:

Ключ	Возвращаемое значение	Описание
request_url строка	всегда	Полный запрашиваемый URL. Пример: /sys/login/user
response_code целое число	всегда	Статус запроса API
response_message строка	всегда	Описание ответа API Пример: OK.

Авторы

Link Zheng (@chillancezen)
Jie Xue (@JieX19)
Frank Shen (@fshen01)
Hongbin Lu (@fgtdev-hblu)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/fortinet/fortimanager/fmgr_antivirus_profile_smtp_module.html