meraki_ssid – Управление беспроводными SSID в облаке Meraki

Новая версия 2.7.

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

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

Позволяет управлять SSID в беспроводной среде Meraki.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
ap_tags_vlan_ids список			Список меток VLAN.
	теги список		Список меток точек доступа.
	vlan_id целое число		Числовой идентификатор, назначенный VLAN.
auth_key строка			Ключ аутентификации, предоставленный панелью управления. Требуется, если переменная среды `MERAKI_KEY` не задана.
auth_mode строка		Варианты: открытый psk открытый с RADIUS 8021x-meraki 8021x-radius	Установить режим аутентификации сети.
band_selection строка		Варианты: Двухполосная работа Только полоса 5 ГГц Двухполосная работа с направлением полос	Установить режим выбора полос.
concentrator_network_id строка			Концентратор для использования в случае «Роуминг 3-го уровня с концентратором» или «VPN».
default_vlan_id строка			Идентификатор VLAN по умолчанию.
enabled логическое значение		Варианты: нет да	Включить или выключить сеть SSID.
encryption_mode строка		Варианты: wpa eap wpa-eap	Установить режим шифрования сети.
host строка		Значение по умолчанию: "api.meraki.com"	Имя хоста панели управления Meraki. Может использоваться для доступа к региональным средам Meraki, таким как Китай.
ip_assignment_mode строка		Варианты: Режим NAT Режим моста Роуминг 3-го уровня Роуминг 3-го уровня с концентратором VPN	Метод, который SSID использует для назначения IP-адресов.
min_bitrate число с плавающей запятой		Варианты: 1 2 5.5 6 9 11 12 18 24 36 48 54	Минимальная битовая скорость (Мбит/с) на SSID.
name строка			Имя SSID.
net_id строка			Идентификатор сети.
net_name строка			Название сети.
number целое число			Номер SSID в сети. Псевдонимы: ssid_number
org_id целое число			Идентификатор организации.
org_name строка			Название организации. Псевдонимы: организация
output_level строка		Варианты: отладка нормальный ←	Установить уровень подробности вывода при выполнении модуля.
per_client_bandwidth_limit_down целое число			Максимальная скорость загрузки (Мбит/с) для устройств в SSID.
per_client_bandwidth_limit_up целое число			Максимальная скорость загрузки (Мбит/с) для устройств в SSID.
psk строка			Пароль для беспроводной сети. Требуется, если auth_mode установлен в psk.
radius_accounting_enabled логическое значение		Варианты: нет да	Включить или выключить учёт RADIUS.
radius_accounting_servers список			Список RADIUS-серверов для учёта RADIUS.
	host строка		IP-адрес или имя хоста RADIUS-сервера.
	port целое число		Порт RADIUS-сервера.
	secret строка		Пароль RADIUS.
radius_coa_enabled логическое значение		Варианты: нет да	Включить или выключить RADIUS CoA (изменение авторизации) на SSID.
radius_failover_policy строка		Варианты: Запретить доступ Разрешить доступ	Установить политику доступа клиента в случае недоступности RADIUS-серверов.
radius_load_balancing_policy строка		Варианты: Строгий порядок приоритетов Равномерное распределение	Установить политику балансировки нагрузки при указании нескольких RADIUS-серверов.
radius_servers список			Список RADIUS-серверов.
	host строка		IP-адрес или имя хоста RADIUS-сервера.
	port целое число		Порт RADIUS-сервера.
	secret строка		Пароль RADIUS.
splash_page строка		Варианты: Нет Страница входа с кликом Платежи Защищенная паролем с Meraki RADIUS Защищенная паролем с пользовательским RADIUS Защищенная паролем с Active Directory Защищенная паролем с LDAP Аутентификация по SMS Systems Manager Sentry Facebook Wi-Fi Google OAuth Спонсируемый гость	Установлено для включения страницы входа и указания её типа.
state строка		Варианты: отсутствует запрос настоящий ←	Определяет, необходимо ли запрашивать или изменять информацию SNMP.
timeout целое число		Значение по умолчанию: 30	Время ожидания для HTTP-запросов.
use_https логическое значение		Варианты: нет да ←	Если `no`, будет использоваться HTTP. В противном случае будет использоваться HTTPS. Полезно только для внутренних разработчиков Meraki.
use_proxy логическое значение		Варианты: нет да	Если `no`, прокси не будет использоваться, даже если он определён в переменной среды целевых хостов.
use_vlan_tagging логическое значение		Варианты: нет да	Установить, использовать ли маркировку VLAN.

