:source: fortios_wireless_controller_hotspot20_hs_profile.py
:orphan:
.. fortios_wireless_controller_hotspot20_hs_profile:
fortios_wireless_controller_hotspot20_hs_profile -- Configure hotspot profile in Fortinet's FortiOS and FortiGate.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
.. versionadded:: 2.0.0
.. contents::
:local:
:depth: 1
Synopsis
--------
- This module is able to configure a FortiGate or FortiOS (FOS) device by allowing the user to set and modify wireless_controller_hotspot20 feature and hs_profile category. Examples include all parameters and values need to be adjusted to datasources before usage. Tested with FOS v6.0.0
Requirements
------------
The below requirements are needed on the host that executes this module.
- ansible>=2.16
Tips
----
Using member operation to add an element to an existing object.
FortiOS Version Compatibility
-----------------------------
Supported Version Ranges: v6.0.0 -> v7.6.6
Parameters
----------
.. raw:: html
- access_token - Token-based authentication. Generated from GUI of Fortigate. type: str required: false
- enable_log - Enable/Disable logging for task. type: bool required: false default: False
- vdom - Virtual domain, among those defined previously. A vdom is a virtual instance of the FortiGate that can be configured and used as a different unit. type: str default: root
- member_path - Member attribute path to operate on. type: str
- member_state - Add or delete a member under specified attribute path. type: str choices: present, absent
- state - Indicates whether to create or remove the object. type: str required: true choices: present, absent
- wireless_controller_hotspot20_hs_profile - Configure hotspot profile. type: dict
more...
| Supported Version Ranges |
| wireless_controller_hotspot20_hs_profile |
v6.0.0 -> 7.6.6 |
- plmn_3gpp - 3GPP PLMN name. Source wireless-controller.hotspot20.anqp-3gpp-cellular.name. type: str
more...
|
Supported Version Ranges |
| plmn_3gpp |
v6.0.0 -> 7.6.6 |
- access_network_asra - Enable/disable additional step required for access (ASRA). type: str choices: enable, disable
more...
|
Supported Version Ranges |
| access_network_asra |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- access_network_esr - Enable/disable emergency services reachable (ESR). type: str choices: enable, disable
more...
|
Supported Version Ranges |
| access_network_esr |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- access_network_internet - Enable/disable connectivity to the Internet. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| access_network_internet |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- access_network_type - Access network type. type: str choices: private-network, private-network-with-guest-access, chargeable-public-network, free-public-network, personal-device-network, emergency-services-only-network, test-or-experimental, wildcard
more...
|
Supported Version Ranges |
| access_network_type |
v6.0.0 -> 7.6.6 |
| [private-network] |
v6.0.0 -> 7.6.6 |
| [private-network-with-guest-access] |
v6.0.0 -> 7.6.6 |
| [chargeable-public-network] |
v6.0.0 -> 7.6.6 |
| [free-public-network] |
v6.0.0 -> 7.6.6 |
| [personal-device-network] |
v6.0.0 -> 7.6.6 |
| [emergency-services-only-network] |
v6.0.0 -> 7.6.6 |
| [test-or-experimental] |
v6.0.0 -> 7.6.6 |
| [wildcard] |
v6.0.0 -> 7.6.6 |
- access_network_uesa - Enable/disable unauthenticated emergency service accessible (UESA). type: str choices: enable, disable
more...
|
Supported Version Ranges |
| access_network_uesa |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- advice_of_charge - Advice of charge. Source wireless-controller.hotspot20.h2qp-advice-of-charge.name. type: str
more...
|
Supported Version Ranges |
| advice_of_charge |
v7.0.2 -> 7.6.6 |
- anqp_domain_id - ANQP Domain ID (0-65535). type: int
more...
|
Supported Version Ranges |
| anqp_domain_id |
v6.0.0 -> 7.6.6 |
- bss_transition - Enable/disable basic service set (BSS) transition Support. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| bss_transition |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- conn_cap - Connection capability name. Source wireless-controller.hotspot20.h2qp-conn-capability.name. type: str
more...
|
Supported Version Ranges |
| conn_cap |
v6.0.0 -> 7.6.6 |
- deauth_request_timeout - Deauthentication request timeout (in seconds). type: int
more...
|
Supported Version Ranges |
| deauth_request_timeout |
v6.0.0 -> 7.6.6 |
- dgaf - Enable/disable downstream group-addressed forwarding (DGAF). type: str choices: enable, disable
more...
|
Supported Version Ranges |
| dgaf |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- domain_name - Domain name. type: str
more...
|
Supported Version Ranges |
| domain_name |
v6.0.0 -> 7.6.6 |
- gas_comeback_delay - GAS comeback delay (0 or 100 - 10000 milliseconds). type: int
more...
|
Supported Version Ranges |
| gas_comeback_delay |
v6.0.0 -> 7.6.6 |
- gas_fragmentation_limit - GAS fragmentation limit (512 - 4096). type: int
more...
|
Supported Version Ranges |
| gas_fragmentation_limit |
v6.0.0 -> 7.6.6 |
- hessid - Homogeneous extended service set identifier (HESSID). type: str
more...
|
Supported Version Ranges |
| hessid |
v6.0.0 -> 7.6.6 |
- ip_addr_type - IP address type name. Source wireless-controller.hotspot20.anqp-ip-address-type.name. type: str
more...
|
Supported Version Ranges |
| ip_addr_type |
v6.0.0 -> 7.6.6 |
- l2tif - Enable/disable Layer 2 traffic inspection and filtering. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| l2tif |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- nai_realm - NAI realm list name. Source wireless-controller.hotspot20.anqp-nai-realm.name. type: str
more...
|
Supported Version Ranges |
| nai_realm |
v6.0.0 -> 7.6.6 |
- name - Hotspot profile name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v6.0.0 -> 7.6.6 |
- network_auth - Network authentication name. Source wireless-controller.hotspot20.anqp-network-auth-type.name. type: str
more...
|
Supported Version Ranges |
| network_auth |
v6.0.0 -> 7.6.6 |
- oper_friendly_name - Operator friendly name. Source wireless-controller.hotspot20.h2qp-operator-name.name. type: str
more...
|
Supported Version Ranges |
| oper_friendly_name |
v6.0.0 -> 7.6.6 |
- oper_icon - Operator icon. Source wireless-controller.hotspot20.icon.name. type: str
more...
|
Supported Version Ranges |
| oper_icon |
v7.0.2 -> 7.6.6 |
- osu_provider - Manually selected list of OSU provider(s). type: list member_path: osu_provider:name
more...
| Supported Version Ranges |
| osu_provider |
v6.0.0 -> 7.6.6 |
- name - OSU provider name. Source wireless-controller.hotspot20.h2qp-osu-provider.name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v6.0.0 -> 7.6.6 |
- osu_provider_nai - OSU Provider NAI. Source wireless-controller.hotspot20.h2qp-osu-provider-nai.name. type: str
more...
|
Supported Version Ranges |
| osu_provider_nai |
v7.0.2 -> 7.6.6 |
- osu_ssid - Online sign up (OSU) SSID. type: str
more...
|
Supported Version Ranges |
| osu_ssid |
v6.0.0 -> 7.6.6 |
- pame_bi - Enable/disable Pre-Association Message Exchange BSSID Independent (PAME-BI). type: str choices: disable, enable
more...
|
Supported Version Ranges |
| pame_bi |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
- proxy_arp - Enable/disable Proxy ARP. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| proxy_arp |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- qos_map - QoS MAP set ID. Source wireless-controller.hotspot20.qos-map.name. type: str
more...
|
Supported Version Ranges |
| qos_map |
v6.0.0 -> 7.6.6 |
- release - Hotspot 2.0 Release number (1, 2, 3). type: int
more...
|
Supported Version Ranges |
| release |
v7.0.2 -> 7.6.6 |
- roaming_consortium - Roaming consortium list name. Source wireless-controller.hotspot20.anqp-roaming-consortium.name. type: str
more...
|
Supported Version Ranges |
| roaming_consortium |
v6.0.0 -> 7.6.6 |
- terms_and_conditions - Terms and conditions. Source wireless-controller.hotspot20.h2qp-terms-and-conditions.name. type: str
more...
|
Supported Version Ranges |
| terms_and_conditions |
v7.0.2 -> 7.6.6 |
- venue_group - Venue group. type: str choices: unspecified, assembly, business, educational, factory, institutional, mercantile, residential, storage, utility, vehicular, outdoor
more...
|
Supported Version Ranges |
| venue_group |
v6.0.0 -> 7.6.6 |
| [unspecified] |
v6.0.0 -> 7.6.6 |
| [assembly] |
v6.0.0 -> 7.6.6 |
| [business] |
v6.0.0 -> 7.6.6 |
| [educational] |
v6.0.0 -> 7.6.6 |
| [factory] |
v6.0.0 -> 7.6.6 |
| [institutional] |
v6.0.0 -> 7.6.6 |
| [mercantile] |
v6.0.0 -> 7.6.6 |
| [residential] |
v6.0.0 -> 7.6.6 |
| [storage] |
v6.0.0 -> 7.6.6 |
| [utility] |
v6.0.0 -> 7.6.6 |
| [vehicular] |
v6.0.0 -> 7.6.6 |
| [outdoor] |
v6.0.0 -> 7.6.6 |
- venue_name - Venue name. Source wireless-controller.hotspot20.anqp-venue-name.name. type: str
more...
|
Supported Version Ranges |
| venue_name |
v6.0.0 -> 7.6.6 |
- venue_type - Venue type. type: str choices: unspecified, arena, stadium, passenger-terminal, amphitheater, amusement-park, place-of-worship, convention-center, library, museum, restaurant, theater, bar, coffee-shop, zoo-or-aquarium, emergency-center, doctor-office, bank, fire-station, police-station, post-office, professional-office, research-facility, attorney-office, primary-school, secondary-school, university-or-college, factory, hospital, long-term-care-facility, rehab-center, group-home, prison-or-jail, retail-store, grocery-market, auto-service-station, shopping-mall, gas-station, private, hotel-or-motel, dormitory, boarding-house, automobile, airplane, bus, ferry, ship-or-boat, train, motor-bike, muni-mesh-network, city-park, rest-area, traffic-control, bus-stop, kiosk
more...
|
Supported Version Ranges |
| venue_type |
v6.0.0 -> 7.6.6 |
| [unspecified] |
v6.0.0 -> 7.6.6 |
| [arena] |
v6.0.0 -> 7.6.6 |
| [stadium] |
v6.0.0 -> 7.6.6 |
| [passenger-terminal] |
v6.0.0 -> 7.6.6 |
| [amphitheater] |
v6.0.0 -> 7.6.6 |
| [amusement-park] |
v6.0.0 -> 7.6.6 |
| [place-of-worship] |
v6.0.0 -> 7.6.6 |
| [convention-center] |
v6.0.0 -> 7.6.6 |
| [library] |
v6.0.0 -> 7.6.6 |
| [museum] |
v6.0.0 -> 7.6.6 |
| [restaurant] |
v6.0.0 -> 7.6.6 |
| [theater] |
v6.0.0 -> 7.6.6 |
| [bar] |
v6.0.0 -> 7.6.6 |
| [coffee-shop] |
v6.0.0 -> 7.6.6 |
| [zoo-or-aquarium] |
v6.0.0 -> 7.6.6 |
| [emergency-center] |
v6.0.0 -> 7.6.6 |
| [doctor-office] |
v6.0.0 -> 7.6.6 |
| [bank] |
v6.0.0 -> 7.6.6 |
| [fire-station] |
v6.0.0 -> 7.6.6 |
| [police-station] |
v6.0.0 -> 7.6.6 |
| [post-office] |
v6.0.0 -> 7.6.6 |
| [professional-office] |
v6.0.0 -> 7.6.6 |
| [research-facility] |
v6.0.0 -> 7.6.6 |
| [attorney-office] |
v6.0.0 -> 7.6.6 |
| [primary-school] |
v6.0.0 -> 7.6.6 |
| [secondary-school] |
v6.0.0 -> 7.6.6 |
| [university-or-college] |
v6.0.0 -> 7.6.6 |
| [factory] |
v6.0.0 -> 7.6.6 |
| [hospital] |
v6.0.0 -> 7.6.6 |
| [long-term-care-facility] |
v6.0.0 -> 7.6.6 |
| [rehab-center] |
v6.0.0 -> 7.6.6 |
| [group-home] |
v6.0.0 -> 7.6.6 |
| [prison-or-jail] |
v6.0.0 -> 7.6.6 |
| [retail-store] |
v6.0.0 -> 7.6.6 |
| [grocery-market] |
v6.0.0 -> 7.6.6 |
| [auto-service-station] |
v6.0.0 -> 7.6.6 |
| [shopping-mall] |
v6.0.0 -> 7.6.6 |
| [gas-station] |
v6.0.0 -> 7.6.6 |
| [private] |
v6.0.0 -> 7.6.6 |
| [hotel-or-motel] |
v6.0.0 -> 7.6.6 |
| [dormitory] |
v6.0.0 -> 7.6.6 |
| [boarding-house] |
v6.0.0 -> 7.6.6 |
| [automobile] |
v6.0.0 -> 7.6.6 |
| [airplane] |
v6.0.0 -> 7.6.6 |
| [bus] |
v6.0.0 -> 7.6.6 |
| [ferry] |
v6.0.0 -> 7.6.6 |
| [ship-or-boat] |
v6.0.0 -> 7.6.6 |
| [train] |
v6.0.0 -> 7.6.6 |
| [motor-bike] |
v6.0.0 -> 7.6.6 |
| [muni-mesh-network] |
v6.0.0 -> 7.6.6 |
| [city-park] |
v6.0.0 -> 7.6.6 |
| [rest-area] |
v6.0.0 -> 7.6.6 |
| [traffic-control] |
v6.0.0 -> 7.6.6 |
| [bus-stop] |
v6.0.0 -> 7.6.6 |
| [kiosk] |
v6.0.0 -> 7.6.6 |
- venue_url - Venue name. Source wireless-controller.hotspot20.anqp-venue-url.name. type: str
more...
|
Supported Version Ranges |
| venue_url |
v7.0.2 -> 7.6.6 |
- wan_metrics - WAN metric name. Source wireless-controller.hotspot20.h2qp-wan-metric.name. type: str
more...
|
Supported Version Ranges |
| wan_metrics |
v6.0.0 -> 7.6.6 |
- wba_charging_currency - Three letter currency code. type: str
more...
|
Supported Version Ranges |
| wba_charging_currency |
v7.6.0 -> 7.6.6 |
- wba_charging_rate - Number of currency units per kilobyte. type: int
more...
|
Supported Version Ranges |
| wba_charging_rate |
v7.6.0 -> 7.6.6 |
- wba_data_clearing_provider - WBA ID of data clearing provider. type: str
more...
|
Supported Version Ranges |
| wba_data_clearing_provider |
v7.6.0 -> 7.6.6 |
- wba_financial_clearing_provider - WBA ID of financial clearing provider. type: str
more...
|
Supported Version Ranges |
| wba_financial_clearing_provider |
v7.6.0 -> 7.6.6 |
- wba_open_roaming - Enable/disable WBA open roaming support. type: str choices: disable, enable
more...
|
Supported Version Ranges |
| wba_open_roaming |
v7.6.0 -> 7.6.6 |
| [disable] |
v7.6.0 -> 7.6.6 |
| [enable] |
v7.6.0 -> 7.6.6 |
- wnm_sleep_mode - Enable/disable wireless network management (WNM) sleep mode. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| wnm_sleep_mode |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
Notes
-----
.. note::
- Legacy fortiosapi has been deprecated, httpapi is the preferred way to run playbooks
- The module supports check_mode.
Examples
--------
.. code-block:: yaml+jinja
- name: Configure hotspot profile.
fortinet.fortios.fortios_wireless_controller_hotspot20_hs_profile:
vdom: "{{ vdom }}"
state: "present"
access_token: ""
wireless_controller_hotspot20_hs_profile:
plmn_3gpp: " (source wireless-controller.hotspot20.anqp-3gpp-cellular.name)"
access_network_asra: "enable"
access_network_esr: "enable"
access_network_internet: "enable"
access_network_type: "private-network"
access_network_uesa: "enable"
advice_of_charge: " (source wireless-controller.hotspot20.h2qp-advice-of-charge.name)"
anqp_domain_id: "0"
bss_transition: "enable"
conn_cap: " (source wireless-controller.hotspot20.h2qp-conn-capability.name)"
deauth_request_timeout: "60"
dgaf: "enable"
domain_name: ""
gas_comeback_delay: "500"
gas_fragmentation_limit: "1024"
hessid: ""
ip_addr_type: " (source wireless-controller.hotspot20.anqp-ip-address-type.name)"
l2tif: "enable"
nai_realm: " (source wireless-controller.hotspot20.anqp-nai-realm.name)"
name: "default_name_22"
network_auth: " (source wireless-controller.hotspot20.anqp-network-auth-type.name)"
oper_friendly_name: " (source wireless-controller.hotspot20.h2qp-operator-name.name)"
oper_icon: " (source wireless-controller.hotspot20.icon.name)"
osu_provider:
-
name: "default_name_27 (source wireless-controller.hotspot20.h2qp-osu-provider.name)"
osu_provider_nai: " (source wireless-controller.hotspot20.h2qp-osu-provider-nai.name)"
osu_ssid: ""
pame_bi: "disable"
proxy_arp: "enable"
qos_map: " (source wireless-controller.hotspot20.qos-map.name)"
release: "2"
roaming_consortium: " (source wireless-controller.hotspot20.anqp-roaming-consortium.name)"
terms_and_conditions: " (source wireless-controller.hotspot20.h2qp-terms-and-conditions.name)"
venue_group: "unspecified"
venue_name: " (source wireless-controller.hotspot20.anqp-venue-name.name)"
venue_type: "unspecified"
venue_url: " (source wireless-controller.hotspot20.anqp-venue-url.name)"
wan_metrics: " (source wireless-controller.hotspot20.h2qp-wan-metric.name)"
wba_charging_currency: ""
wba_charging_rate: "0"
wba_data_clearing_provider: ""
wba_financial_clearing_provider: ""
wba_open_roaming: "disable"
wnm_sleep_mode: "enable"
Return Values
-------------
Common return values are documented: https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values, the following are the fields unique to this module:
.. raw:: html
- build - Build number of the fortigate image returned: always type: str sample: 1547
- http_method - Last method used to provision the content into FortiGate returned: always type: str sample: PUT
- http_status - Last result given by FortiGate on last operation applied returned: always type: str sample: 200
- mkey - Master key (id) used in the last call to FortiGate returned: success type: str sample: id
- name - Name of the table used to fulfill the request returned: always type: str sample: urlfilter
- path - Path of the table used to fulfill the request returned: always type: str sample: webfilter
- revision - Internal revision number returned: always type: str sample: 17.0.2.10658
- serial - Serial number of the unit returned: always type: str sample: FGVMEVYYQT3AB5352
- status - Indication of the operation's result returned: always type: str sample: success
- vdom - Virtual domain used returned: always type: str sample: root
- version - Version of the FortiGate returned: always type: str sample: v5.6.3
Status
------
- This module is not guaranteed to have a backwards compatible interface.
Authors
-------
- Link Zheng (@chillancezen)
- Jie Xue (@JieX19)
- Hongbin Lu (@fgtdev-hblu)
- Frank Shen (@frankshen01)
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
.. hint::
If you notice any issues in this documentation, you can create a pull request to improve it.