Модуль f5networks.f5_modules.bigip_firewall_global_rules — управление глобальными параметрами правил AFM на 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_firewall_global_rules.

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

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

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

Настраивает глобальные правила сетевого брандмауэра в AFM (Advanced Firewall Manager). Эти правила брандмауэра применяются ко всем пакетам, кроме проходящих через интерфейс управления. Они применяются в первую очередь, до любых правил брандмауэра для виртуального сервера, домена маршрутизации и/или собственного IP-адреса пакета.

Параметры

Параметр	Комментарии
description строка	Описание глобального списка правил брандмауэра.
enforced_policy строка	Указывает политику брандмауэра, применяемую принудительно. Правила `enforced_policy` применяются принудительно глобально.
provider словарь добавлено в f5networks.f5_modules 1.0.0	Объект dict, содержащий сведения о подключении.
auth_provider строка	Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem логическое значение	Если задано `yes`, данные телеметрии TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную окружения `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` устарела, поскольку её название было неоднозначным. Допустимые значения: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd строка / обязательный	Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения `F5_PASSWORD`.
server строка / обязательный	Узел BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения `F5_SERVER`.
server_port целое число	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную окружения `F5_SERVER_PORT`. По умолчанию: `443`
timeout целое число	Задаёт время ожидания в секундах при подключении к сетевому устройству или отправке ему команд. Если время ожидания истечёт до завершения операции, модуль завершится с ошибкой.
transport строка	Настраивает транспортное подключение, используемое при подключении к удалённому устройству. Допустимые значения: `"rest"` ← (по умолчанию)
user строка / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную окружения `F5_USER`.
validate_certs логическое значение	Если задано `no`, SSL-сертификаты не проверяются. Используйте этот параметр только на контролируемых вами сайтах с самоподписанными сертификатами. Этот параметр можно не указывать, задав переменную окружения `F5_VALIDATE_CERTS`. Допустимые значения: `false` `true` ← (по умолчанию)
service_policy строка	Указывает политику обслуживания, которая будет применяться к трафику глобально. Политика обслуживания применяется ко всем потокам, если только её не переопределяют другие настройки политики обслуживания, заданные для конкретного контекста. Например, если политика обслуживания настроена как на глобальном уровне, так и в правиле брандмауэра, а поток соответствует этому правилу, более конкретная настройка политики в правиле переопределяет глобальную настройку политики обслуживания. Связанную здесь политику обслуживания можно создать с помощью модуля `bigip_service_policy`.
staged_policy строка	Указывает промежуточную политику брандмауэра. Правила `staged_policy` не применяются принудительно, при этом все функции контроля видимости (статистика, отчётность и ведение журналов) работают так, как если бы правила промежуточной политики применялись глобально.

Примечания

Примечание

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

Примеры

- name: Change enforced policy in AFM global rules
  bigip_firewall_global_rules:
    enforced_policy: enforcing1
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Возвращаемые значения

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

Ключ	Описание
description строка	Новое описание. Возвращается: при изменении Пример: `"My description"`
enforced_policy строка	Новая глобальная принудительно применяемая политика. Возвращается: при изменении Пример: `"/Common/enforced1"`
service_policy строка	Новая глобальная политика обслуживания. Возвращается: при изменении Пример: `"/Common/service1"`
staged_policy строка	Новая глобальная промежуточная политика. Возвращается: при изменении Пример: `"/Common/staged1"`

Авторы

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