fortios_antivirus_quarantine – Настройка параметров карантина в FortiOS и FortiGate Fortinet

Новая версия с 2.8.

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

Обзор

Этот модуль позволяет настроить FortiGate или FortiOS, позволяя пользователю настроить функцию антивируса и категорию карантина. Примеры включают все параметры и должны быть скорректированы под источники данных перед использованием. Тестировано с FOS v6.0.2

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

fortiosapi>=0.9.8

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
antivirus_quarantine -		По умолчанию: null	Настройка параметров карантина.
	agelimit -		Лимит возраста для файлов в карантине (0 - 479 часов, 0 означает навсегда).
	destination -	Варианты: None disk FortiAnalyzer	Выберите, куда поместить файлы в карантин: на диск FortiGate, в FortiAnalyzer или удалить их вместо карантина.
	drop-blocked -	Варианты: imap smtp pop3 http ftp nntp imaps smtps pop3s ftps mapi cifs mm1 mm3 mm4 mm7	Не помещать в карантин файлы, помеченные как заблокированные, обнаруженные в сессиях с указанными протоколами. Такие файлы удаляются вместо карантина.
	drop-heuristic -	Варианты: imap smtp pop3 http ftp nntp imaps smtps pop3s https ftps mapi cifs mm1 mm3 mm4 mm7	Не помещать в карантин файлы, обнаруженные с помощью эвристического анализа, в сессиях с указанными протоколами. Такие файлы удаляются вместо карантина.
	drop-infected -	Варианты: imap smtp pop3 http ftp nntp imaps smtps pop3s https ftps mapi cifs mm1 mm3 mm4 mm7	Не помещать в карантин инфицированные файлы, обнаруженные в сессиях с указанными протоколами. Такие файлы удаляются вместо карантина.
	lowspace -	Варианты: drop-new ovrw-old	Выбор метода обработки дополнительных файлов при малом свободном месте на диске.
	maxfilesize -		Максимальный размер файла для карантина (0 - 500 Мбайт, 0 означает без ограничений).
	quarantine-quota -		Объем дискового пространства, резервируемого для карантина файлов (0 - 4294967295 Мбайт, зависит от места на диске).
	store-blocked -	Варианты: imap smtp pop3 http ftp nntp imaps smtps pop3s ftps mapi cifs mm1 mm3 mm4 mm7	Помещать заблокированные файлы, обнаруженные в сессиях с указанными протоколами, в карантин.
	store-heuristic -	Варианты: imap smtp pop3 http ftp nntp imaps smtps pop3s https ftps mapi cifs mm1 mm3 mm4 mm7	Помещать файлы, обнаруженные с помощью эвристического анализа, в сессиях с указанными протоколами, в карантин.
	store-infected -	Варианты: imap smtp pop3 http ftp nntp imaps smtps pop3s https ftps mapi cifs mm1 mm3 mm4 mm7	Помещать инфицированные файлы, обнаруженные в сессиях с указанными протоколами, в карантин.
host - / обязательно			IP-адрес FortiOS или FortiGate.
https boolean		Варианты: нет ← да	Указывает, должны ли запросы к FortiGate использовать протокол HTTPS.
password -		По умолчанию: ""	Пароль FortiOS или FortiGate.
username - / обязательно			Имя пользователя FortiOS или FortiGate.
vdom -		По умолчанию: "root"	Виртуальная область (VDOM), ранее определённая. VDOM — виртуальная копия FortiGate, которую можно настроить и использовать как отдельное устройство.

Примечания

Примечание

Требуется библиотека fortiosapi, разработанная Fortinet
Выполняется как local_action в вашем playbook

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
  tasks:
  - name: Configure quarantine options.
    fortios_antivirus_quarantine:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      antivirus_quarantine:
        agelimit: "3"
        destination: "NULL"
        drop-blocked: "imap"
        drop-heuristic: "imap"
        drop-infected: "imap"
        lowspace: "drop-new"
        maxfilesize: "9"
        quarantine-quota: "10"
        store-blocked: "imap"
        store-heuristic: "imap"
        store-infected: "imap"

Значения возврата

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

Ключ	Возвращаемое значение	Описание
build строка	всегда	Номер сборки образа FortiGate Пример: 1547
http_method строка	всегда	Последний метод, используемый для настройки контента в FortiGate Пример: PUT
http_status строка	всегда	Последний результат, полученный от FortiGate после последней операции Пример: 200
mkey строка	успех	Главный ключ (id), используемый в последнем вызове FortiGate Пример: id
name строка	всегда	Имя таблицы, используемой для выполнения запроса Пример: urlfilter
path строка	всегда	Путь к таблице, используемой для выполнения запроса Пример: webfilter
revision строка	всегда	Внутренний номер ревизии Пример: 17.0.2.10658
serial строка	всегда	Серийный номер устройства Пример: FGVMEVYYQT3AB5352
status строка	всегда	Указание результата операции Пример: успех
vdom строка	всегда	Используемый виртуальный домен Пример: root
version строка	всегда	Версия FortiGate Пример: v5.6.3

Статус

Данный модуль не гарантирует обратной совместимости. [превью]
Данный модуль поддерживается сообществом Ansible. [community]

Авторы

Miguel Angel Munoz (@mamunozgonzalez)
Nicolas Thomas (@thomnico)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/fortios_antivirus_quarantine_module.html