f5networks.f5_modules.bigip_firewall_log_profile – Управляет профилями ведения журнала AFM, настроенными в системе
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Чтобы использовать его в плейбуке, укажите: f5networks.f5_modules.bigip_firewall_log_profile.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Обзор
- Управляет профилями ведения журнала AFM (Advanced Firewall Manager), настроенными в системе, а также отображает базовую информацию о каждом профиле.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка | Описание профиля ведения журнала. | ||
| dos_protection словарь | Настройка параметров профиля ведения журнала, связанных с DoS. | ||
| dns_publisher строка | Указывает имя издателя журнала, используемого для событий DNS DoS. Чтобы указать издателя журнала на другой секции, отличной от секции профиля AFM, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае секция издателя журнала определяется из параметра модуля partition. | ||
| network_publisher строка | Указывает имя издателя журнала, используемого для событий сетевых DoS. Чтобы указать издателя журнала на другой секции, отличной от секции профиля AFM, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае секция издателя журнала определяется из параметра модуля partition. | ||
| sip_publisher строка | Указывает имя издателя журнала, используемого для событий SIP DoS. Чтобы указать издателя журнала на другой секции, отличной от секции профиля AFM, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае секция издателя журнала определяется из параметра модуля partition. | ||
| ip_intelligence словарь | Настройка параметров профиля ведения журнала, связанных с IP Intelligence. | ||
| log_publisher строка | Указывает имя издателя журнала, используемого для событий IP Intelligence. Чтобы указать издателя журнала на другой секции, отличной от секции профиля AFM, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае секция издателя журнала определяется из параметра модуля partition. | ||
| log_rtbh логическое значение |
| Если yes, указывает, что события удаленного запуска черного списка регистрируются. | |
| log_shun логическое значение |
| Если yes, указывает, что события списка отклонений IP Intelligence регистрируются.Этот параметр можно установить только для встроенного профиля global-network. | |
| log_translation_fields логическое значение |
| Этот параметр используется для включения или отключения регистрации переведенных (т.е., со стороны сервера) полей в сообщениях журнала IP Intelligence. Переведенные поля включают (но не ограничиваются): исходный адрес/порт, адрес/порт назначения, IP-протокол, домен маршрутизации и VLAN. | |
| rate_limit строка | Определяет предел скорости для всех объединенных сообщений журнала IP intelligence в секунду. При превышении этого предела сообщения журнала не регистрируются до тех пор, пока порог не опустится ниже указанной скорости. Для указания неограниченной скорости используйте значение indefinite.Если вы указываете числовую скорость, значение должно быть между 1 и 4294967295. | ||
| name строка / обязательный | Указывает имя профиля ведения журнала. | ||
| partition строка | Значение по умолчанию: "Common" | Секция устройства для создания профиля ведения журнала. Параметр также используется при указании имен издателей журналов, если имена издателей журналов не указаны в полном пути. | |
| port_misuse словарь | Настройка ведения журнала для случаев злоупотребления портами. | ||
| log_publisher строка | Указывает имя издателя журнала, используемого для событий злоупотребления портами. Чтобы указать издателя журнала на другой секции, отличной от секции профиля AFM, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае секция издателя журнала определяется из параметра модуля partition. | ||
| rate_limit строка | Определяет предел скорости для всех объединенных сообщений журнала злоупотребления портами в секунду. При превышении этого предела сообщения журнала не регистрируются до тех пор, пока порог не опустится ниже указанной скорости. Для указания неограниченной скорости используйте значение indefinite.Если вы указываете числовую скорость, значение должно быть между 1 и 4294967295. | ||
| 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 строка |
| Настраивает транспортное соединение для использования при подключении к удаленному устройству. | |
| user строка / обязательный | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, задав переменную окружения F5_USER. | ||
| validate_certs логическое значение |
| Если no, сертификаты SSL не проверяются. Используйте этот параметр только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, задав переменную окружения F5_VALIDATE_CERTS. | |
| state строка |
| Когда state равен present, гарантирует существование ресурса.Когда state равен absent, гарантирует удаление ресурса. Попытки удалить встроенные системные профили игнорируются, и никакого изменения не возвращается. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы гарантировать, что конфигурация, специфичная для BIG-IP, сохранится на диске, необходимо включить по крайней мере одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create a basic log profile with port misuse
bigip_firewall_log_profile:
name: barbaz
port_misuse:
rate_limit: 30000
log_publisher: local-db-pub
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Change ip_intelligence settings, publisher on different partition, remove port misuse
bigip_firewall_log_profile:
name: barbaz
ip_intelligence:
rate_limit: 400000
log_translation_fields: yes
log_rtbh: yes
log_publisher: "/foobar/non-local-db"
port_misuse:
log_publisher: ""
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Create a log profile with dos protection, different partition
bigip_firewall_log_profile:
name: foobar
partition: foobar
dos_protection:
dns_publisher: "/Common/local-db-pub"
sip_publisher: "non-local-db"
network_publisher: "/Common/local-db-pub"
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Remove log profile
bigip_firewall_log_profile:
name: barbaz
partition: Common
state: absent
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| description строка | changed | Новое описание профиля логов AFM. Пример: Это мое описание | |
| dos_protection сложный тип | changed | Используемые издатели логов в настройках профиля логов, связанных с DoS. Пример: хеш/словарь значений | |
| dns_publisher строка | changed | Имя издателя логов, используемого для событий DoS DNS. Пример: /Common/local-db-publisher | |
| network_publisher строка | changed | Имя издателя логов, используемого для сетевых событий DoS. Пример: /Common/local-db-publisher | |
| sip_publisher строка | changed | Имя издателя логов, используемого для событий DoS SIP. Пример: /Common/local-db-publisher | |
| ip_intelligence сложный тип | changed | Настройки профиля логов, связанные с IP Intelligence. Пример: хеш/словарь значений | |
| log_publisher строка | changed | Имя издателя логов, используемого для событий IP Intelligence. Пример: /Common/local-db-publisher | |
| log_rtbh логическое значение | changed | Ведение журнала событий удалённого срабатывания блокировки. Пример: True | |
| log_shun логическое значение | changed | Ведение журнала событий списка отклонения IP Intelligence. | |
| log_translation_fields логическое значение | changed | Ведение журнала переведённых полей в сообщениях логов IP Intelligence. | |
| rate_limit строка | changed | Предел скорости для всех объединённых сообщений логов IP intelligence в секунду. Пример: неопределённый | |
| port_misuse сложный тип | changed | Настройки профиля логов, связанные с ненадлежащим использованием портов. Пример: хеш/словарь значений | |
| log_publisher строка | changed | Имя издателя логов, используемого для событий ненадлежащего использования портов. Пример: /Common/local-db-publisher | |
| rate_limit строка | changed | Предел скорости для всех объединённых сообщений логов ненадлежащего использования портов в секунду. Пример: неопределённый | |
Авторы
- 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_firewall_log_profile_module.html
