bigip_device_httpd – Manage HTTPD related settings on a BIG-IP system — Ansible 2.10

Примечание

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

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

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

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

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

Обзор

Управляет настройками HTTPD на BIG-IP. Эти настройки полезны, когда необходимо установить таймауты интерфейса пользователя и другие настройки, связанные с TMUI.

Требования

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

requests

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
allow список / элементы=строка			Если доступ HTTPD включен, указывает IP-адрес или диапазон адресов для других систем, которые могут взаимодействовать с этой системой. Для указания всех адресов используйте значение `all`. Можно указать IP-адрес, например 172.27.1.10. Можно указать диапазон IP-адресов, например 172.27.. или 172.27.0.0/255.255.0.0.
auth_name строка			Устанавливает имя области аутентификации BIG-IP.
auth_pam_dashboard_timeout логическое значение		Варианты: no yes	Устанавливает, будет ли таймаут панели управления BIG-IP.
auth_pam_idle_timeout целое число			Устанавливает таймаут интерфейса пользователя для автоматического выхода, в секундах.
auth_pam_validate_ip логическое значение		Варианты: no yes	Устанавливает значение authPamValidateIp.
fast_cgi_timeout целое число			Устанавливает таймаут FastCGI.
hostname_lookup логическое значение		Варианты: no yes	Устанавливает, будет ли отображаться имя хоста, если возможно.
log_level строка		Варианты: alert crit debug emerg error info notice warn	Устанавливает минимальный уровень логирования HTTPD.
max_clients целое число			Устанавливает максимальное количество клиентов, которые могут одновременно подключиться к интерфейсу пользователя.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные соединения.
	auth_provider строка		Настраивает поставщик аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem логическое значение	Варианты: no yes	Если `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 yes ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов. Вы можете опустить этот параметр, задав переменную окружения `F5_VALIDATE_CERTS`.
redirect_http_to_https логическое значение		Варианты: no yes	Перенаправлять ли запросы HTTP в интерфейс пользователя на HTTPS.
ssl_cipher_suite сырые данные			Указывает наборы шифров, используемые системой. Значения в наборе разделены двоеточием (:). Можно указать в виде строки или списка. Рекомендуется использовать список. См. примеры использования. Используйте значение `default` для установки набора шифров по умолчанию системы. Это значение эквивалентно указанию списка `ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384,ECDHE-RSA-AES128-SHA,ECDHE-RSA-AES256-SHA, ECDHE-RSA-AES128-SHA256,ECDHE-RSA-AES256-SHA384,ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES128-SHA,ECDHE-ECDSA-AES256-SHA, ECDHE-ECDSA-AES128-SHA256,ECDHE-ECDSA-AES256-SHA384,AES128-GCM-SHA256, AES256-GCM-SHA384,AES128-SHA,AES256-SHA,AES128-SHA256,AES256-SHA256, ECDHE-RSA-DES-CBC3-SHA,ECDHE-ECDSA-DES-CBC3-SHA,DES-CBC3-SHA`.
ssl_port целое число			Порт HTTPS, на котором система должна прослушивать.
ssl_protocols сырые данные			Список протоколов SSL, принимаемых на консоли управления. Список значений, разделённых пробелами, в формате, принятом в директиве Apache mod_ssl SSLProtocol. Можно указать в виде строки или списка. Рекомендуется использовать список. См. примеры использования. Используйте значение `default` для установки протоколов SSL по умолчанию системы. Это значение эквивалентно указанию списка `all,-SSLv2,-SSLv3`.

Примечания

Примечание

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

Примеры

- name: Set the BIG-IP authentication realm name
  bigip_device_httpd:
    auth_name: BIG-IP
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Set the auth pam timeout to 3600 seconds
  bigip_device_httpd:
    auth_pam_idle_timeout: 1200
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Set the validate IP settings
  bigip_device_httpd:
    auth_pam_validate_ip: on
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Set SSL cipher suite by list
  bigip_device_httpd:
    ssl_cipher_suite:
      - ECDHE-RSA-AES128-GCM-SHA256
      - ECDHE-RSA-AES256-GCM-SHA384
      - ECDHE-RSA-AES128-SHA
      - AES256-SHA256
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Set SSL cipher suite by string
  bigip_device_httpd:
    ssl_cipher_suite: ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA:AES256-SHA256
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Set SSL protocols by list
  bigip_device_httpd:
    ssl_protocols:
      - all
      - -SSLv2
      - -SSLv3
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Set SSL protocols by string
  bigip_device_httpd:
    ssl_protocols: all -SSLv2 -SSLv3
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ	Возвращаемое	Описание
auth_name строка	изменено	Новое имя домена аутентификации. Пример: foo
auth_pam_dashboard_timeout логическое	изменено	Указывает, будет ли время ожидания панели мониторинга BIG-IP истекать.
auth_pam_idle_timeout строка	изменено	Новое значение времени ожидания интерфейса (в секундах). Пример: 1200
auth_pam_validate_ip логическое	изменено	Новое значение параметра authPamValidateIp. Пример: True
fast_cgi_timeout целое число	изменено	Новое время ожидания FastCGI. Пример: 500
hostname_lookup логическое	изменено	Указывает, будет ли отображаться имя хоста, если это возможно. Пример: True
log_level строка	изменено	Новый минимальный уровень логирования HTTPD. Пример: crit
max_clients целое число	изменено	Новое максимальное количество клиентов, которые могут одновременно подключиться к интерфейсу. Пример: 20
redirect_http_to_https логическое	изменено	Указывает, будет ли перенаправляться HTTP-запрос на интерфейс на HTTPS. Пример: True
ssl_cipher_suite строка	изменено	Новые шифры, используемые системой. Пример: ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA
ssl_cipher_suite_list строка	изменено	Список новых шифров, используемых системой. Пример: ['ECDHE-RSA-AES256-GCM-SHA384', 'ECDHE-RSA-AES128-SHA']
ssl_port целое число	изменено	Новый HTTPS-порт для прослушивания. Пример: 10443
ssl_protocols строка	изменено	Новый список SSL-протоколов, которые принимаются на консоли управления. Пример: all -SSLv2 -SSLv3

Авторы

Joe Reifel (@JoeReifel)
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.10/collections/f5networks/f5_modules/bigip_device_httpd_module.html