fortios_ips_custom – Настройка пользовательской подписи IPS в Fortinet’s FortiOS и FortiGate

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

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

Обзор

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

Требования

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

fortiosapi>=0.9.8

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
host - / обязательно			IP-адрес FortiOS или FortiGate.
https boolean		Варианты: нет да ←	Указывает, должны ли запросы к FortiGate использовать протокол HTTPS
ips_custom -		Значение по умолчанию: null	Настроить пользовательскую подпись IPS.
	action -	Варианты: пропустить заблокировать	Действие по умолчанию (пропустить или заблокировать) для этой подписи.
	application -		Защищаемые приложения. Пусто для всех приложений.
	comment -		Комментарий.
	location -		Защита трафика клиента или сервера.
	log -	Варианты: отключить включить	Включить/отключить ведение журнала.
	log-packet -	Варианты: отключить включить	Включить/отключить ведение журнала пакетов.
	os -		Операционные системы, защищаемые подписью. Пусто для всех операционных систем.
	protocol -		Протоколы, которые проверяет подпись. Пусто для всех протоколов.
	rule-id -		Идентификатор подписи.
	severity -		Относительная серьезность подписи, от информационной до критической. Сообщения журнала, создаваемые подписью, включают серьезность.
	sig-name -		Название подписи.
	signature -		Пользовательская подпись в одинарных кавычках.
	state -	Варианты: присутствует отсутствует	Указывает, нужно ли создать или удалить объект
	status -	Варианты: отключить включить	Включить/отключить эту подпись.
	tag - / обязательно		Тег подписи.
password -		Значение по умолчанию: ""	Пароль FortiOS или FortiGate.
username - / обязательно			Имя пользователя FortiOS или FortiGate.
vdom -		Значение по умолчанию: "root"	Виртуальная область, среди ранее определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

Примечания

Примечание

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

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
  tasks:
  - name: Configure IPS custom signature.
    fortios_ips_custom:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      https: "False"
      ips_custom:
        state: "present"
        action: "pass"
        application: "<your_own_value>"
        comment: "Comment."
        location: "<your_own_value>"
        log: "disable"
        log-packet: "disable"
        os: "<your_own_value>"
        protocol: "<your_own_value>"
        rule-id: "11"
        severity: "<your_own_value>"
        sig-name: "<your_own_value>"
        signature: "<your_own_value>"
        status: "disable"
        tag: "<your_own_value>"

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

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

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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается сообществом 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_ips_custom_module.html