fortios_webfilter_fortiguard – Настройка службы фильтра веб-трафика FortiGuard

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

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

Обзор

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

Требования

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

fortiosapi>=0.9.8

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
host - / обязательно			IP-адрес FortiOS или FortiGate.
https логическое		Варианты: нет ← да	Указывает, должны ли запросы к FortiGate использовать протокол HTTPS.
password -		По умолчанию: ""	Пароль FortiOS или FortiGate.
username - / обязательно			Имя пользователя FortiOS или FortiGate.
vdom -		По умолчанию: "root"	Виртуальная область (vdom), определенная ранее. Vdom — это виртуальная копия FortiGate, которую можно настроить и использовать как отдельное устройство.
webfilter_fortiguard -		По умолчанию: null	Настроить службу фильтра веб-трафика FortiGuard.
	cache-mem-percent -		Максимальный процент доступной памяти, выделенной для кэширования (1-15%).
	cache-mode -	Варианты: ttl db-ver	Режим истечения срока действия записей в кэше.
	cache-prefix-match -	Варианты: включить выключить	Включить/выключить сопоставление префиксов в кэше.
	close-ports -	Варианты: включить выключить	Закрыть порты, используемые для аутентификации с использованием HTTP/HTTPS и отключить пользовательские переопределения.
	ovrd-auth-https -	Варианты: включить выключить	Включить/выключить использование HTTPS для аутентификации с переопределением.
	ovrd-auth-port -		Порт, используемый для аутентификации с переопределением службы фильтра веб-трафика FortiGuard.
	ovrd-auth-port-http -		Порт, используемый для HTTP аутентификации с переопределением службы фильтра веб-трафика FortiGuard.
	ovrd-auth-port-https -		Порт, используемый для HTTPS аутентификации с переопределением службы фильтра веб-трафика FortiGuard.
	ovrd-auth-port-warning -		Порт, используемый для аутентификации с предупреждением при переопределении службы фильтра веб-трафика FortiGuard.
	request-packet-size-limit -		Ограничение размера пакетов запросов URL, отправляемых на сервер FortiGuard (0 для значения по умолчанию).
	warn-auth-https -	Варианты: включить выключить	Включить/выключить использование HTTPS для предупреждений и аутентификации.

Примечания

Примечание

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

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
  tasks:
  - name: Configure FortiGuard Web Filter service.
    fortios_webfilter_fortiguard:
      host:  "{{  host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{  vdom }}"
      webfilter_fortiguard:
        cache-mem-percent: "3"
        cache-mode: "ttl"
        cache-prefix-match: "enable"
        close-ports: "enable"
        ovrd-auth-https: "enable"
        ovrd-auth-port: "8"
        ovrd-auth-port-http: "9"
        ovrd-auth-port-https: "10"
        ovrd-auth-port-warning: "11"
        request-packet-size-limit: "12"
        warn-auth-https: "enable"

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

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

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

Статус

Не гарантируется обратная совместимость этого модуля. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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_webfilter_fortiguard_module.html