createSiteWlan

POST https://{{host}}/api/v1/sites/:site_id/wlans

Body Parameters

NOTE: specifically, enablewirelessbridging allows forwarding of DHCP response to client not associated with the AP

RADIUS Parameters

Airwatch Parameters

Cisco CWA Parameters

Cisco CWA (central web authentication) required RADIUS with COA in order to work. See CWA (https://www.cisco.com/c/en/us/support/docs/security/identity-services-engine/115732-central-web-auth-00.html).

QoS Parameters

Bonjour Parameters

Note: bonjour settings supercedes allow_mdns

Hostpot 2.0 Parameters

Data Tunnels Parameters

Others Parameters

Data Rates Parameters

Rate Limit Parameters

Guest Portal Parameters

Request Body

{"ssid"=>"corporate", "enabled"=>true, "auth"=>{"type"=>"psk", "psk"=>"foryoureyesonly", "enable_mac_auth"=>false, "multi_psk_only"=>false, "pairwise"=>["wpa1-ccmp", "wpa2-tkip", "wpa1-tkip", "wpa2-ccmp", "wpa3"], "wep_as_secondary_auth"=>false, "keys"=>["1234567890", nil, "0987654321", nil], "key_idx"=>1, "eap_reauth"=>false, "owe"=>"enabled", "private_wlan"=>true, "anticlog_threshold"=>16}, "dynamic_psk"=>{"enabled"=>true, "source"=>"radius", "default_vlan_id"=>999, "default_psk"=>"foryoureyesonly", "force_lookup"=>false}, "roam_mode"=>"none", "auth_servers_nas_id"=>"5c5b350e0101-nas", "auth_servers_nas_ip"=>"15.3.1.5", "auth_servers_timeout"=>5, "auth_servers_retries"=>3, "auth_server_selection"=>"ordered", "auth_servers"=>[{"host"=>"1.2.3.4", "port"=>1812, "secret"=>"testing123"}, {"host"=>"radius.internal", "port"=>1812, "secret"=>"testing123"}, {"host"=>"radius2", "port"=>1812, "secret"=>"testing123", "keywrap_enabled"=>true, "keywrap_format"=>"hex", "keywrap_kek"=>"1122334455", "keywrap_mack"=>"1122334455"}], "acct_servers"=>[{"host"=>"1.2.3.4", "port"=>1812, "secret"=>"testing123"}, {"host"=>"radius2", "port"=>1812, "secret"=>"testing123", "keywrap_enabled"=>true, "keywrap_format"=>"hex", "keywrap_kek"=>"1122334455", "keywrap_mack"=>"1122334455"}], "acct_interim_interval"=>0, "dynamic_vlan"=>{"enabled"=>true, "type"=>"airespace-interface-name", "vlans"=>[nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, "default", nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, "fast,video"], "default_vlan_id"=>999}, "dns_server_rewrite"=>{"enabled"=>true, "radius_groups"=>{"contractor"=>"172.1.1.1", "guest"=>"8.8.8.8"}}, "coa_servers"=>[{"enabled"=>false, "ip"=>"1.2.3.4", "port"=>3799, "secret"=>"testing456", "disable_event_timestamp_check"=>false}], "radsec"=>{"enabled"=>true, "server_name"=>"radsec.abc.com", "servers"=>[{"host"=>"1.1.1.1", "port"=>1812}, {"host"=>"radsec", "port"=>1812}], "idle_timeout"=>60, "use_mxedge"=>true, "coa_enabled"=>true, "mxcluster_ids"=>["572586b7-f97b-a22b-526c-8b97a3f609c4"], "use_site_mxedge"=>false, "proxy_hosts"=>["mxedge1.local"]}, "mist_nac"=>{"enabled"=>true}, "airwatch"=>{"enabled"=>true, "console_url"=>"https://hs1.airwatchportals.com", "api_key"=>"aHhlbGxvYXNkZmFzZGZhc2Rmc2RmCg==", "username"=>"user1", "password"=>"test123"}, "cisco_cwa"=>{"enabled"=>false, "allowed_subnets"=>["63.5.3.0/24"], "blocked_subnets"=>["192.168.0.0/16", "172.16.0.0/12"], "allowed_hostnames"=>["snapchat.com", "ibm.com"]}, "band"=>"24", "bands"=>["24", "5", "6"], "band_steer"=>true, "band_steer_force_band5"=>true, "rateset"=>[nil, nil, nil, nil, nil, {"min_rssi"=>-70, "template"=>"custom", "legacy"=>["6", "9", "12", "18", "24b", "36", "48", "54"], "ht"=>"00ff00ff00ff", "vht"=>"03ff03ff03ff01ff"}, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, {"min_rssi"=>0, "template"=>"default", "legacy"=>["1", "2b", "5.5", "11", "6", "9", "12", "18", "24", "36", "48", "54"], "ht"=>"00ff00ff00ff"}], "disable_ht_vht_rates"=>true, "disable_11ax"=>false, "interface"=>"site_mxedge", "vlan_enabled"=>false, "vlan_id"=>3, "vlan_pooling"=>false, "vlan_ids"=>[3, 4, 5], "wxtunnel_id"=>"7dae216d-7c98-a51b-e068-dd7d477b7216", "wxtunnel_remote_id"=>"wifiguest", "mxtunnel_ids"=>["08cd7499-5841-51c8-e663-fb16b6f3b45e"], "mxtunnel_names"=>["default"], "hide_ssid"=>false, "dtim"=>2, "disable_wmm"=>false, "disable_uapsd"=>false, "use_eapol_v1"=>false, "legacy_overds"=>false, "hostname_ie"=>false, "enable_local_keycaching"=>true, "isolation"=>false, "l2_isolation"=>false, "arp_filter"=>true, "limit_bcast"=>false, "allow_mdns"=>false, "allow_ssdp"=>false, "allow_ipv6_ndp"=>true, "no_static_ip"=>false, "no_static_dns"=>false, "limit_probe_response"=>false, "enable_wireless_bridging"=>false, "enable_wireless_bridging_dhcp_tracking"=>false, "block_blacklist_clients"=>false, "apply_to"=>"site", "wlan_limit_up_enabled"=>true, "wlan_limit_up"=>10240, "wlan_limit_down_enabled"=>true, "wlan_limit_down"=>20480, "client_limit_up_enabled"=>true, "client_limit_up"=>512, "client_limit_down_enabled"=>true, "client_limit_down"=>1024, "schedule"=>{"enabled"=>true, "hours"=>{"mon"=>"09:00-17:00", "fri"=>"09:00-17:00"}}, "qos"=>{"overwrite"=>true, "class"=>"best_effort"}, "app_limit"=>{"enabled"=>true, "apps"=>{"netflix"=>60, "dropbox"=>300}, "wxtag_ids"=>{"f99862d9-2726-931f-7559-3dfdf5d070d3"=>30}}, "app_qos"=>{"enabled"=>true, "apps"=>{"skype-business-voice"=>{"dscp"=>46}, "skype-business-video"=>{"dscp"=>32, "src_subnet"=>"10.2.0.0/16", "dst_subnet"=>"10.2.0.0/16"}}, "others"=>[{"protocol"=>"udp", "src_subnet"=>"10.2.0.0/16", "dst_subnet"=>"10.2.0.0/16", "port_ranges"=>"80,1024-65535", "dscp"=>32}]}, "bonjour"=>{"enabled"=>true, "services"=>{"airprint"=>{"scope"=>"same_map"}, "airplay"=>{"scope"=>"same_ap", "radius_groups"=>["teachers"]}}, "additional_vlan_ids"=>[80], "disable_local"=>false}, "hotspot20"=>{"enabled"=>true, "operators"=>["google", "att"], "venue_name"=>"some_name", "domain_name"=>["mist.com"], "rcoi"=>["5A03BA0000"], "nai_realms"=>[{"id"=>"mistsys.com", "eap_type"=>"tls"}]}, "inject_dhcp_option_82"=>{"enabled"=>true, "circuit_id"=>"{{SSID}}:{{AP_MAC}}"}, "max_idletime"=>1800, "sle_excluded"=>false, "disable_v1_roam_notify"=>true, "disable_v2_roam_notify"=>false, "portal"=>{"enabled"=>true, "auth"=>"sso", "sso_issuer"=>"https://app.onelogin.com/saml/metadata/138130", "sso_idp_cert"=>"-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----", "sso_idp_sign_algo"=>"sha256", "sso_idp_sso_url"=>"https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130", "sso_nameid_format"=>"email", "sso_forced_role"=>"desired", "sso_default_role"=>"guest"}, "portal_template_url"=>"https://......", "portal_image"=>"https://url/to/image.png", "thumbnail"=>"https://url/to/image.png", "portal_api_secret"=>"EIfPMOykI3lMlDdNPub2WcbqT6dNOtWwmYHAd6bY", "portal_sso_url"=>"https://portal.mist.com/saml/be22bba7-8e22-e1cf-5185-b880816fe2cf/login", "portal_allowed_subnets"=>["63.5.3.0/24"], "portal_allowed_hostnames"=>["snapchat.com", "ibm.com"], "portal_denied_hostnames"=>["msg.snapchat.com"]}

HEADERS