Модуль f5networks.f5_modules.bigip_firewall_address_list – Управление списками адресов в BIG-IP AFM

address_lists

list / elements=string

Простой список существующих списков адресов, которые нужно добавить в этот список. Списки адресов можно указывать как с полным именем (/Common/foo), так и с коротким именем (foo). Если указано короткое имя, к нему автоматически добавляется аргумент partition.

address_ranges

list / elements=string

Список диапазонов адресов, где диапазон начинается с номера порта, за которым следует дефис (-) и второе число.

Если первый адрес больше второго числа, числа будут переставлены местами, чтобы диапазон был правильно отформатирован. Например, 2.2.2.2-1.1.1. будет преобразовано в 1.1.1.1-2.2.2.2.

addresses

list / elements=string

Отдельные адреса, которые нужно добавить в список. Эти адреса отличаются от диапазонов и списков списков, которые можно указывать соответственно в address_ranges и address_lists.

Этот список также может содержать сети в нотации CIDR.

description

string

Описание списка адресов.

fqdns

list / elements=string

Список полных доменных имён (FQDN).

Полное доменное имя содержит как минимум одну точку, отделяющую хост от домена.

Для добавления FQDN в список необходимо настроить глобальный резолвер FQDN. Это можно сделать с помощью bigip_command или в графическом интерфейсе BIG-IP. Если используется bigip_command, настройте его с помощью tmsh modify security firewall global-fqdn-policy FOO, где FOO — это DNS-резолвер, настроенный в tmsh create net dns-resolver FOO.

geo_locations

list / elements=dictionary

Список географических местоположений, указанных с помощью country и region.

country

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

Название или код страны для географического местоположения.

В дополнение к полным названиям стран можно также указывать их сокращённые обозначения, например US вместо United States.

Допустимые коды стран можно найти здесь: https://countrycode.org/.

region

string

Название региона страны.

name

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

Указывает имя списка адресов.

partition

string

Раздел устройства, в котором будут управляться ресурсы.

По умолчанию: "Common"

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 ← (по умолчанию)

state

string

Если задано значение present, гарантирует наличие списка адресов и его записей.

Если задано значение absent, гарантирует удаление списка адресов.

Варианты:

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

address_lists

list / elements=string

Новый список имён списков адресов, применённый к списку адресов.

Возвращается: changed

Пример: ["/Common/list1", "/Common/list2"]

address_ranges

list / elements=string

Новый список диапазонов адресов, применённый к списку адресов.

Возвращается: changed

Пример: ["1.1.1.1-2.2.2.2", "3.3.3.3-4.4.4.4"]

addresses

list / elements=string

Новый список адресов, применённый к списку адресов.

Возвращается: changed

Пример: ["1.1.1.1", "2.2.2.2"]

description

string

Новое описание списка адресов.

Возвращается: changed

Пример: "My address list"

fqdns

list / elements=string

Новый список имён FQDN, применённый к списку адресов.

Возвращается: changed

Пример: ["google.com", "mit.edu"]

geo_locations

complex

Новый список географических местоположений, применённый к списку адресов.

Возвращается: changed

country

string

Страна географического местоположения.

Возвращается: changed

Пример: "US"

region

string

Регион географического местоположения.

Возвращается: changed

Пример: "California"