fortios_ips_rule – Настройка правил IPS в FortiOS и FortiGate Fortinet

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

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

Обзор

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

Требования

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

fortiosapi>=0.9.8

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
host строка				IP-адрес FortiOS или FortiGate.
https логическое значение			Варианты: нет да ←	Указывает, должны ли запросы к FortiGate использовать протокол HTTPS.
ips_rule словарь			Значение по умолчанию: null	Настройка правил IPS.
	action строка		Варианты: pass block	Действие.
	application строка			Уязвимые приложения.
	date целое число			Дата.
	group строка			Группа.
	location строка			Уязвимое местоположение.
	log строка		Варианты: disable enable	Включить/отключить логирование.
	log_packet строка		Варианты: disable enable	Включить/отключить логирование пакетов.
	metadata список			Метаданные.
		id целое число / обязательно		Идентификатор.
		metaid целое число		Идентификатор метаданных.
		valueid целое число		Идентификатор значения.
	name строка / обязательно			Имя правила.
	os строка			Уязвимые операционные системы.
	rev целое число			Ревизия.
	rule_id целое число			Идентификатор правила.
	service строка			Уязвимый сервис.
	severity строка			Уровень серьезности.
	state строка		Варианты: present absent	Устарело Начиная с Ansible 2.9 рекомендуется использовать параметр 'state' на верхнем уровне. Указывает, нужно ли создать или удалить объект.
	status строка		Варианты: disable enable	Включить/отключить статус.
password строка			Значение по умолчанию: ""	Пароль FortiOS или FortiGate.
ssl_verify логическое значение добавлен в 2.9			Варианты: нет да ←	Обеспечивает проверку сертификата FortiGate надёжным центром сертификации.
state строка добавлен в 2.9			Варианты: present absent	Указывает, нужно ли создать или удалить объект. Этот атрибут уже был на предыдущих версиях на более глубоком уровне. Он был перемещён на внешний уровень.
username строка				Имя пользователя FortiOS или FortiGate.
vdom строка			Значение по умолчанию: "root"	Виртуальная доменная зона, среди тех, которые были определены ранее. ВДЗ — виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

Примечания

Примечание

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

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
   ssl_verify: "False"
  tasks:
  - name: Configure IPS rules.
    fortios_ips_rule:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      https: "False"
      state: "present"
      ips_rule:
        action: "pass"
        application: "<your_own_value>"
        date: "5"
        group: "<your_own_value>"
        location: "<your_own_value>"
        log: "disable"
        log_packet: "disable"
        metadata:
         -
            id:  "11"
            metaid: "12"
            valueid: "13"
        name: "default_name_14"
        os: "<your_own_value>"
        rev: "16"
        rule_id: "17"
        service: "<your_own_value>"
        severity: "<your_own_value>"
        status: "disable"

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

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

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

Авторы

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.9/modules/fortios_ips_rule_module.html