SWAG (Simple Wireless Auth of Guests) Files

+++++++++++++++++++++++++++++++++++++++++++++++++
Readme.txt   Readme.txt  Readme.txt  Readme.txt  
SWAG - SIMPLE WIRELESS AUTHENTICATION OF GUESTS
+++++++++++++++++++++++++++++++++++++++++++++++++

LAST UPDATED: 28 JANUARY 2009

COMING SOON:
	1) main project files
	2) descriptions and ideas for usage
	3) version 1 beta to be release early February
																			|
PROJECT DESCRIPTION:
	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
	not created.
	
PREREQUISITS:
	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.
	
USES:
	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
	aptitude update
	aptitude safe-upgrade
	#install necessary packages
	aptitude install php5-dev php5-cli php-pear build-essential
	#configure openssl
	openssl-dev zlib1g-dev
	#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
	/etc/init.d/apache2 restart
	#that’s it enjoy ( I have noticed in two instances where the server it self needs a reboot before the libriaries were loaded)