Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigip_device_httpd — управление настройками HTTPD в системе BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install f5networks.f5_modules. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: f5networks.f5_modules.bigip_device_httpd.

Добавлено в f5networks.f5_modules 1.0.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

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

Требования

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

  • requests

Параметры

Параметр

Комментарии

allow

list / elements=string

Если доступ HTTPD включен, задает IP-адрес или диапазон адресов других систем, которым разрешено взаимодействовать с этой системой.

Чтобы указать все адреса, используйте значение all.

Можно указать IP-адрес, например 172.27.1.10.

Можно указать диапазоны IP-адресов, например 172.27.*.* или 172.27.0.0/255.255.0.0.

auth_name

string

Задает имя области аутентификации BIG-IP.

auth_pam_dashboard_timeout

boolean

Задает, будет ли истекать время ожидания панели мониторинга BIG-IP.

Варианты:

  • false
  • true

auth_pam_idle_timeout

integer

Задает время ожидания GUI до автоматического выхода из системы в секундах.

auth_pam_validate_ip

boolean

Задает параметр authPamValidateIp.

Варианты:

  • false
  • true

fast_cgi_timeout

integer

Задает время ожидания FastCGI.

hostname_lookup

boolean

Задает, отображать ли имя хоста, если это возможно.

Варианты:

  • false
  • true

log_level

string

Задает минимальный уровень журналирования HTTPD.

Варианты:

  • "alert"
  • "crit"
  • "debug"
  • "emerg"
  • "error"
  • "info"
  • "notice"
  • "warn"

max_clients

integer

Задает максимальное количество клиентов, которые могут одновременно подключаться к GUI.

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Объект dict, содержащий сведения о подключении.

auth_provider

string

Настраивает поставщика аутентификации, используемого для получения токенов аутентификации с удаленного устройства.

Этот параметр используется главным образом при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если yes, телеметрические данные TEEM не отправляются в F5.

Этот параметр можно не указывать, задав переменную среды F5_TELEMETRY_OFF.

Ранее использовавшаяся переменная F5_TEEM устарела, так как ее название было неоднозначным.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

string / обязательный

Пароль учетной записи, используемой для подключения к BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную среды F5_PASSWORD.

server

string / обязательный

Узел BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную среды F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Этот параметр можно не указывать, задав переменную среды F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Задает время ожидания в секундах при взаимодействии с сетевым устройством: при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.

transport

string

Настраивает транспортное подключение для соединения с удаленным устройством.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательный

Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве.

Этот параметр можно не указывать, задав переменную среды F5_USER.

validate_certs

boolean

Если no, SSL-сертификаты не проверяются. Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами.

Этот параметр можно не указывать, задав переменную среды F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

redirect_http_to_https

boolean

Определяет, перенаправлять ли HTTP-запросы к GUI на HTTPS.

Варианты:

  • false
  • true

ssl_cipher_suite

any

Задает используемые системой шифры.

Значения в наборе разделяются двоеточиями (:).

Можно указать строку или список. Рекомендуется задавать набор шифров в виде списка. Примеры использования см. в разделе «Примеры».

Чтобы задать набор шифров по умолчанию для системы, используйте значение 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

integer

Порт HTTPS, на котором система должна ожидать подключения.

ssl_protocols

any

Список протоколов SSL, принимаемых на консоли управления.

Список токенов, разделенных пробелами, в формате, поддерживаемом директивой Apache mod_ssl SSLProtocol.

Можно указать строку или список. Рекомендуется задавать набор шифров в виде списка. Примеры использования см. в разделе «Примеры».

Чтобы задать протоколы SSL по умолчанию для системы, используйте значение default. Оно эквивалентно указанию списка 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: false
    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

string

Новое имя области аутентификации.

Возвращается: при изменении

Пример: "foo"

auth_pam_dashboard_timeout

boolean

Определяет, будет ли истекать время ожидания панели мониторинга BIG-IP.

Возвращается: при изменении

Пример: false

auth_pam_idle_timeout

string

Новое время ожидания GUI в секундах.

Возвращается: при изменении

Пример: "1200"

auth_pam_validate_ip

boolean

Новое значение параметра authPamValidateIp.

Возвращается: при изменении

Пример: true

fast_cgi_timeout

integer

Новое время ожидания FastCGI.

Возвращается: при изменении

Пример: 500

hostname_lookup

boolean

Определяет, отображать ли имя хоста, если это возможно.

Возвращается: при изменении

Пример: true

log_level

string

Новый минимальный уровень журналирования HTTPD.

Возвращается: при изменении

Пример: "crit"

max_clients

integer

Новое максимальное количество клиентов, которые могут одновременно подключаться к GUI.

Возвращается: при изменении

Пример: 20

redirect_http_to_https

boolean

Определяет, перенаправлять ли HTTP-запросы к GUI на HTTPS.

Возвращается: при изменении

Пример: true

ssl_cipher_suite

string

Новые шифры, используемые системой.

Возвращается: при изменении

Пример: "ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA"

ssl_cipher_suite_list

string

Список новых шифров, используемых системой.

Возвращается: при изменении

Пример: "['ECDHE-RSA-AES256-GCM-SHA384', 'ECDHE-RSA-AES128-SHA']"

ssl_port

integer

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

Возвращается: при изменении

Пример: 10443

ssl_protocols

string

Новый список протоколов SSL, принимаемых на консоли управления.

Возвращается: при изменении

Пример: "all -SSLv2 -SSLv3"

Авторы

  • Joe Reifel (@JoeReifel)
  • Tim Rupp (@caphrim007)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API