Guest

Cisco IOS Software Releases 12.4 T

SSG Support of WISPr Location Attributes

  • Viewing Options

  • PDF (223.1 KB)
  • Feedback
SSG Support of WISPr Location Attributes

Table Of Contents

SSG Support of WISPr Location Attributes

Contents

Prerequisites for SSG Support of WISPr Location Attributes

Restrictions for SSG Support of WISPr Location Attributes

Information About SSG Support of WISPr Location Attributes

WISPr RADIUS Attributes

How WISPr RADIUS Attributes Are Processed

How to Configure SSG Support of WISPr Location Attributes

Examples

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference


SSG Support of WISPr Location Attributes


Service Selection Gateway (SSG) supports Location-ID and Location-Name, Wireless Internet Service Provider roaming (WISPr) attributes, as specified by the Wi-Fi Alliance.

These two new SSG attributes allow wireless hotspot1 providers to customize Web portals, based on client locations.

This document explains how to enable and use these WISPr attributes.

History for the SSG Support of WISPr Location Attributes Feature

Release
Modification

Cisco IOS Release 12.4(2)T

This feature was introduced.


Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

Prerequisites for SSG Support of WISPr Location Attributes

Restrictions for SSG Support of WISPr Location Attributes

Information About SSG Support of WISPr Location Attributes

How to Configure SSG Support of WISPr Location Attributes

Additional References

Command Reference

Prerequisites for SSG Support of WISPr Location Attributes

Before you can enable and use the WISPr attributes, you must configure:

The RADIUS server to support the logon method.

SSG to authenticate subcribers via RADIUS.

One or more devices, such as an access point (AP), that supports the WISPr RADIUS attributes. The attributes must be configured on all the devices.

Restrictions for SSG Support of WISPr Location Attributes

If the Subscriber Edge Services Manager (SESM), accounting servers, or billing services are not configured to interpret RADIUS WISPr attributes, they ignore those attributes.

For Cisco IOS Release 12.4(2)T, SSG supports only the Location-ID and Location-Name attributes. Other WISPr vendor-specific attributes are not supported with Cisco IOS Release 12.4(2)T.

Information About SSG Support of WISPr Location Attributes

Before you use the RADIUS WISPr attributes, you should understand the following concepts:

WISPr RADIUS Attributes

How WISPr RADIUS Attributes Are Processed

WISPr RADIUS Attributes

SSG supports the following WISPr attributes:

Location-ID

Location-Name

These attributes, which enable wireless hotspot providers to customize their web portals, are based on the client device location and are RADIUS vendor-specific attributes (VSAs). The VSAs are recommended by the WI-FI Alliance in the Best Current Practices for Wireless Internet Service Provider (WISP) Roaming document. WISPr uses a private enterprise number (PEN) of 14122 for these attributes.

Wireless hotspot providers can use WISPr attributes to:

Display a logon page and enforce a preconfigured security list, based on the client location.

Enable auto-logon services based on the location of the user

Bill clients based on their location

Support roaming billing arrangements between service providers

How WISPr RADIUS Attributes Are Processed

The Location-ID and Location-Name attributes are included in the Accounting-Request, Access-Request, and Access-Accept messages.

The Accounting Start event starts before the user logs on or when SSG creates a host object. SSG stores the attributes locally and passes them on to SESM as part of the Status Query response. The attributes are also sent in the host and connection accounting records.

Both authenticated EAPSIM users and open authentication users are supported.


Note For users with Transparent Auto Logon (TAL), SSG includes the WISPr attributes in the Status Query responses to SESM.


How to Configure SSG Support of WISPr Location Attributes

The WISPr Best Current Practices for Wireless Internet Service Provider (WISP) Roaming document lists RADIUS attributes, which APs must send with RADIUS accounting and authentication requests.

APs currently support the following WISPr attributes:

Location-ID

Location-name

Use the snmp-server location and the dot11 location isocc commands to configure these attributes on APs.

The WISPr Best Current Practices for Wireless Internet Service Provider (WISP) Roaming document also requires APs to include a class attribute in RADIUS authentication replies and accounting requests. The APs automatically include the class attribute.

You can find a list of ISO and ITU country and area codes at the ISO and ITU web sites. Cisco IOS software does not check the validity of the country and area codes that you configure on APs.

Refer to SUMMARY STEPS, next, for the command sequence required to configure SSG Support of WISPr Location Attributes.

For a detailed summarization of the command sequence, with examples, refer to DETAILED STEPS.

SUMMARY STEPS

1. enable

2. configure terminal

3. snmp-server location location

4. dot11 location isocc ISO-country-code cc country-code ac area-code

5. end

6. show running-config

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

ap> enable

Enables privileged EXEC mode.

Enter your password, if prompted.

Step 2 

configure terminal

Example:

ap# configure terminal

Enters global configuration mode.

Step 3 

snmp-server location location

Example:

ap(config)# snmp-server location ACMEWISP,Gate_14_Terminal_C_of_Newark_Airport

Specifies the WISPr location-name attribute. The WISPr Best Current Practices for Wireless Internet Service Provider (WISP) Roaming document recommends that you enter the location name, in this format:

hotspot_operator_name,location

Step 4 

dot11 location isocc ISO-country-code
cc country-code ac area-code

Example:

ap(config)# dot11 location isocc us cc 1 ac 408

Specify ISO and ITU country and area codes that the access point includes in accounting and authentication requests.

isocc ISO-country-code—Specifies the ISO country code that the access point includes in RADIUS authentication and accounting requests.

cc country-code—Specifies the ITU country code that the access point includes in RADIUS authentication and accounting requests.

ac area-code—Specifies the ITU area code that the access point includes in RADIUS authentication and accounting requests.

Step 5 

end

Example:

ap(config)# end

Return to privileged EXEC mode.

Step 6 

show running-config

Example:

ap# show running-config

Verify your settings.

Examples

The following command example shows how to configure the WISPr location-name attribute:

ap(config)# snmp-server location ACMEWISP,Gate_14_Terminal_C_of_Newark_Airport 

The following command example shows how to configure the ISO and ITU location codes on the access point:

ap(config)# dot11 location isocc us cc 1 ac 408 

The following command example shows how the access point adds the SSID used by the client device and formats the location-ID string:

isocc=us,cc=1,ac=408,network=ACMEWISP_NewarkAirport 

Additional References

The following sections provide references related to SSG Support of WISPr Location Attributes.

Related Documents

Related Topic
Document Title

Wi-FI Alliance Wireless IP Roaming best practices

Best Current Practices for Wireless Internet Service Provider (WISP) Roaming

SSG commands

Cisco IOS Service Selection Gateway Command Reference, Release 12.4

Configuring SESM

Cisco Subscriber Edge Services Manager documentation.

RADIUS commands

Cisco IOS Security Command Reference, Release 12.4

RADIUS configuration tasks

Cisco IOS Security Configuration Guide, Release 12.4


Standards

Standard
Title

IEEE 802.11b

IEEE Wireless Standards


MIBs

MIB
MIBs Link

None

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs


RFCs

RFC
Title

RFC 2477

Criteria for Evaluating Roaming Protocols

RFC 2865

Remote Authentication Dial In User Service (RADIUS)

RFC 2866

RADIUS Accounting


Technical Assistance

Description
Link

The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/techsupport


Command Reference

This feature uses no new or modified commands.

1 The geographic boundary covered by a wireless access point such as 802.11b or 802.11a. Typically set up for the Internet, anyone entering the hot spot with a 802.11-based laptop has connectivity to the Web.