Readme.txt Readme.txt Readme.txt Readme.txt
SWAG - SIMPLE WIRELESS AUTHENTICATION OF GUESTS
LAST UPDATED: 28 JANUARY 2009
1) main project files
2) descriptions and ideas for usage
3) version 1 beta to be release early February
SWAG, Simple Wireless Authentication of Guests is just that, a simple way
to authenticate guest users on to a guest wireless network. This tool
takes care of creating the username and password. It then submits this
information to the wireless controller over ssh and sets up the account
with a lifetime of 12 hours (adjustable). The results are then displayed
on a printable instruction sheet for the guest to use. The software does
NOT store any wireless controller usernames or passwords for security
purposes. It does however keep a log of all created guest usernames and
passwords along with the guest name, date and time of creation. In
a future release this will be used to make sure that duplicate users are
Webserver running php5 and has the ssh2 libraries installed.
This has been tested on Ubuntu with php5, apache2, mysql5 and ssh2.
For a good set of instruction on how to install ssh2 libraries I
have referenced this website: http://www.how2pc.co.il/blog/2009/08/how-to-install-a-php-ssh2-extension-on-ubuntu-server-9-04/
See section below on the instructions that were copied from that site.
A front desk administrator can easily create a guest wireless user for
visitors to your corporation. The underlying code allows for the adaption
of many different functions that can be carried out over the CLI and
and scripted into a simple web interface, all over a ssh2 connection.
REASON FOR THE PROJECT:
In a recent search for something similar nothing was found that would
satisfy the need. This projects goal is to simplify the every day
administrative task of running a wireless network.
SSH2 INSTALLATION INSTRUCTIONS:
#first we update the system
#install necessary packages
aptitude install php5-dev php5-cli php-pear build-essential
#install libssh2 ext
aptitude install libssh2-1-dev
#install the pecl ext
pecl install -f ssh2
#add the ext to the configuration file
echo extension=ssh2.so > /etc/php5/conf.d/ssh2.ini #This may need to be manually created
#restart the apache server
#thats it enjoy ( I have noticed in two instances where the server it self needs a reboot before the libriaries were loaded)