f5networks.f5_modules.bigip_asm_policy_signature_set – Управляет наборами подписей для политики ASM

Примечание

Этот плагин является частью коллекции f5networks.f5_modules (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в книге задач укажите: f5networks.f5_modules.bigip_asm_policy_signature_set.

Добавлена в версии 1.0.0: модуля f5networks.f5_modules

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управляет наборами подписей для политики ASM.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
alarm boolean		Варианты: no yes	Указывает, будет ли политика безопасности регистрировать данные запроса на экране Статистики при совпадении запроса с подписью, включённой в набор подписей.
block boolean		Варианты: no yes	Действует, когда режим применения политики безопасности — Блокировка. Определяет, как система обрабатывает запросы, соответствующие подписи, включённой в набор подписей. Когда `yes`, система блокирует все запросы, соответствующие подписи, и предоставляет клиенту идентификатор поддержки. Когда `no`, система принимает эти запросы.
learn boolean		Варианты: no yes	Указывает, будет ли политика безопасности изучать все запросы, соответствующие подписи, включённой в набор подписей.
name string / обязательно			Указывает имя набора подписей, которые нужно применить или удалить из политики ASM. Помимо встроенных наборов подписей, поставляемых с устройством, вы можете создавать и использовать настраиваемые наборы подписей. При `All Response Signatures`, настраивает все подписи в пуле подписей атак, которые могут проверять ответы. При `All Signatures`, настраивает все подписи атак в пуле подписей атак. При `Apache Struts Signatures`, настраивает подписи, нацеленные на атаки на веб-серверы Apache Struts. Доступно только в версии 13.x и выше. При `Apache Tomcat Signatures`, настраивает подписи, нацеленные на атаки на веб-серверы Apache Tomcat. Доступно только в версии 13.x и выше. При `Cisco Signatures`, настраивает подписи, нацеленные на атаки на системы Cisco. Доступно только в версии 13.x и выше. При `Command Execution Signatures`, настраивает подписи, связанные с атаками, совершаемыми путём выполнения команд. При `Cross Site Scripting Signatures`, настраивает подписи, нацеленные на атаки, вызванные межсайтовым скриптингом. При `Directory Indexing Signatures`, настраивает подписи, нацеленные на атаки, просматривающие списки каталогов. При `Generic Detection Signatures`, настраивает подписи, нацеленные на известные или распространённые атаки на веб-сайты и приложения. При `HTTP Response Splitting Signatures`, настраивает подписи, нацеленные на атаки, которые используют ответы, для которых значения ввода не были проверены. При `High Accuracy Detection Evasion Signatures`, настраивает подписи с высокой точностью, которые создают мало ложных срабатываний при определении атак уклонения. Доступно только в версии 13.x и выше. При `High Accuracy Signatures`, настраивает подписи с высокой точностью, которые создают мало ложных срабатываний при определении атак уклонения. При `IIS and Windows Signatures`, настраивает подписи, нацеленные на атаки на IIS и системы на базе Windows. Доступно только в версии 13.x и выше. При `Information Leakage Signatures`, настраивает подписи, нацеленные на атаки, которые ищут системные данные или отладочную информацию, показывающую уязвимость системы к атаке. При `Java Servlets/JSP Signatures`, настраивает подписи, нацеленные на атаки на приложения на основе Java Servlets и Java Server Pages (JSP). Доступно только в версии 13.x и выше. При `Low Accuracy Signatures`, настраивает подписи, которые могут привести к большему количеству ложных срабатываний при обнаружении атак. При `Medium Accuracy Signatures`, настраивает подписи со средней точностью при обнаружении атак. При `OS Command Injection Signatures`, настраивает подписи, нацеленные на атаки, которые пытаются запустить команды уровня системы через уязвимое приложение. При `OWA Signatures`, настраивает подписи, нацеленные на атаки на приложение Microsoft Outlook Web Access (OWA). При `Other Application Attacks Signatures`, настраивает подписи, нацеленные на различные атаки, включая фиксацию сеансов, локальный доступ к файлам, попытки инъекции, подмену заголовков и т. д., затрагивающие многие приложения. При `Path Traversal Signatures`, настраивает подписи, нацеленные на атаки, которые пытаются получить доступ к файлам и каталогам, хранящимся вне папки веб-корня. При `Predictable Resource Location Signatures`, настраивает подписи, нацеленные на атаки, которые пытаются раскрыть скрытое содержимое и функциональность веб-сайта принудительным просмотром или перечислением каталогов и файлов. При `Remote File Include Signatures`, настраивает подписи, нацеленные на атаки, которые пытаются использовать уязвимость удалённого включения файлов, что может позволить удалённому злоумышленнику выполнить произвольные команды на сервере, на котором размещено приложение. При `SQL Injection Signatures`, настраивает подписи, нацеленные на атаки, которые пытаются вставить (ввести) запрос SQL с использованием данных ввода от клиента в приложение. При `Server Side Code Injection Signatures`, настраивает подписи, нацеленные на атаки с инъекцией кода на стороне сервера. При `WebSphere signatures`, настраивает подписи, нацеленные на атаки на различные вычислительные платформы, интегрированные с использованием WebSphere, включая общие базы данных, Microsoft Windows, IIS, Microsoft SQL Server, Apache, Oracle, Unix/Linux, IBM DB2, PostgreSQL и XML. При `XPath Injection Signatures`, настраивает подписи, нацеленные на атаки, которые пытаются получить доступ к структурам данных или обойти разрешения, когда веб-сайт использует информацию, предоставленную пользователем, для построения запросов XPath для данных XML.
partition string		По умолчанию: "Common"	Этот параметр используется только при идентификации политики ASM.
policy_name string / обязательно			Указывает имя существующей политики ASM, к которой добавляются или из которой удаляются наборы подписей.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider string		Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр используется при работе с устройствами BIG-IQ.
	no_f5_teem boolean	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Этот параметр можно опустить, установив переменную среды `F5_TEEM`.
	password string / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, установив переменную среды `F5_PASSWORD`. Псевдонимы: pass, pwd
	server string / обязательно		Хост BIG-IP. Этот параметр можно опустить, установив переменную среды `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, установив переменную среды `F5_SERVER_PORT`.
	timeout целое число		Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
	transport string	Варианты: rest ←	Настраивает транспортное соединение для подключения к удалённому устройству.
	user string / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, установив переменную среды `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте этот параметр только на контролируемых вами сайтах, использующих самозаверенные сертификаты. Этот параметр можно опустить, установив переменную среды `F5_VALIDATE_CERTS`.
state string		Варианты: present ← absent	При `present`, гарантирует существование ресурса. При `absent`, гарантирует удаление ресурса.

Примечания

Примечание

Этот модуль используется в основном как компонент настройки политики ASM в роли политики ASM Ansible Galaxy.
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохраняется на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config, для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.

Примеры

- name: Add Signature Set to ASM Policy
  bigip_asm_policy_signature_set:
    name: IIS and Windows Signatures
    policy_name: FooPolicy
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost
- name: Remove Signature Set to ASM Policy
  bigip_asm_policy_signature_set:
    name: IIS and Windows Signatures
    policy_name: FooPolicy
    state: absent
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
alarm boolean	changed	Указывает, регистрирует ли политика безопасности данные запроса на экране Статистики. Пример: True
block boolean	changed	Определяет, как система обрабатывает запросы, соответствующие подписи, включенной в набор подписей.
learn boolean	changed	Указывает, изучает ли политика все запросы, соответствующие подписи, включенной в набор подписей. Пример: True
name string	changed	Имя набора подписей, добавленного/удаленного в политике ASM. Пример: Cisco Signatures
policy_name string	changed	Имя политики ASM Пример: FooPolicy

Авторы

Wojciech Wypior (@wojtek0806)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_asm_policy_signature_set_module.html