bigiq_application_https_waf – Управляет приложениями BIG-IQ HTTPS WAF

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

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

Обзор

Управляет приложениями BIG-IQ, используемыми для балансировки нагрузки HTTPS-приложения на порту 443 с межсетевым экраном веб-приложений (WAF) с использованием политики развертывания ASM Rapid.

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
add_analytics boolean			Варианты: нет ← да	Собирает статистику BIG-IP, на котором развернуто приложение. Этот параметр актуален только при указании `service_environment`, представляющего BIG-IP, а не SSG.
client_ssl_profile словарь				Указывает профиль SSL для управления трафиком SSL на стороне клиента.
	cert_key_chain сырые данные			Один или несколько сертификатов и ключей для ассоциации с профилем SSL. Этот параметр всегда представляет список. Ключи в списке определяют детали комбинации клиент/ключ/цепочка/пароль. Обратите внимание, что BIG-IP может иметь только по одному экземпляру каждого типа сертификата/ключа. Это означает, что вы можете иметь только один RSA, один DSA и один ECDSA на профиль. Если вы попытаетесь назначить две комбинации RSA, DSA или ECDSA сертификат/ключ, устройство отклонит это. Этот список — сложный список, определяющий ряд ключей. При создании нового профиля, если этот параметр не указан, будет использоваться значение по умолчанию `inherit`.
		cert строка / обязательно		Указывает имя сертификата для использования.
		chain строка		Указывает цепочку сертификатов, относящуюся к указанному ранее сертификату и ключу. Этот ключ необязателен.
		key строка / обязательно		Указывает имя ключа.
		passphrase строка		Содержит пароль к файлу ключа, если он требуется. Пароли шифруются на удалённом устройстве BIG-IP.
	name строка			Имя профиля SSL клиента, которое будет создано и использовано. При создании нового приложения, если это значение не указано, будет использовано значение по умолчанию `clientssl`.
description строка				Описание приложения.
domain_names список				Указывает имена хостов, используемые для доступа к веб-приложению, защищаемому этой политикой безопасности. Этот параметр обязателен при создании нового приложения.
inbound_virtual словарь				Настройки для настройки виртуального сервера, который будет принимать входящие подключения. Этот виртуальный сервер будет использоваться для размещения HTTPS-точки входа приложения. Трафик, предназначенный для `redirect_virtual`, будет перенаправлен на этот параметр для обеспечения правильного перенаправления от небезопасного к защищённому протоколу.
	address строка			Указывает информацию об IP-адресе назначения, куда виртуальный сервер отправляет трафик. Этот параметр обязателен при создании нового приложения.
	netmask строка			Указывает маску сети для ассоциации с данным `destination`. Этот параметр обязателен при создании нового приложения.
	port строка		Значение по умолчанию: 443	Порт, на котором виртуальный сервер ожидает подключения. При создании нового приложения, если этот параметр не указан, будет использовано значение по умолчанию `443`.
name строка / обязательно				Имя нового приложения.
password строка / обязательно				Пароль учётной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
provider словарь добавлен в 2.5				Объект словаря, содержащий данные подключения.
	password строка / обязательно			Пароль учётной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port целое число		Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	ssh_keyfile путь			Указывает файл SSH-ключа для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Вы можете опустить этот параметр, установив переменную среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Значение по умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернёт ошибку.
	transport строка		Варианты: cli rest ←	Настраивает транспортное соединение для подключения к удалённому устройству.
	user строка / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs boolean		Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
redirect_virtual словарь				Настройки для настройки виртуального сервера, который будет принимать перенаправленное соединение. Этот виртуальный сервер будет использоваться для размещения HTTP-точки входа приложения. Трафик, предназначенный для этого параметра, будет перенаправлен на параметр `inbound_virtual` для обеспечения правильного перенаправления от небезопасного к защищённому протоколу.
	address строка			Указывает информацию об IP-адресе назначения, куда виртуальный сервер отправляет трафик. Этот параметр обязателен при создании нового приложения.
	netmask строка			Указывает маску сети для ассоциации с данным `destination`. Этот параметр обязателен при создании нового приложения.
	port строка		Значение по умолчанию: 80	Порт, на котором виртуальный сервер ожидает подключения. При создании нового приложения, если этот параметр не указан, будет использовано значение по умолчанию `80`.

сервер строка / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
сервер_порт целое число добавлено в 2.2		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
серверы список			Список серверов, на которых размещено приложение. Если вы знакомы с другими настройками BIG-IP, вы также можете рассматривать этот список как список членов пула. При создании нового приложения требуется как минимум один сервер.
	адрес строка		IP-адрес сервера.
	порт строка	По умолчанию: 80	Порт сервера.
среда_сервиса строка			Указывает имя среды сервиса, в которой будет развернуто приложение. При создании нового приложения этот параметр обязателен.
состояние строка		Варианты: absent present ←	Состояние ресурса в системе. Когда `present`, гарантирует, что ресурс существует с предоставленными атрибутами. Когда `absent`, удаляет ресурс из системы.
пользователь строка / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
проверять_сертификаты логическое значение добавлено в 2.0		Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
ждать логическое значение		Варианты: no yes ←	Если модуль должен ждать создания, удаления или обновления приложения.

Примечания

Примечание

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

Примеры

- name: Load balance an HTTPS application on port 443 with a WAF using ASM
  bigiq_application_https_waf:
    name: my-app
    description: Redirect HTTP to HTTPS via WAF
    service_environment: my-ssg
    servers:
      - address: 1.2.3.4
        port: 8080
      - address: 5.6.7.8
        port: 8080
    inbound_virtual:
      address: 2.2.2.2
      netmask: 255.255.255.255
      port: 443
    redirect_virtual:
      address: 2.2.2.2
      netmask: 255.255.255.255
      port: 80
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
    state: present
  delegate_to: localhost

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

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

Ключ		Возвращаемое значение	Описание
описание строка		changed	Новое описание приложения ресурса. Пример: Мое приложение
входящая_виртуальная_цель строка		changed	Цель виртуального ресурса, который был создан. Пример: 6.7.8.9
входящая_виртуальная_маска строка		changed	Маска сети предоставленного входящего назначения. Пример: 255.255.255.0
входящий_виртуальный_порт целое число		changed	Порт, на котором прослушивает входящий виртуальный адрес. Пример: 80
серверы сложное		changed	Список серверов и их портов, составляющих приложение. Пример: хеш/словарь значений
	адрес строка	changed	IP-адрес сервера. Пример: 2.3.4.5
	порт целое число	changed	Порт, на котором прослушивает сервер. Пример: 8080
среда_сервиса строка		changed	Среда, в которой был развернут сервис. Пример: my-ssg1

Статус

Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается партнером Ansible. [сертифицированно]

Авторы

Tim Rupp (@caphrim007)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/bigiq_application_https_waf_module.html