Spec-Zone.ru › Ansible 2.8

fortios_webfilter – Настройка возможностей веб-фильтра FortiGate и FortiOS

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

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

Обзор

  • Этот модуль позволяет настраивать FortiGate или FortiOS, предоставляя пользователю возможность настроить функцию веб-фильтра. Пока что он способен обрабатывать функции фильтрации URL и содержимого. Модуль использует внутренний REST API FortiGate для настройки устройства.

Требования

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

  • fortiosapi>=0.9.8

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
host
- / обязательно
IP-адрес FortiOS или FortiGate.
password
-
По умолчанию:
""
Пароль FortiOS или FortiGate.
username
- / обязательно
Имя пользователя FortiOS или FortiGate.
vdom
-
По умолчанию:
"root"
Виртуальная область (vdom), определённая ранее. Vdom — это виртуальный экземпляр FortiGate, который может быть настроен и использован как отдельный блок.
webfilter_content
-
Контейнер для группы записей фильтрации контента, на которые FortiGate должен реагировать.
comment
-
Дополнительные комментарии.
entries
-
По умолчанию:
[]
Записи фильтра контента.
action
- / обязательно
    Варианты:
  • block
  • exempt
Блокировать или разрешить слово, при совпадении.
lang
- / обязательно
    Варианты:
  • western
  • simch
  • trach
  • japanese
  • korean
  • french
  • thai
  • spanish
  • cyrillic
Язык запрещённого слова.
name
- / обязательно
Запрещённое слово.
pattern-type
- / обязательно
    Варианты:
  • wildcard
  • regexp
Тип шаблона запрещённого слова. Может быть шаблоном с подстановкой или регулярным выражением Perl.
score
- / обязательно
Оценка, применяемая каждый раз, когда слово появляется на веб-странице.
status
- / обязательно
    Варианты:
  • enable
  • disable
Включить/выключить запрещённое слово.
id
- / обязательно
Идентификатор списка фильтрации контента.
name
-
Имя списка фильтрации контента.
state
- / обязательно
    Варианты:
  • absent
  • present
Настройка желаемого состояния этого объекта на FortiGate. При значении present объект настраивается на устройстве, а при значении absent — удаляется с устройства.
webfilter_url
-
Контейнер для группы записей URL-фильтра, на которые FortiGate должен реагировать.
comment
-
Дополнительные комментарии.
entries
-
По умолчанию:
[]
Записи фильтра URL.
action
- / обязательно
    Варианты:
  • exempt
  • block
  • allow
  • monitor
Действие, которое необходимо выполнить для совпадения с URL-фильтром.
exempt
- / обязательно
    Варианты:
  • av
  • web-content
  • activex-java-cookie
  • dlp
  • fortiguard
  • range-block
  • pass
  • all
Если действие установлено на exempt, выберите операции профиля безопасности, которые исключают URL. Разделяйте несколько вариантов пробелами.
id
- / обязательно
Идентификатор URL.
referrer-host
- / обязательно
Имя хоста отправителя.
status
- / обязательно
    Варианты:
  • enable
  • disable
Включить/выключить этот URL-фильтр.
type
- / обязательно
    Варианты:
  • simple
  • regex
  • wildcard
Тип фильтра (простой, регулярное выражение или подстановка).
url
- / обязательно
URL, который необходимо отфильтровать.
web-proxy-profile
- / обязательно
Профиль веб-прокси.
id
- / обязательно
Идентификатор списка URL-фильтра.
ip-addr-block
-
    Варианты:
  • enable
  • disable ←
Включить/выключить блокирование URL, когда имя хоста отображается как IP-адрес.
name
- / обязательно
Имя списка URL-фильтра.
one-arm-ips-urlfilter
-
    Варианты:
  • enable
  • disable ←
Включить/выключить DNS-резольвер для работы фильтра URL для одностороннего IPS.
state
- / обязательно
    Варианты:
  • absent
  • present
Настройка желаемого состояния этого объекта на FortiGate. При значении present объект настраивается на устройстве, а при значении absent — удаляется с устройства.

Примечания

Примечание

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

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
  tasks:
  - name: Configure url to be filtered by fortigate
    fortios_webfilter:
      host:  "{{  host }}"
      username: "{{  username}}"
      password: "{{ password }}"
      vdom:  "{{  vdom }}"
      webfilter_url:
        state: "present"
        id: "1"
        name: "default"
        comment: "mycomment"
        one-arm-ips-url-filter: "disable"
        ip-addr-block: "disable"
        entries:
          - id: "1"
            url: "www.test1.com"
            type: "simple"
            action: "exempt"
            status: "enable"
            exempt: "pass"
            web-proxy-profile: ""
            referrrer-host: ""
          - id: "2"
            url: "www.test2.com"
            type: "simple"
            action: "exempt"
            status: "enable"
            exempt: "pass"
            web-proxy-profile: ""
            referrrer-host: ""


- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
  tasks:
  - name: Configure web content filtering in fortigate
    fortios_webfilter:
      host:  "{{  host }}"
      username: "{{  username}}"
      password: "{{ password }}"
      vdom:  "{{  vdom }}"
      webfilter_content:
        id: "1"
        name: "default"
        comment: ""
        entries:
          - name: "1"
            pattern-type: "www.test45.com"
            status: "enable"
            lang: "western"
            score: 40
            action: "block"
          - name: "2"
            pattern-type: "www.test46.com"
            status: "enable"
            lang: "western"
            score: 42
            action: "block"
        state: "present"

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

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

Ключ Возвращаемое значение Описание
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_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API