bigip_firewall_log_profile – Управляет профилями ведения журнала AFM, настроенными в системе
Новая в версии 2.9.
Описание
- Управляет профилями ведения журнала AFM, настроенными в системе, вместе с базовой информацией о каждом профиле.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка | Описание профиля логов. | ||
| dos_protection словарь | Настройка параметров профиля логов, связанных с DoS. | ||
| dns_publisher строка | Указывает имя издателя логов, используемого для событий DNS DoS. Для указания log_publisher в другом разделе, отличном от AFM профиля логов, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае раздел для log_publisher определяется по параметру модуля partition. | ||
| network_publisher строка | Указывает имя издателя логов, используемого для событий DoS Сеть. Для указания log_publisher в другом разделе, отличном от AFM профиля логов, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае раздел для log_publisher определяется по параметру модуля partition. | ||
| sip_publisher строка | Указывает имя издателя логов, используемого для событий SIP DoS. Для указания log_publisher в другом разделе, отличном от AFM профиля логов, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае раздел для log_publisher определяется по параметру модуля partition. | ||
| ip_intelligence словарь | Настройка параметров профиля логов, связанных с IP Intelligence. | ||
| log_publisher строка | Указывает имя издателя логов, используемого для событий IP Intelligence. Для указания log_publisher в другом разделе, отличном от AFM профиля логов, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае раздел для log_publisher определяется по параметру модуля partition. | ||
| log_rtbh булево |
| Указывает, когда yes, что события удалённого триггерного blackholing регистрируются. | |
| log_shun булево |
| Указывает, когда yes, что события списка IP Intelligence shun регистрируются.Этот параметр можно задать только для встроенного профиля global-network. | |
| log_translation_fields булево |
| Этот параметр используется для включения или выключения регистрации переведённых (т.е. на стороне сервера) полей в сообщениях логов IP Intelligence. Переведённые поля включают (но не ограничиваются) исходный адрес/порт, адрес/порт назначения, протокол IP, домен маршрута и VLAN. | |
| rate_limit строка | Определяет ограничение скорости для всех объединённых сообщений логов IP intelligence в секунду. По достижении этого ограничения сообщения логов не регистрируются, пока порог не опустится ниже заданной скорости. Для указания неограниченной скорости используйте значение indefinite. Если указывается числовая скорость, значение должно быть между 1 и 4294967295. | ||
| name строка / обязательно | Указывает имя профиля логов. | ||
| partition строка | Значение по умолчанию: "Общие" | Раздел устройства для создания профиля логов. Параметр также используется при указании имён издателей логов, если имена издателей логов не указаны в формате полного пути. | |
| port_misuse словарь | Настройка логов Порт Неправильное использование. | ||
| log_publisher строка | Указывает имя издателя логов, используемого для событий Неправильное использование порта. Для указания log_publisher в другом разделе, отличном от AFM профиля логов, укажите имя в формате полного пути, например /Foobar/log-publisher, в противном случае раздел для log_publisher определяется по параметру модуля partition. | ||
| rate_limit строка | Определяет ограничение скорости для всех объединённых сообщений логов неправильного использования порта в секунду. По достижении этого ограничения сообщения логов не регистрируются, пока порог не опустится ниже заданной скорости. Для указания неограниченной скорости используйте значение indefinite. Если указывается числовая скорость, значение должно быть между 1 и 4294967295. | ||
| provider словарь добавлен в 2.5 | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика авторизации для получения маркеров авторизации от удалённого устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| 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 целое число | Устанавливает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истечёт до завершения операции, модуль выдаст ошибку. | ||
| 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, сохранится на диске, обязательно включите по крайней мере одну задачу, использующую модуль 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 | Имя издателя журнала, используемого для событий DNS DoS. Пример: /Common/local-db-publisher | |
| network_publisher строка | changed | Имя издателя журнала, используемого для событий сетевого DoS. Пример: /Common/local-db-publisher | |
| sip_publisher строка | changed | Имя издателя журнала, используемого для событий SIP DoS. Пример: /Common/local-db-publisher | |
| ip_intelligence сложный тип | changed | Настройки, связанные с IP Intelligence, в профиле журнала. Пример: хеш/словарь значений | |
| log_publisher строка | changed | Имя издателя журнала, используемого для событий IP Intelligence. Пример: /Common/local-db-publisher | |
| log_rtbh логический тип | changed | Ведение журнала событий удалённого запуска blackholing. Пример: True | |
| log_shun логический тип | changed | Ведение журнала событий списка IP Intelligence shun. | |
| log_translation_fields логический тип | changed | Ведение журнала переведённых полей в сообщениях журнала IP Intelligence. | |
| rate_limit строка | changed | Предел скорости для всех объединённых сообщений журнала IP Intelligence в секунду. Пример: неограниченно | |
| port_misuse сложный тип | changed | Настройки, связанные с использованием неправильных портов, в профиле журнала. Пример: хеш/словарь значений | |
| log_publisher строка | changed | Имя издателя журнала, используемого для событий неправильного использования портов. Пример: /Common/local-db-publisher | |
| rate_limit строка | changed | Предел скорости для всех объединённых сообщений журнала о неправильном использовании портов в секунду. Пример: неограниченно | |
Статус
- Данному модулю не гарантируется обратная совместимость. [preview]
- Этот модуль поддерживается партнёром Ansible. [certified]
Авторы
- 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.9/modules/bigip_firewall_log_profile_module.html
