---------------------------------
-     pureFTPdLDAPAdmin v1.1	-
-				-
- Copyleft by andre stiehm	-
- Project Page: www.manpage.ch	-
- (a.stiehm at manpage dot ch)	-
-				-
- License: GNU/GPL (2005-01-23)	-
---------------------------------


pureFTPdLDAPAdmin is written in PHP. It's platform-independent and can be used to easily
manage pureFTPd-Users stored in a LDAP Directory


Prerequisits
------------

	- Apache 1x/2x, (use mod_ssl for productive usage)
	- PHP 4x/5x with Extension php_ldap.so
	- A LDAP Server. You can use OpenLDAP or any other Directory Server Product.
	
	You can download the files here:
	
		http://www.apache.org
		http://www.php.net
		http://www.openldap.org	
	
	
	Of course you need the FTP-Package itself:
	
	- pureFTPd 1x (compile with LDAP support)
	
			http://www.pureftpd.org
		
		
	If you need assistance in installation the products, you can use the
	following how-tos (sorry, available only in german...)
	
			http://www.manpage.ch/faq/openldap.php 
			http://www.manpage.ch/faq/pureftpd.php
		
		
	For Login to the administrative GUI, you need to have cookies enabled
	in your favourite browser.
	
	
Installation
------------


	unpack the package to your docroot:
	
		$> unzip pureFTPdLDAP_v1.0.zip 
		(or unpack with WinZip under Windows)
	
	
	--> Use pureFTPdLDAPAdmin with HTTPS, so you can be sure 
	    no passwords are transmitted in cleartext!
	
		
		
	Now you have to create the Logfile und set the file permission to the user
	running the webserver on your system:
	
	
		$> touch /var/log/pureftpdadmin
		$> chown nobody:nogroup /var/log/pureftpdadmin
		
	
	You can change the Path to the Logfile using the Configuration File config/adm_inc.php
	
		
	
Configuration
-------------

	You only need to change the settings into config/adm_inc.php. All Settings are
	described there directly.
	
	You need to have the LDAP Structure already defined.
	
	
	Examples:
	Adminuser for pureFTPdLDAPAdmin:
	
	
		dc=example, dc=org
		|
		|---> ou=FTPAdminGroup
			|
			|---> cn=Admin1
			|---> cn=Admin2
			
	
	FTP-User:
	
		dc=example, dc=org
		|
		|---> ou=FTPUserGroup
			|
			|---> cn=User1
			|---> cn=User2	
			
			
			
First Start
-----------

	You have to be sure the following steps have been done:
	
	1) LDAP-Structure as described above is ready
	2) You have at least one  User into your FTPAdminGroup and
	3) this User must have set the field "description" to "admin" in LDAP
	
	As soon as you are able to login to pureFTPdLDAPAdmin using this User, you can
	add new Administrative Users directly from the applications

	
	Roles
	-----
	
	Roles are defined into the Directory Server in the Field "description".
	The following values are valid:
	
	admin		Can do everything, also add new administrative users
	readwrite	Is able to edit, create and delete pureFTPd Users
	read		Is only able to view pureFTPd Users
	
	
	
	
	
The Frontend is mostly self explaining. For Screenshots,
News and more go to: http://www.manpage.ch/pureFTPdLDAPAdmin/

	
	
			
---------------------------------------------------------------------
-- The author of this software is NOT RESPONSIBLE for any problems --
-- or damages caused by this application. The use of this program  --
-- is your own risk!!!  Thanks for your understanding...           --
---------------------------------------------------------------------