SMBAuth
version 1.1.1
Brian M. Shire <shire@tekrat.com>

Current Components:
	Standalone binary
	Apache module
	PHP extension 
	Jabber module
	Python extension

 Please note that this code was generated with the Samba project's
 authentication code. -thx

 Also note that much of the module code was taken from existing/example
 modules available with each respective package.   

Building:

Standalone binary:

	compile:	
		cd standalone
		make

	usage:
		smbauth (<ENV-User> <ENV-Pass>) <Domain> <PDC> [<BDC>]

Apache module
	
	compile:
		cd apache
		make		# if your apache directory is not in /usr/local/apache or /var/lib/apache,
				# you must edit the makefile INCLUDES variable.
		cp mod_auth_smbauth.so <your_apache_path>/libexec/
	
		Add the following to your httpd.conf in <your_apache_path>/conf/ directory
	
		After the last LoadModule line:
		"LoadModule mod_auth_smbauth libexec/mod_auth_smbauth.so"
		After the last AddModule line:
		"AddModule mod_auth_smbauth.c"	

		
		Use the <directory> directive or create an .htaccess file with the following:
		(note that the allowoveride option must allow htaccess to use .htaccess files)
		AuthType	Basic
		SMBAuth		on
		AuthName	"My little ole authenticator"
		SMBAuth_Domain	MATRIX
		SMBAuth_PDC	trinity
		SMBAuth_BDC	tank
		Require		user shire

PHP extension

	compile:
		This will build a shared object, which can by dynamically loaded into PHP
		without re-compiling.  If you would like to recompile it into php
		please copy the php directory to <phpsource>/ext/smbauth and configure 
		php with the --enable-smbauth flag.

		To build shared object:
		cd php
		./configure
		make
		make install 	# or copy to preferred location
		edit smbauth.php and use "php smbauth.php" to test		

	see smbauth.php for example usage

Jabber !! The Jabber module is considered development at this point, constants in the source will need modification !!

	compile:
		You may need to edit the jabber/Makefile and set the JABBER_ROOT 
		to the path of the jabber source directory.

		cd jabber
		make
		
		Feel free to copy the mod_auth_smbauth.so file into a directory 
		of your choice.  
	
	Use the following configuration in the jabber.xml file:

		<>...

	I have plans to release an ldapvcard module for jabber as well.  This will
	enable the vcard data in jabber to be completed automatically by an ldap 
	request.  When it becomes available it will be at http://www.tekrat.com 

Python
	comile:
		cd python
		make

		see the test.py file for an example usage

Please contact me with any suggestions <shire@tekrat.com>.
