f5networks.f5_modules.bigip_asm_dos_application – Управление параметрами приложения для профиля DOS

Примечание

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

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

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

Новое в версии 1.0.0: модуля f5networks.f5_modules

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

Обзор

Управляет параметрами приложения для профиля DOS ASM/AFM.

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
geolocations словарь				Управляет белым и черным списками стран геолокации.
	blacklist список / элементы=строка			Список стран, которые нужно поместить в черный список, не должно быть перекрывающихся элементов с `whitelist`.
	whitelist список / элементы=строка			Список стран, которые нужно поместить в белый список, не должно быть перекрывающихся элементов с `blacklist`.
heavy_urls словарь				Управление защитой от тяжелых URL-адресов. Тяжелые URL-адреса — это небольшое количество URL-адресов сайта, которые могут потреблять значительные ресурсы сервера на запрос.
	auto_detect булево		Варианты: нет да	Включает или отключает автоматическое обнаружение тяжелых URL-адресов.
	exclude список / элементы=строка			Указывает список URL-адресов или подстановочных знаков, которые нужно исключить из тяжелых URL-адресов.
	include список / элементы=словарь			Настраивает дополнительные URL-адреса для включения в тяжелые URL-адреса, которые были автоматически обнаружены.
		threshold строка		Указывает порог запросов в секунду, когда URL считается атакованным. Допустимый диапазон — от 1 до 4294967295 включительно, или `auto`.
		url строка / обязательно		Указывает URL-адрес, который нужно добавить в список тяжелых URL-адресов в дополнение к автоматически обнаруженным.
	latency_threshold целое число			Указывает порог задержки для автоматического обнаружения тяжелых URL-адресов. Допустимый диапазон — от 0 до 4294967295 миллисекунд включительно.
mobile_detection словарь				Настраивает обнаружение мобильных приложений, созданных с помощью Anti-Bot Mobile SDK, и определяет, как обрабатываются запросы от клиентов этих мобильных приложений.
	allow_android_rooted_device булево		Варианты: нет да	Когда `yes`, устройство будет разрешать трафик от рутированных устройств Android.
	allow_any_android_package булево		Варианты: нет да	Когда `yes`, разрешает любого издателя приложений. Издатель определяется сертификатом, используемым для подписания приложения.
	allow_any_ios_package булево		Варианты: нет да	Когда `yes`, разрешает любой пакет iOS. Имя пакета — уникальный идентификатор мобильного приложения.
	allow_emulators булево		Варианты: нет да	Когда `yes`, разрешает трафик от приложений, запущенных в эмуляторах.
	allow_jailbroken_devices булево		Варианты: нет да	Когда `yes`, разрешает трафик от джейлбрейкнутых устройств iOS.
	android_publishers список / элементы=строка			Этот параметр не имеет эффекта, когда `allow_any_android_package` установлен на `yes`. Указывает разрешенные сертификаты издателей для приложений Android. Сертификат издателя должен быть установлен на BIG-IP предварительно. Имя сертификата, расположенное в другом разделе, чем тот, что указан в `partition` параметре, должен быть предоставлен в формате `full_path`, например, `/Foo/cert.crt`.
	client_side_challenge_mode строка		Варианты: pass cshui	Действие, которое необходимо предпринять, когда необходимо отобразить капчу или вызов целостности клиента. Пользователь мобильного приложения не увидит вызов капчи, и мобильному приложению не будет представлен вызов целостности клиента. Такие варианты для мобильных приложений — `pass` или `cshui`. Когда `pass`, трафик проходит без инцидентов. Когда `cshui`, SDK проверяет наличие взаимодействий человека с экраном в последние несколько секунд. Если ничего не обнаружено, трафик блокируется.
	enabled булево		Варианты: нет да	Когда `yes`, запросы от мобильных приложений, созданных с помощью Anti-Bot Mobile SDK, будут обнаружены и обработаны в соответствии с установленными параметрами. Когда `no`, эти запросы будут обрабатываться как любые другие запросы, что может привести к атакам или ложным срабатываниям.
	ios_allowed_package_names список / элементы=строка			Указывает имена пакетов iOS, для которых разрешен трафик. Этот параметр не имеет эффекта, когда `allow_any_ios_package` установлен на `yes`.
partition строка			По умолчанию: "Общие"	Раздел устройства для управления ресурсами.
profile строка / обязательно				Указывает имя профиля для управления настройками приложений.
provider словарь добавлен в 1.0.0 f5networks.f5_modules				Объект словаря, содержащий данные подключения.
	auth_provider строка			Настраивает поставщика аутентификации для получения маркеров аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem булево		Варианты: нет да	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную среды `F5_TEEM`.
	password строка / обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port целое число		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	timeout целое число			Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку.
	transport строка		Варианты: rest ←	Настраивает транспортное соединение, используемое при подключении к удаленному устройству.
	user строка / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs булево		Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на сайтах, контролируемых вами лично, с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
