110
Public Space Parameters
Designing a Portal Page
A Portal Page is a Web page; you can design it using whatever Web design tools you have available. The Portal Page
does not have to be very complicated. At its most basic, the Portal Page needs a link to the AP’s Login page.
The AP’s standard Internal Login page is located at:
http://APIPADDR:1111/usg/login?OS=http://www.anyWebSite.com/
where:
•
APIPADDR
is the AP’s IP address
— Some portal pages can obtain the AP’s IP address automatically from the redirected HTTP request
(such as the ASP sample pages provided with the AP). See
Enabling the AP-2500 to Use a Portal
Page
>
ASP
for an example.
•
www.anyWebSite.com
is any Web site that you choose
— The AP-2500 needs an Origin Server (OS) statement to function properly. Typically this would be the
user’s default home page or requested page but if you are using plain HTML, you must specify a URL
for the Portal Page to work properly. The HTML sample file uses
www.yahoo.com
.
— In general, this should be a Web site that you want to direct your customers to after successful login
(similar to the
Home Page Redirection (HPR)
feature).
NOTE:
If you enabled
Secure Socket Layer (SSL)
, the secure Login page is located at:
http://[Certificate DNS Name]:1112/usg/login?OS=http://www.anyWebSite.com/
Proxim provides two sample Portal Pages for the AP-2500 to help hotspot operators who have limited Web design
experience get started. These sample pages are in the CD’s
Docs/samples/
folder. Alternatively, you can download
the sample pages from Proxim’s Web site at
http://www.proxim.com/
.
The first sample page is an HTML file called
portalpage.html
. This is a Portal Page at its most basic. This page is
suitable if you plan to use
Home Page Redirection
to direct subscribers to a specific Web site following successful
authentication. With this option, your customer is not automatically returned to his browser’s default home page.
The second sample contains two Active Server Page (ASP) files:
portalpage.asp
and
confirm.asp
. Microsoft’s IIS uses
this file type; the ASP files contain script commands that are processed by the IIS server. You can use these files if you
use Microsoft IIS and you want to incorporate some additional features, namely:
•
Redirect customers back to the Web site they initially requested before viewing the Portal Page (typically their
browser’s home page).
•
Provide User Name and Password fields on your Portal Page so customers can login directly from that screen.
— This feature uses a Form to send the User Name and Password information to the AP (HTTP POST
command). The User Name/Password form uses the following syntax to create a
User Name
field, a
Password
field, and a
Submit
button on a Web page:
<FORM name=member
action="http://<%=request("IP")%>:1111/usg/process?OS=<%=request("?OS")%>&" method="POST">
<p> <b>Enter your Username :</b> <input type="text" name="username" size="20"> </p>
<p> <b>Enter your Password :</b> <input type="password" name="password" size="20"> </p>
<p> <INPUT TYPE="submit" VALUE="Submit Query"> </p>
</FORM>
—
<%=request("IP")%>
notifies an IIS server to parse out the AP’s IP address from the HTTP redirect
request.
—
<%=request("?OS")%>
notifies an IIS server to parse out the subscriber’s original request from the
HTTP redirect request.
— Refer to the
portalpage.asp
file for more information.
NOTE:
Proxim also provides a sample Perl file on the installation CD. This file offer similar features to
the portalpage.asp file but can be used with any Web server that supports Perl scripts. This file
is intended for advanced users who have experience with Perl. If you want to use the Perl
sample, follow the instructions below for the ASP pages. However, note that the Perl sample
does not include an equivalent to confirm.asp. Also, you must have a Perl application installed
on your server and the folder on your Web server that will contain the Perl file must be
configured to execute Perl scripts that use a .pl extension.
Deciding which sample is right for your hotspot depends on the customer experience you want to provide. The
sections below describe how the customer interacts with the AP-2500 under the following scenarios: