модуль cisco.meraki.networks_wireless_ssids — модуль ресурса для networks _wireless _ssids
Примечание
Этот модуль входит в коллекцию cisco.meraki (версия 2.23.2).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.meraki. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в сценарии, укажите: cisco.meraki.networks_wireless_ssids.
Добавлено в cisco.meraki 1.0.0
Краткое описание
- Управление операцией обновления ресурса networks _wireless _ssids.
- Обновление атрибутов SSID точки доступа MR.
Примечание
Для этого модуля имеется соответствующий плагин действия.
Требования
Следующие требования необходимо выполнить на хосте, на котором запускается этот модуль.
- meraki >= 2.4.9
- python >= 3.5
Параметры
Параметр | Комментарии |
|---|---|
activeDirectory dictionary | Текущая настройка Active Directory. Допустимо только, если splashPage — ‘Password-protected with Active Directory’. |
|
credentials dictionary |
(Необязательно) Учетные данные учетной записи пользователя, которую точка доступа будет использовать для подключения к серверу Active Directory. У учетной записи Active Directory должны быть разрешения на всех ваших серверах Active Directory. Допустимо только, если splashPage — ‘Password-protected with Active Directory’. |
|
logonName string |
Имя для входа учетной записи Active Directory. |
|
password string |
Пароль учетной записи пользователя Active Directory. |
|
servers list / elements=dictionary |
Серверы Active Directory, используемые для аутентификации. |
|
host string |
IP-адрес (или FQDN) вашего сервера Active Directory. |
|
port integer |
(Необязательно) UDP-порт, на котором прослушивает запросы сервер Active Directory. По умолчанию используется порт 3268. |
adaptivePolicyGroupId string | Идентификатор группы адаптивной политики, которой назначен этот SSID. |
adultContentFilteringEnabled boolean | Логическое значение, указывающее, следует ли блокировать контент для взрослых. Допустимые значения:
|
apTagsAndVlanIds list / elements=dictionary | Список тегов и идентификаторов VLAN, используемых для маркировки VLAN. Этот параметр допустим только, если ipAssignmentMode — ‘Bridge mode’ или ‘Layer 3 roaming’. |
|
tags list / elements=string |
Массив тегов точки доступа. |
|
vlanId integer |
Числовой идентификатор, назначенный VLAN. |
authMode string | Метод управления подключением к SSID (‘open’, ‘open-enhanced’, ‘psk’, ‘open-with-radius’, ‘open-with-nac’, ‘8021x-meraki’, ‘8021x-nac’, ‘8021x-radius’, ‘8021x-google’, ‘8021x-entra’, ‘8021x-localradius’, ‘ipsk-with-radius’, ‘ipsk-without-radius’, ‘ipsk-with-nac’ или ‘ipsk-with-radius-easy-psk’). |
availabilityTags list / elements=string | Принимает список тегов для этого SSID. Если availableOnAllAps имеет значение false, SSID будет транслироваться только точками доступа с тегами, соответствующими любому из тегов в этом списке. |
availableOnAllAps boolean | Логическое значение, указывающее, должны ли все точки доступа транслировать SSID или его следует ограничить точками доступа, соответствующими любому из тегов доступности. Значение false допустимо, только если для SSID заданы теги доступности. Допустимые значения:
|
bandSelection string | Частоты радиосигнала SSID для обслуживания клиентов в профиле RF по умолчанию для помещений. (‘Dual band operation’, ‘5 GHz band only’ или ‘Dual band operation with Band Steering’). |
concentratorNetworkId string | Концентратор, используемый, если ipAssignmentMode имеет значение ‘Layer 3 roaming with a concentrator’ или ‘VPN’. |
defaultVlanId integer | Идентификатор VLAN по умолчанию для «всех остальных точек доступа». Этот параметр допустим только, если ipAssignmentMode — ‘Bridge mode’ или ‘Layer 3 roaming’. |
disassociateClientsOnVpnFailover boolean | Отключать клиентов при переключении резервного концентратора ‘VPN’, чтобы инициировать повторное подключение клиентов и отправку новых DHCP-запросов. Этот параметр допустим только, если ipAssignmentMode имеет значение ‘VPN’. Допустимые значения:
|
dnsRewrite dictionary | Настройки перенаправления DNS-серверов. |
|
dnsCustomNameservers list / elements=string |
Указанные пользователем DNS-серверы (не более двух). |
|
enabled boolean |
Логическое значение, указывающее, включено ли перенаправление DNS-серверов. Если оно отключено, будут использоваться вышестоящие DNS-серверы. Допустимые значения:
|
dot11r dictionary | Текущая настройка 802.11r. |
|
adaptive boolean |
(Необязательно) Указывает, используется ли адаптивный режим 802.11r. Допустимые значения:
|
|
enabled boolean |
Указывает, включен ли 802.11r. Допустимые значения:
|
dot11w dictionary | Текущая настройка защищенных кадров управления (802.11w). |
|
enabled boolean |
Указывает, включен ли 802.11w. Допустимые значения:
|
|
required boolean |
(Необязательно) Указывает, требуется ли 802.11w. Допустимые значения:
|
enabled boolean | Указывает, включен ли SSID. Допустимые значения:
|
encryptionMode string | Режим шифрования PSK для SSID (‘wep’ или ‘wpa’). Этот параметр допустим только, если authMode имеет значение ‘psk’. |
enterpriseAdminAccess string | Указывает, доступен ли SSID администраторам ‘enterprise’ (‘access disabled’ или ‘access enabled’). |
gre dictionary | Настройки Ethernet over GRE. |
|
concentrator dictionary |
Настройки концентратора EoGRE. |
|
host string |
IP-адрес или FQDN концентратора EoGRE. Этот параметр обязателен, если ipAssignmentMode имеет значение ‘Ethernet over GRE’. |
|
key integer |
Необязательный числовой идентификатор, добавляющий поле ключа GRE в заголовок GRE. Используется для идентификации отдельного потока трафика внутри туннеля. |
ipAssignmentMode string | Режим назначения IP-адресов клиентам (‘NAT mode’, ‘Bridge mode’, ‘Layer 3 roaming’, ‘Ethernet over GRE’, ‘Layer 3 roaming with a concentrator’, ‘VPN’ или ‘Campus Gateway’). |
lanIsolationEnabled boolean | Логическое значение, указывающее, следует ли включить изоляцию локальной сети уровня 2. Настраивается только, если ipAssignmentMode имеет значение ‘Bridge mode’. Допустимые значения:
|
ldap dictionary | Текущая настройка LDAP. Допустимо только, если splashPage — ‘Password-protected with LDAP’. |
|
baseDistinguishedName string |
Базовое отличительное имя пользователей на LDAP-сервере. |
|
credentials dictionary |
(Необязательно) Учетные данные учетной записи пользователя, которую точка доступа будет использовать для подключения к LDAP-серверу. У учетной записи LDAP должны быть разрешения на всех ваших LDAP-серверах. |
|
distinguishedName string |
Отличительное имя учетной записи пользователя LDAP (например, cn=user,dc=meraki,dc=com). |
|
password string |
Пароль учетной записи пользователя LDAP. |
|
serverCaCertificate dictionary |
Сертификат CA, используемый для подписи ключа LDAP-сервера. |
|
contents string |
Содержимое сертификата CA. Формат должен быть PEM или DER. |
|
servers list / elements=dictionary |
LDAP-серверы, используемые для аутентификации. |
|
host string |
IP-адрес (или FQDN) вашего LDAP-сервера. |
|
port integer |
UDP-порт, на котором прослушивает запросы LDAP-сервер. |
localAuthFallback dictionary | Текущая конфигурация резервной локальной аутентификации. Позволяет точке доступа (AP) хранить данные аутентификации клиентов в течение заданного периода, который можно изменить при необходимости. |
|
cacheTimeout integer |
Период (в секундах), в течение которого кэшируются данные аутентификации. Отсчет времени начинается с последней некэшированной аутентификации пользователя в сети. От 3600 (1 час) до 86400 (1 день). |
|
enabled boolean |
Если значение равно true, устройства MR будут кэшировать учетные данные аутентификации для EAP-TLS или аутентификации на основе MAC-адреса. Допустимые значения:
|
|
serverCaCertificate dictionary |
Сертификат CA сервера, используемый для подписи сертификата клиента. |
|
contents string |
Содержимое сертификата CA сервера. Формат должен быть PEM или DER. |
localRadius dictionary | Текущая настройка локальной аутентификации — встроенного в точку доступа RADIUS-сервера. Допустимо только, если authMode имеет значение ‘8021x-localradius’. |
|
cacheTimeout integer |
Период (в секундах), в течение которого кэшируются запросы LDAP и OCSP. |
|
certificateAuthentication dictionary |
Текущая настройка проверки сертификатов. |
|
clientRootCaCertificate dictionary |
Сертификат CA клиента, используемый для подписи сертификата клиента. |
|
contents string |
Содержимое сертификата CA клиента. Формат должен быть PEM или DER. |
|
enabled boolean |
Указывает, следует ли использовать аутентификацию беспроводных клиентов на основе сертификатов EAP-TLS. Допустимые значения:
|
|
ocspResponderUrl string |
(Необязательно) URL-адрес ответчика OCSP для проверки статуса сертификата клиента. |
|
useLdap boolean |
Указывает, следует ли проверять сертификат с помощью LDAP. Допустимые значения:
|
|
useOcsp boolean |
Проверять ли сертификат с помощью OCSP. Варианты:
|
|
passwordAuthentication dictionary |
Текущая настройка аутентификации по паролю. |
|
enabled boolean |
Использовать ли аутентификацию по паролю через EAP-TTLS/PAP или PEAP-GTC с поиском в LDAP. Варианты:
|
mandatoryDhcpEnabled boolean | Если значение равно true, обязательное использование DHCP гарантирует, что клиенты, подключающиеся к этому SSID, будут использовать IP-адрес, назначенный DHCP-сервером. Клиенты со статическим IP-адресом не смогут подключиться. Варианты:
|
meraki_action_batch_retry_wait_time integer | meraki_action_batch_retry_wait_time (integer), время ожидания перед повторной попыткой при ошибке параллельного выполнения пакета действий По умолчанию: |
meraki_api_key string / обязательный | meraki_api_key (string), ключ API, созданный в панели управления; также может быть задан как переменная среды MERAKI_DASHBOARD_API_KEY |
meraki_base_url string | meraki_base_url (string), базовый URL для всех ресурсов конечных точек По умолчанию: |
meraki_be_geo_id string | meraki_be_geo_id (string), необязательный идентификатор партнёра для отслеживания использования API; также может быть задан как переменная среды BE_GEO_ID По умолчанию: |
meraki_certificate_path string | meraki_certificate_path (string), путь к сертификату для проверки TLS/SSL при работе за локальным прокси-сервером По умолчанию: |
meraki_inherit_logging_config boolean | meraki_inherit_logging_config (boolean), наследовать собственный экземпляр регистратора Варианты:
|
meraki_log_file_prefix string | meraki_log_file_prefix (string), имя файла журнала с добавленными датой и временем По умолчанию: |
meraki_log_path string | log_path (string), путь для вывода журнала; если не указан, используется рабочий каталог скрипта По умолчанию: |
meraki_maximum_retries integer | meraki_maximum_retries (integer), число повторных попыток при получении ответов 429 или других ошибок на стороне сервера По умолчанию: |
meraki_nginx_429_retry_wait_time integer | meraki_nginx_429_retry_wait_time (integer), время ожидания перед повторной попыткой после ответа Nginx 429 По умолчанию: |
meraki_output_log boolean | meraki_output_log (boolean), создавать ли файл журнала вывода? Варианты:
|
meraki_print_console boolean | meraki_print_console (boolean), выводить ли журнал в консоль? Варианты:
|
meraki_requests_proxy string | meraki_requests_proxy (string), адрес прокси-сервера и порт для HTTPS, если требуется По умолчанию: |
meraki_retry_4xx_error boolean | meraki_retry_4xx_error (boolean), повторять ли запрос при других ошибках 4XX (кроме 429)? Варианты:
|
meraki_retry_4xx_error_wait_time integer | meraki_retry_4xx_error_wait_time (integer), время ожидания перед повторной попыткой после другой ошибки 4XX По умолчанию: |
meraki_simulate boolean | meraki_simulate (boolean), имитировать вызовы POST/PUT/DELETE, чтобы предотвратить внесение изменений? Варианты:
|
meraki_single_request_timeout integer | meraki_single_request_timeout (integer), максимальное число секунд для каждого вызова API По умолчанию: |
meraki_suppress_logging boolean | meraki_suppress_logging (boolean), отключить ведение журнала? Тогда вы предоставлены сами себе! Варианты:
|
meraki_use_iterator_for_get_pages boolean | meraki_use_iterator_for_get_pages (boolean), методы list* будут возвращать итератор с каждым объектом вместо полного списка всех элементов Варианты:
|
meraki_wait_on_rate_limit boolean | meraki_wait_on_rate_limit (boolean), повторять ли запрос при ошибке ограничения частоты запросов 429? Варианты:
|
minBitrate float | Минимальная скорость передачи данных в Мбит/с для этого SSID в стандартном профиле радиочастот для помещений. («1», «2», «5.5», «6», «9», «11», «12», «18», «24», «36», «48» или «54»). |
name string | Имя SSID. |
namedVlans dictionary | Настройки именованных VLAN. |
|
radius dictionary |
Настройки RADIUS. Этот параметр допустим только при значении authMode ‘open-with-radius’ и значении ipAssignmentMode, отличном от ‘NAT mode’. |
|
guestVlan dictionary |
Настройки гостевой VLAN. Используется для перенаправления трафика в гостевую VLAN, если ни один из серверов RADIUS недоступен или клиент получает от сервера RADIUS отказ в доступе. |
|
enabled boolean |
Включена ли именованная гостевая VLAN RADIUS. Варианты:
|
|
name string |
Имя гостевой VLAN RADIUS. |
|
tagging dictionary |
Настройки маркировки VLAN. Этот параметр допустим только при значении ipAssignmentMode ‘Bridge mode’ или ‘Layer 3 roaming’. |
|
byApTags list / elements=dictionary |
Список тегов точек доступа и имён VLAN, используемых для маркировки именованных VLAN. Если тег точки доступа совпадает с одним из тегов в списке, трафик этого SSID будет направляться в VLAN с именем, соответствующим этому тегу. |
|
tags list / elements=string |
Список тегов точек доступа. |
|
vlanName string |
Имя VLAN, используемое для маркировки трафика. |
|
defaultVlanName string |
Имя VLAN по умолчанию, используемое для маркировки трафика, если соответствующий тег точки доступа отсутствует. |
|
enabled boolean |
Следует ли направлять трафик в VLAN с определёнными именами. Варианты:
|
networkId string | Параметр пути NetworkId. Идентификатор сети. |
number string | Параметр пути Number. |
oauth dictionary | Настройки OAuth для этого SSID. Допустимо только при значении splashPage ‘Google OAuth’. |
|
allowedDomains list / elements=string |
(Необязательно) Список доменов, которым разрешён доступ к сети. |
perClientBandwidthLimitDown integer | Ограничение входящей пропускной способности в Кбит/с. (0 означает отсутствие ограничения.) |
perClientBandwidthLimitUp integer | Ограничение исходящей пропускной способности в Кбит/с. (0 означает отсутствие ограничения.) |
perSsidBandwidthLimitDown integer | Общее ограничение входящей пропускной способности в Кбит/с. (0 означает отсутствие ограничения.) |
perSsidBandwidthLimitUp integer | Общее ограничение исходящей пропускной способности в Кбит/с. (0 означает отсутствие ограничения.) |
psk string | Парольная фраза для SSID. Этот параметр допустим только при значении authMode ‘psk’. |
radiusAccountingEnabled boolean | Включён ли учёт RADIUS. Этот параметр допустим только при значении authMode ‘open-with-radius’, ‘8021x-radius’ или ‘ipsk-with-radius’. Варианты:
|
radiusAccountingInterimInterval integer | Интервал (в секундах), с которым сведения об учёте обновляются и отправляются на сервер учёта RADIUS. |
radiusAccountingServers list / elements=dictionary | Серверы учёта RADIUS 802.1X, используемые для аутентификации. Этот параметр допустим только при значении authMode ‘open-with-radius’, ‘8021x-radius’ или ‘ipsk-with-radius’ и значении radiusAccountingEnabled ‘true’. |
|
caCertificate string |
Сертификат, используемый для авторизации на сервере RADSEC. |
|
host string |
IP-адрес (или полное доменное имя), на который точки доступа будут отправлять сообщения учёта RADIUS. |
|
port integer |
Порт сервера RADIUS, на котором принимаются сообщения учёта. |
|
radsecEnabled boolean |
Использовать RADSEC (TLS поверх TCP) для подключения к этому серверу учёта RADIUS. Требуется параметр radiusProxyEnabled. Варианты:
|
|
secret string |
Общий ключ, используемый для аутентификации сообщений между точками доступа и сервером RADIUS. |
radiusAccountingStartDelay integer | Задержка (в секундах) перед отправкой первого сообщения о начале учёта RADIUS. Должна составлять от 0 до 60 секунд. |
radiusAttributeForGroupPolicies string | Укажите атрибут RADIUS, используемый для поиска политик групп (‘Filter-Id’, ‘Reply-Message’, ‘Airespace-ACL-Name’ или ‘Aruba-User-Role’). Точки доступа должны получать этот атрибут в сообщении RADIUS Access-Accept. |
radiusAuthenticationNasId string | Шаблон идентификатора NAS, используемого для аутентификации RADIUS (например, $NODE_MAC$ $VAP_NUM$). |
radiusCalledStationId string | Шаблон идентификатора вызываемой станции, используемого для RADIUS (например, $NODE_MAC$ $VAP_NUM$). |
radiusCoaEnabled boolean | Если значение равно true, устройства Meraki будут работать как сервер динамической авторизации RADIUS и отвечать на сообщения RADIUS Change-of-Authorization и Disconnect, отправленные сервером RADIUS. Варианты:
|
radiusFailoverPolicy string | Эта политика определяет, как обрабатывать запросы аутентификации, если все настроенные серверы RADIUS недоступны («Запретить доступ» или «Разрешить доступ»). |
radiusFallbackEnabled boolean | Следует ли повторно обращаться к серверам RADIUS с более высоким приоритетом через 60 секунд. Варианты:
|
radiusGuestVlanEnabled boolean | Включена ли гостевая VLAN RADIUS. Этот параметр допустим только в том случае, если для authMode задано значение ‘open-with-radius’, а для режима адресации не задан режим ‘isolated’ или ‘nat’. Варианты:
|
radiusGuestVlanId integer | Идентификатор VLAN гостевой VLAN RADIUS. Этот параметр допустим только в том случае, если для authMode задано значение ‘open-with-radius’, а для режима адресации не задан режим ‘isolated’ или ‘nat’. |
radiusLoadBalancingPolicy string | Эта политика определяет, к какому серверу RADIUS будет направлен первый запрос аутентификации, а также порядок необходимых повторных попыток («Строгий порядок приоритетов» или «Циклический перебор»). |
radiusOverride boolean | Если значение равно true, ответ RADIUS может переопределить тег VLAN. Это недопустимо, если для ipAssignmentMode задано значение ‘NAT mode’. Варианты:
|
radiusProxyEnabled boolean | Если значение равно true, устройства Meraki будут передавать сообщения RADIUS через облако Meraki на настроенные серверы аутентификации и учета RADIUS. Варианты:
|
radiusRadsec dictionary | Текущие настройки RADIUS RADSec. |
|
tlsTunnel dictionary |
Настройки TLS-туннеля RADSec. |
|
timeout integer |
Интервал (в секундах), определяющий, как долго TLS-сеанс сервера RADSec может оставаться неактивным до автоматического завершения. |
radiusServerAttemptsLimit integer | Максимальное количество попыток передачи, после которого выполняется переключение на другой сервер RADIUS (допустимый диапазон — от 1 до 5). |
radiusServers list / elements=dictionary | Серверы RADIUS 802.1X, используемые для аутентификации. Этот параметр допустим только в том случае, если для authMode задано значение ‘open-with-radius’, ‘8021x-radius’ или ‘ipsk-with-radius’. |
|
caCertificate string |
Сертификат, используемый для авторизации на сервере RADSEC. |
|
host string |
IP-адрес (или полное доменное имя) сервера RADIUS. |
|
openRoamingCertificateId integer |
Идентификатор сертификата OpenRoaming, привязанного к серверу RADIUS. |
|
port integer |
UDP-порт, на котором сервер RADIUS принимает запросы Access-Request. |
|
radsecEnabled boolean |
Использовать RADSEC (TLS поверх TCP) для подключения к этому серверу RADIUS. Требуется включить radiusProxyEnabled. Варианты:
|
|
secret string |
Общий секрет клиента RADIUS. |
radiusServerTimeout integer | Время ожидания ответа от сервера RADIUS клиентом RADIUS (допустимый диапазон — от 1 до 10 секунд). |
radiusTestingEnabled boolean | Если значение равно true, устройства Meraki будут периодически отправлять настроенным серверам RADIUS сообщения Access-Request с идентификатором ‘meraki_8021x_test’, чтобы проверять доступность серверов RADIUS. Варианты:
|
secondaryConcentratorNetworkId string | Вторичный концентратор, используемый, если для ipAssignmentMode задано значение ‘VPN’. Если он настроен, точки доступа переключатся на этот концентратор, когда основной станет недоступен. Этот параметр необязателен. (‘disabled’ означает, что вторичный концентратор не используется.) |
speedBurst dictionary | Настройка SpeedBurst для этой SSID. |
|
enabled boolean |
Логическое значение, указывающее, разрешено ли пользователям ненадолго превышать ограничение пропускной способности, оставаясь в пределах этого ограничения в течение длительного времени. Варианты:
|
splashGuestSponsorDomains list / elements=string | Массив допустимых доменов электронной почты спонсоров для типа страницы-заставки «гость со спонсором». |
splashPage string | Тип страницы-заставки для SSID (‘None’, ‘Click-through splash page’, ‘Billing’, ‘Password-protected with Meraki RADIUS’, ‘Password-protected with custom RADIUS’, ‘Password-protected with Active Directory’, ‘Password-protected with LDAP’, ‘SMS authentication’, ‘Systems Manager Sentry’, ‘Facebook Wi-Fi’, ‘Google OAuth’, ‘Microsoft Entra ID’, ‘Sponsored guest’, ‘Cisco ISE’ или ‘Google Apps domain’). Этот атрибут не поддерживается для дочерних элементов шаблона. |
useVlanTagging boolean | Следует ли направлять трафик в определенные VLAN. Этот параметр допустим только в том случае, если для ipAssignmentMode задано значение ‘Bridge mode’ или ‘Layer 3 roaming’. Варианты:
|
visible boolean | Логическое значение, указывающее, должны ли точки доступа объявлять эту SSID или скрывать ее. Точки доступа транслируют эту SSID, только если значение равно true. Варианты:
|
vlanId integer | Идентификатор VLAN, используемый для тегирования VLAN. Этот параметр допустим только в том случае, если для ipAssignmentMode задано значение ‘Layer 3 roaming with a concentrator’ или ‘VPN’. |
walledGardenEnabled boolean | Разрешить доступ к настраиваемому списку IP-диапазонов, доступных пользователям до входа в систему. Варианты:
|
walledGardenRanges list / elements=string | Укажите разрешенные адреса, задав массив адресов, диапазонов в нотации CIDR, доменных имен и масок доменов (например, ‘192.168.1.1/24’, ‘192.168.37.10/32’, ‘www.yahoo.com’, ‘*.google.com’). Страница-заставка Meraki автоматически добавляется в список разрешенных адресов. |
wpaEncryptionMode string | Типы шифрования WPA. (‘WPA1 only’, ‘WPA1 and WPA2’, ‘WPA2 only’, ‘WPA3 Transition Mode’, ‘WPA3 only’ или ‘WPA3 192-bit Security’). |
Примечания
Примечание
- Используемый метод SDK: wireless.Wireless.update_network_wireless_ssid,
- Используемые пути: put /networks/{networkId}/wireless/ssids/{number},
- Не поддерживает
check_mode - Плагин запускается на управляющем узле и не использует плагины подключения Ansible, а вместо этого применяет встроенный диспетчер подключений
- из Cisco Dashboard API Python (SDK)
- Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления подключения
См. также
См. также
- Документация Cisco Meraki по wireless updateNetworkWirelessSsid
-
Полный справочник по API updateNetworkWirelessSsid.
Примеры
- name: Update by id
cisco.meraki.networks_wireless_ssids:
meraki_api_key: "{{ meraki_api_key }}"
meraki_base_url: "{{ meraki_base_url }}"
meraki_single_request_timeout: "{{ meraki_single_request_timeout }}"
meraki_certificate_path: "{{ meraki_certificate_path }}"
meraki_requests_proxy: "{{ meraki_requests_proxy }}"
meraki_wait_on_rate_limit: "{{ meraki_wait_on_rate_limit }}"
meraki_nginx_429_retry_wait_time: "{{ meraki_nginx_429_retry_wait_time }}"
meraki_action_batch_retry_wait_time: "{{ meraki_action_batch_retry_wait_time }}"
meraki_retry_4xx_error: "{{ meraki_retry_4xx_error }}"
meraki_retry_4xx_error_wait_time: "{{ meraki_retry_4xx_error_wait_time }}"
meraki_maximum_retries: "{{ meraki_maximum_retries }}"
meraki_output_log: "{{ meraki_output_log }}"
meraki_log_file_prefix: "{{ meraki_log_file_prefix }}"
meraki_log_path: "{{ meraki_log_path }}"
meraki_print_console: "{{ meraki_print_console }}"
meraki_suppress_logging: "{{ meraki_suppress_logging }}"
meraki_simulate: "{{ meraki_simulate }}"
meraki_be_geo_id: "{{ meraki_be_geo_id }}"
meraki_caller: "{{ meraki_caller }}"
meraki_use_iterator_for_get_pages: "{{ meraki_use_iterator_for_get_pages }}"
meraki_inherit_logging_config: "{{ meraki_inherit_logging_config }}"
state: present
activeDirectory:
credentials:
logonName: user
password: password
servers:
- host: 127.0.0.1
port: 3268
adaptivePolicyGroupId: '1234'
adultContentFilteringEnabled: false
apTagsAndVlanIds:
- tags:
- tag1
- tag2
vlanId: 100
authMode: 8021x-radius
availabilityTags:
- tag1
- tag2
availableOnAllAps: false
bandSelection: 5 GHz band only
concentratorNetworkId: N_24329156
defaultVlanId: 1
disassociateClientsOnVpnFailover: false
dnsRewrite:
dnsCustomNameservers:
- 8.8.8.8
- 8.8.4.4
enabled: true
dot11r:
adaptive: true
enabled: true
dot11w:
enabled: true
required: false
enabled: true
encryptionMode: wpa
enterpriseAdminAccess: access enabled
gre:
concentrator:
host: 192.168.1.1
key: 5
ipAssignmentMode: NAT mode
lanIsolationEnabled: true
ldap:
baseDistinguishedName: dc=example,dc=com
credentials:
distinguishedName: cn=user,dc=example,dc=com
password: password
serverCaCertificate:
contents: '-----BEGIN CERTIFICATE----- MIIEKjCCAxKgAwIBAgIRANb+lsED3eb4+6YKLFFYqEkwDQYJKoZIhvcNAQELBQAw
gYcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMREwDwYDVQQHDAhT YW4gSm9zZTEcMBoGA1UECgwTQ2lzY28gU3lzdGVtcywgSW5jLjESMBAGA1UECwwJ
RE5BU3BhY2VzMR4wHAYDVQQDDBVjaXNjby5vcGVucm9hbWluZy5vcmcwHhcNMjAx MTA1MjEzMzM1WhcNMjExMTA1MjIzMzM1WjCBpDEcMBoGCgmSJomT8ixkAQETDGRu
YXNwYWNlczpVUzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMQ4wDAYDVQQKEwVD aXNjbzEcMBoGA1UECxMTV0JBOldSSVggRW5kLUVudGl0eTE8MDoGA1UEAxMzNjQ3
MDcwNDM4NDQ5NjQxMjAwMDAuMTg4MzQuaHMuY2lzY28ub3BlbnJvYW1pbmcub3Jn MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoqjP9QgRGyUO3p7SH9QK
uTq6UYK7nAyjImgS4yQxeBkyZ5f2EUkX8m/AOcewpPxxPBhjPKRwxGeX3S50ksiA ayFomUeslR0S0Z7RN9rzJa+CFyi9MwWIHMbLgXpB8tsSpgTAqwrzoTzOGq9fgC6u
pZhdZrBkg3FeJgD88goCi9mZDsY2YAoeGRLFJ2fR8iICqIVQy+Htq9pE22WBLpnS KjL3+mR9FArHNFtWlhKF2YHMUqyHHrnZnF/Ns7QNoMMF7/CK18iAKgnb+2wuGKM2
aEMddOeOTtz+i/rgjkp/RGMt011EdCsso0/cTo9qqX/bxOOCE4/Mne/ChMkQPnNU CwIDAQABo3IwcDAJBgNVHRMEAjAAMB8GA1UdIwQYMBaAFIG+4l5yiB01gP0sw4ML
USopqYcuMB0GA1UdDgQWBBSby1T9leYVOVVdOZXiHCSaDDEMiDAOBgNVHQ8BAf8E BAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwIwDQYJKoZIhvcNAQELBQADggEBAEyE
1mjSUyY6uNp6W4l20w7SskALSJDRKkOeZxAgF3VMxlsCuEl70s9oEfntwIpyQtSa jON/9yJHbwm/Az824bmk8Dc7AXIPhay+dftXb8j529gPuYB9AKoPNg0NctkyYCQh
a/3YQVdDWX7XgmEiXkL57M7G6+IdcPDONLArfjOcT9qHdkVVq1AIjlMSx3OQQmm/ uoLb/G9q/97QA2/l8shG/Na8HjVqGLcl5TNZdbNhs2w9ogxr/GNzqdvym6RQ8vT/
UR2n+uwH4n1MUxmHYYeyot5dnIV1IJ6hQ54JAncM9HvCLFk1WHz6RKshQUCuPBiJ wTw70BVktzJnb0VLeDg=
-----END CERTIFICATE-----'
servers:
- host: 127.0.0.1
port: 389
localAuthFallback:
cacheTimeout: 6500
enabled: true
serverCaCertificate:
contents: '-----BEGIN CERTIFICATE----- MIIEKjCCAxKgAwIBAgIRANb+lsED3eb4+6YKLFFYqEkwDQYJKoZIhvcNAQELBQAw
gYcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMREwDwYDVQQHDAhT YW4gSm9zZTEcMBoGA1UECgwTQ2lzY28gU3lzdGVtcywgSW5jLjESMBAGA1UECwwJ
RE5BU3BhY2VzMR4wHAYDVQQDDBVjaXNjby5vcGVucm9hbWluZy5vcmcwHhcNMjAx MTA1MjEzMzM1WhcNMjExMTA1MjIzMzM1WjCBpDEcMBoGCgmSJomT8ixkAQETDGRu
YXNwYWNlczpVUzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMQ4wDAYDVQQKEwVD aXNjbzEcMBoGA1UECxMTV0JBOldSSVggRW5kLUVudGl0eTE8MDoGA1UEAxMzNjQ3
MDcwNDM4NDQ5NjQxMjAwMDAuMTg4MzQuaHMuY2lzY28ub3BlbnJvYW1pbmcub3Jn MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoqjP9QgRGyUO3p7SH9QK
uTq6UYK7nAyjImgS4yQxeBkyZ5f2EUkX8m/AOcewpPxxPBhjPKRwxGeX3S50ksiA ayFomUeslR0S0Z7RN9rzJa+CFyi9MwWIHMbLgXpB8tsSpgTAqwrzoTzOGq9fgC6u
pZhdZrBkg3FeJgD88goCi9mZDsY2YAoeGRLFJ2fR8iICqIVQy+Htq9pE22WBLpnS KjL3+mR9FArHNFtWlhKF2YHMUqyHHrnZnF/Ns7QNoMMF7/CK18iAKgnb+2wuGKM2
aEMddOeOTtz+i/rgjkp/RGMt011EdCsso0/cTo9qqX/bxOOCE4/Mne/ChMkQPnNU CwIDAQABo3IwcDAJBgNVHRMEAjAAMB8GA1UdIwQYMBaAFIG+4l5yiB01gP0sw4ML
USopqYcuMB0GA1UdDgQWBBSby1T9leYVOVVdOZXiHCSaDDEMiDAOBgNVHQ8BAf8E BAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwIwDQYJKoZIhvcNAQELBQADggEBAEyE
1mjSUyY6uNp6W4l20w7SskALSJDRKkOeZxAgF3VMxlsCuEl70s9oEfntwIpyQtSa jON/9yJHbwm/Az824bmk8Dc7AXIPhay+dftXb8j529gPuYB9AKoPNg0NctkyYCQh
a/3YQVdDWX7XgmEiXkL57M7G6+IdcPDONLArfjOcT9qHdkVVq1AIjlMSx3OQQmm/ uoLb/G9q/97QA2/l8shG/Na8HjVqGLcl5TNZdbNhs2w9ogxr/GNzqdvym6RQ8vT/
UR2n+uwH4n1MUxmHYYeyot5dnIV1IJ6hQ54JAncM9HvCLFk1WHz6RKshQUCuPBiJ wTw70BVktzJnb0VLeDg=
-----END CERTIFICATE-----'
localRadius:
cacheTimeout: 60
certificateAuthentication:
clientRootCaCertificate:
contents: '-----BEGIN CERTIFICATE----- MIIEKjCCAxKgAwIBAgIRANb+lsED3eb4+6YKLFFYqEkwDQYJKoZIhvcNAQELBQAw
gYcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMREwDwYDVQQHDAhT YW4gSm9zZTEcMBoGA1UECgwTQ2lzY28gU3lzdGVtcywgSW5jLjESMBAGA1UECwwJ
RE5BU3BhY2VzMR4wHAYDVQQDDBVjaXNjby5vcGVucm9hbWluZy5vcmcwHhcNMjAx MTA1MjEzMzM1WhcNMjExMTA1MjIzMzM1WjCBpDEcMBoGCgmSJomT8ixkAQETDGRu
YXNwYWNlczpVUzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMQ4wDAYDVQQKEwVD aXNjbzEcMBoGA1UECxMTV0JBOldSSVggRW5kLUVudGl0eTE8MDoGA1UEAxMzNjQ3
MDcwNDM4NDQ5NjQxMjAwMDAuMTg4MzQuaHMuY2lzY28ub3BlbnJvYW1pbmcub3Jn MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoqjP9QgRGyUO3p7SH9QK
uTq6UYK7nAyjImgS4yQxeBkyZ5f2EUkX8m/AOcewpPxxPBhjPKRwxGeX3S50ksiA ayFomUeslR0S0Z7RN9rzJa+CFyi9MwWIHMbLgXpB8tsSpgTAqwrzoTzOGq9fgC6u
pZhdZrBkg3FeJgD88goCi9mZDsY2YAoeGRLFJ2fR8iICqIVQy+Htq9pE22WBLpnS KjL3+mR9FArHNFtWlhKF2YHMUqyHHrnZnF/Ns7QNoMMF7/CK18iAKgnb+2wuGKM2
aEMddOeOTtz+i/rgjkp/RGMt011EdCsso0/cTo9qqX/bxOOCE4/Mne/ChMkQPnNU CwIDAQABo3IwcDAJBgNVHRMEAjAAMB8GA1UdIwQYMBaAFIG+4l5yiB01gP0sw4ML
USopqYcuMB0GA1UdDgQWBBSby1T9leYVOVVdOZXiHCSaDDEMiDAOBgNVHQ8BAf8E BAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwIwDQYJKoZIhvcNAQELBQADggEBAEyE
1mjSUyY6uNp6W4l20w7SskALSJDRKkOeZxAgF3VMxlsCuEl70s9oEfntwIpyQtSa jON/9yJHbwm/Az824bmk8Dc7AXIPhay+dftXb8j529gPuYB9AKoPNg0NctkyYCQh
a/3YQVdDWX7XgmEiXkL57M7G6+IdcPDONLArfjOcT9qHdkVVq1AIjlMSx3OQQmm/ uoLb/G9q/97QA2/l8shG/Na8HjVqGLcl5TNZdbNhs2w9ogxr/GNzqdvym6RQ8vT/
UR2n+uwH4n1MUxmHYYeyot5dnIV1IJ6hQ54JAncM9HvCLFk1WHz6RKshQUCuPBiJ wTw70BVktzJnb0VLeDg=
-----END CERTIFICATE-----'
enabled: true
ocspResponderUrl: http://ocsp-server.example.com
useLdap: false
useOcsp: true
passwordAuthentication:
enabled: false
mandatoryDhcpEnabled: false
minBitrate: 5.5
name: My SSID
namedVlans:
radius:
guestVlan:
enabled: true
name: Guest VLAN
tagging:
byApTags:
- tags:
- tag1
- tag2
vlanName: My VLAN
defaultVlanName: My VLAN
enabled: true
networkId: string
number: string
oauth:
allowedDomains:
- example.com
perClientBandwidthLimitDown: 0
perClientBandwidthLimitUp: 0
perSsidBandwidthLimitDown: 0
perSsidBandwidthLimitUp: 0
psk: deadbeef
radiusAccountingEnabled: true
radiusAccountingInterimInterval: 5
radiusAccountingServers:
- caCertificate: '-----BEGIN CERTIFICATE----- MIIEKjCCAxKgAwIBAgIRANb+lsED3eb4+6YKLFFYqEkwDQYJKoZIhvcNAQELBQAw
gYcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMREwDwYDVQQHDAhT YW4gSm9zZTEcMBoGA1UECgwTQ2lzY28gU3lzdGVtcywgSW5jLjESMBAGA1UECwwJ
RE5BU3BhY2VzMR4wHAYDVQQDDBVjaXNjby5vcGVucm9hbWluZy5vcmcwHhcNMjAx MTA1MjEzMzM1WhcNMjExMTA1MjIzMzM1WjCBpDEcMBoGCgmSJomT8ixkAQETDGRu
YXNwYWNlczpVUzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMQ4wDAYDVQQKEwVD aXNjbzEcMBoGA1UECxMTV0JBOldSSVggRW5kLUVudGl0eTE8MDoGA1UEAxMzNjQ3
MDcwNDM4NDQ5NjQxMjAwMDAuMTg4MzQuaHMuY2lzY28ub3BlbnJvYW1pbmcub3Jn MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoqjP9QgRGyUO3p7SH9QK
uTq6UYK7nAyjImgS4yQxeBkyZ5f2EUkX8m/AOcewpPxxPBhjPKRwxGeX3S50ksiA ayFomUeslR0S0Z7RN9rzJa+CFyi9MwWIHMbLgXpB8tsSpgTAqwrzoTzOGq9fgC6u
pZhdZrBkg3FeJgD88goCi9mZDsY2YAoeGRLFJ2fR8iICqIVQy+Htq9pE22WBLpnS KjL3+mR9FArHNFtWlhKF2YHMUqyHHrnZnF/Ns7QNoMMF7/CK18iAKgnb+2wuGKM2
aEMddOeOTtz+i/rgjkp/RGMt011EdCsso0/cTo9qqX/bxOOCE4/Mne/ChMkQPnNU CwIDAQABo3IwcDAJBgNVHRMEAjAAMB8GA1UdIwQYMBaAFIG+4l5yiB01gP0sw4ML
USopqYcuMB0GA1UdDgQWBBSby1T9leYVOVVdOZXiHCSaDDEMiDAOBgNVHQ8BAf8E BAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwIwDQYJKoZIhvcNAQELBQADggEBAEyE
1mjSUyY6uNp6W4l20w7SskALSJDRKkOeZxAgF3VMxlsCuEl70s9oEfntwIpyQtSa jON/9yJHbwm/Az824bmk8Dc7AXIPhay+dftXb8j529gPuYB9AKoPNg0NctkyYCQh
a/3YQVdDWX7XgmEiXkL57M7G6+IdcPDONLArfjOcT9qHdkVVq1AIjlMSx3OQQmm/ uoLb/G9q/97QA2/l8shG/Na8HjVqGLcl5TNZdbNhs2w9ogxr/GNzqdvym6RQ8vT/
UR2n+uwH4n1MUxmHYYeyot5dnIV1IJ6hQ54JAncM9HvCLFk1WHz6RKshQUCuPBiJ wTw70BVktzJnb0VLeDg=
-----END CERTIFICATE-----'
host: 0.0.0.0
port: 3000
radsecEnabled: true
secret: secret-string
radiusAccountingStartDelay: 0
radiusAttributeForGroupPolicies: Filter-Id
radiusAuthenticationNasId: 00-11-22-33-44-55:AP1
radiusCalledStationId: 00-11-22-33-44-55:AP1
radiusCoaEnabled: true
radiusFailoverPolicy: Deny access
radiusFallbackEnabled: true
radiusGuestVlanEnabled: true
radiusGuestVlanId: 1
radiusLoadBalancingPolicy: Round robin
radiusOverride: false
radiusProxyEnabled: false
radiusRadsec:
tlsTunnel:
timeout: 600
radiusServerAttemptsLimit: 5
radiusServerTimeout: 5
radiusServers:
- caCertificate: '-----BEGIN CERTIFICATE----- MIIEKjCCAxKgAwIBAgIRANb+lsED3eb4+6YKLFFYqEkwDQYJKoZIhvcNAQELBQAw
gYcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMREwDwYDVQQHDAhT YW4gSm9zZTEcMBoGA1UECgwTQ2lzY28gU3lzdGVtcywgSW5jLjESMBAGA1UECwwJ
RE5BU3BhY2VzMR4wHAYDVQQDDBVjaXNjby5vcGVucm9hbWluZy5vcmcwHhcNMjAx MTA1MjEzMzM1WhcNMjExMTA1MjIzMzM1WjCBpDEcMBoGCgmSJomT8ixkAQETDGRu
YXNwYWNlczpVUzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMQ4wDAYDVQQKEwVD aXNjbzEcMBoGA1UECxMTV0JBOldSSVggRW5kLUVudGl0eTE8MDoGA1UEAxMzNjQ3
MDcwNDM4NDQ5NjQxMjAwMDAuMTg4MzQuaHMuY2lzY28ub3BlbnJvYW1pbmcub3Jn MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoqjP9QgRGyUO3p7SH9QK
uTq6UYK7nAyjImgS4yQxeBkyZ5f2EUkX8m/AOcewpPxxPBhjPKRwxGeX3S50ksiA ayFomUeslR0S0Z7RN9rzJa+CFyi9MwWIHMbLgXpB8tsSpgTAqwrzoTzOGq9fgC6u
pZhdZrBkg3FeJgD88goCi9mZDsY2YAoeGRLFJ2fR8iICqIVQy+Htq9pE22WBLpnS KjL3+mR9FArHNFtWlhKF2YHMUqyHHrnZnF/Ns7QNoMMF7/CK18iAKgnb+2wuGKM2
aEMddOeOTtz+i/rgjkp/RGMt011EdCsso0/cTo9qqX/bxOOCE4/Mne/ChMkQPnNU CwIDAQABo3IwcDAJBgNVHRMEAjAAMB8GA1UdIwQYMBaAFIG+4l5yiB01gP0sw4ML
USopqYcuMB0GA1UdDgQWBBSby1T9leYVOVVdOZXiHCSaDDEMiDAOBgNVHQ8BAf8E BAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwIwDQYJKoZIhvcNAQELBQADggEBAEyE
1mjSUyY6uNp6W4l20w7SskALSJDRKkOeZxAgF3VMxlsCuEl70s9oEfntwIpyQtSa jON/9yJHbwm/Az824bmk8Dc7AXIPhay+dftXb8j529gPuYB9AKoPNg0NctkyYCQh
a/3YQVdDWX7XgmEiXkL57M7G6+IdcPDONLArfjOcT9qHdkVVq1AIjlMSx3OQQmm/ uoLb/G9q/97QA2/l8shG/Na8HjVqGLcl5TNZdbNhs2w9ogxr/GNzqdvym6RQ8vT/
UR2n+uwH4n1MUxmHYYeyot5dnIV1IJ6hQ54JAncM9HvCLFk1WHz6RKshQUCuPBiJ wTw70BVktzJnb0VLeDg=
-----END CERTIFICATE-----'
host: 0.0.0.0
openRoamingCertificateId: 2
port: 3000
radsecEnabled: true
secret: secret-string
radiusTestingEnabled: true
secondaryConcentratorNetworkId: disabled
speedBurst:
enabled: true
splashGuestSponsorDomains:
- example.com
splashPage: Click-through splash page
useVlanTagging: false
visible: true
vlanId: 10
walledGardenEnabled: true
walledGardenRanges:
- example.com
- 1.1.1.1/32
wpaEncryptionMode: WPA2 only
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
meraki_response dictionary | Словарь или список с ответом, возвращенным Cisco Meraki Python SDK Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/cisco/meraki/networks_wireless_ssids_module.html