validate_certs boolean	Выбираемые значения: no yes ←	Подтверждать ли сертификаты HTTP.
vlan_id integer		Идентификатор VLAN на SSID.
walled_garden_enabled boolean	Выбираемые значения: no yes	Включить или выключить функциональность walled garden.
walled_garden_ranges list		Список диапазонов walled garden.
wpa_encryption_mode string	Выбираемые значения: WPA1 и WPA2 Только WPA2	Режим шифрования в рамках спецификации WPA2.

Примечания

Примечание

Удаление SSID не приводит к удалению серверов RADIUS.
Дополнительную информацию об API Meraki можно найти по адресу https://dashboard.meraki.com/api_docs.
Некоторые параметры, вероятно, используются только разработчиками внутри Meraki.

Примеры

- name: Enable and name SSID
  meraki_ssid:
    auth_key: abc123
    state: present
    org_name: YourOrg
    net_name: WiFi
    name: GuestSSID
    enabled: true
  delegate_to: localhost

- name: Set PSK with invalid encryption mode
  meraki_ssid:
    auth_key: abc123
    state: present
    org_name: YourOrg
    net_name: WiFi
    name: GuestSSID
    auth_mode: psk
    psk: abc1234
    encryption_mode: eap
  ignore_errors: yes
  delegate_to: localhost

- name: Configure RADIUS servers
  meraki_ssid:
    auth_key: abc123
    state: present
    org_name: YourOrg
    net_name: WiFi
    name: GuestSSID
    auth_mode: open-with-radius
    radius_servers:
      - host: 192.0.1.200
        port: 1234
        secret: abc98765
  delegate_to: localhost

- name: Enable click-through splash page
  meraki_ssid:
    auth_key: abc123
    state: present
    org_name: YourOrg
    net_name: WiFi
    name: GuestSSID
    splash_page: Click-through splash page
  delegate_to: localhost

Значения возврата

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

Ключ		Возвращаемое значение	Описание
data complex		success	Список беспроводных SSID.
	authMode string	success	Метод аутентификации. Пример: psk
	bandSelection string	success	Беспроводная частота RF, на которой будет транслироваться беспроводная сеть. Пример: Только 5-гигагерцовый диапазон
	enabled boolean	success	Состояние включения беспроводной сети. Пример: True
	encryptionMode string	success	Метод шифрования беспроводного трафика. Пример: wpa
	ipAssignmentMode string	success	Метод назначения IP-адреса беспроводному клиенту. Пример: Режим NAT
	minBitrate integer	success	Минимальная битовая скорость, с которой может подключаться беспроводной клиент. Пример: 11
	name string	success	Имя беспроводного SSID. Это значение отображается при трансляции. Пример: CorpWireless
	number integer	success	Индекс номера SSID (с нуля).
	perClientBandwidthLimitDown integer	success	Максимальная пропускная способность по загрузке для клиента.
	perClientBandwidthLimitUp integer	success	Максимальная пропускная способность по выгрузке для клиента. Пример: 1000
	psk string	success	Секретный беспроводной пароль. Пример: SecretWiFiPass
	splashPage string	success	Страница приветствия, отображаемая при аутентификации пользователя. Пример: Страница приветствия с переходом
	ssidAdminAccessible boolean	success	Доступно ли SSID для административного доступа. Пример: True
	wpaEncryptionMode string	success	Включенные версии WPA. Пример: Только WPA2

Статус

Данный модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Kevin Breit (@kbreit)

Подсказка

Если вы обнаружите какие-либо проблемы в данной документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/meraki_ssid_module.html