rtbh_duration целое число				Указывает продолжительность объявления маршрута RTBH BGP в секундах. Допустимый диапазон — от 0 до 4294967295 включительно.
rtbh_enable булево			Варианты: нет да	Указывает, нужно ли включить удаленное запуск черной дыры `RTBH` атакующих IP-адресов путем объявления маршрутов BGP.
scrubbing_duration целое число				Указывает продолжительность объявления маршрута очистки трафика BGP в секундах. Допустимый диапазон — от 0 до 4294967295 включительно.

END_OF_DOCUMENT_MARKER

scrubbing_enable boolean	Варианты: no yes	Указывает, следует ли включить Traffic Scrubbing во время атак, рекламируя маршруты BGP.
single_page_application boolean	Варианты: no yes	Указывает, что система поддерживает приложения Single Page Application, когда `yes`.
state string	Варианты: present ← absent	Когда `state` является `present`, гарантирует, что объект Application существует. Когда `state` является `absent`, гарантирует удаление объекта Application.
trigger_irule boolean	Варианты: no yes	Указывает, что система активирует событие iRule Application DoS, когда `yes`.

Примечания

Примечание

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

Примеры

- name: Create an ASM dos application profile
  bigip_asm_dos_application:
    profile: dos_foo
    geolocations:
      blacklist:
        - Afghanistan
        - Andora
      whitelist:
        - Cuba
    heavy_urls:
      auto_detect: yes
      latency_threshold: 1000
    rtbh_duration: 3600
    rtbh_enable: yes
    single_page_application: yes
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Update an ASM dos application profile
  bigip_asm_dos_application:
    profile: dos_foo
    mobile_detection:
      enabled: yes
      allow_any_ios_package: yes
      allow_emulators: yes
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Remove an ASM dos application profile
  bigip_asm_dos_application:
    profile: dos_foo
    state: absent
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ			Возвращаемое значение	Описание
geolocations complex			changed	Указывает белый и черный списки стран геолокаций. Пример: хеш/словарь значений
	blacklist list / elements=string		changed	Список стран для добавления в черный список. Пример: ['Россия', 'Германия']
	whitelist list / elements=string		changed	Список стран для добавления в белый список. Пример: ['Соединенные Штаты, Соединенное Королевство']
heavy_urls complex			changed	Управляет защитой Heavy URL. Пример: хеш/словарь значений
	auto_detect boolean		changed	Включает или выключает автоматическое обнаружение тяжелых URL. Пример: True
	exclude list / elements=string		changed	Указывает список URL-адресов или шаблонов для исключения из тяжелых URL. Пример: ['/exclude.html', '/exclude2.html']
	include complex		changed	Настраивает дополнительные URL-адреса для включения в тяжелые URL. Пример: хеш/словарь значений
		threshold string	changed	Порог запросов в секунду. Пример: auto
		url string	changed	URL-адрес, который нужно добавить в список тяжелых URL. Пример: /include.html
	latency_threshold integer		changed	Указывает порог задержки для автоматического обнаружения тяжелых URL. Пример: 2000
mobile_detection complex			changed	Настраивает обнаружение мобильных приложений, созданных с помощью Anti-Bot Mobile SDK. Пример: хеш/словарь значений
	allow_android_rooted_device boolean		changed	Разрешает трафик с укорененных устройств Android.
	allow_any_android_package boolean		changed	Разрешает любого издателя приложений.
	allow_any_ios_package boolean		changed	Разрешает любые пакеты iOS. Пример: True
	allow_emulators boolean		changed	Разрешает трафик с приложений, запущенных на эмуляторах. Пример: True
	allow_jailbroken_devices boolean		changed	Разрешает трафик с джейлбрейк iOS устройств.
	android_publishers list / elements=string		changed	Разрешенные издатели сертификатов для приложений Android. Пример: ['/Common/cert1.crt', '/Common/cert2.crt']
	client_side_challenge_mode string		changed	Действие, которое нужно выполнить, когда необходимо отобразить CAPTCHA или вызов проверки целостности клиента. Пример: pass
	enable boolean		changed	Включает или отключает автоматическое обнаружение мобильных устройств. Пример: True
	ios_allowed_package_names list / elements=string		changed	Имена пакетов iOS, для которых разрешен трафик. Пример: ['package1', 'package2']
rtbh_duration integer			changed	Срок действия объявления маршрута RTBH BGP. Пример: 3600
rtbh_enable boolean			changed	Включает удаленное триггерное создание черных дыр для атакующих IP-адресов.
scrubbing_duration integer			changed	Срок действия объявления маршрута Traffic Scrubbing BGP. Пример: 3600
scrubbing_enable boolean			changed	Включает Traffic Scrubbing во время атак. Пример: True
single_page_application boolean			changed	Включает поддержку приложений Single Page Applications.
trigger_irule boolean			changed	Активирует событие iRule Application DoS. Пример: True

Авторы

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