%META:TOPICINFO{author="lcampos" date="1085143647" format="1.0" version="1.3"}%
---+ LDAP Password Changer TWiki Plugin

This plugin asks for and changes your password at an pre-configured LDAP server.

---++ Syntax Rules

There is only one command to apply, just use %<nop>LDAPPASSWORDCHANGER% and the Plugin will do the rest. 

---++ <nop>%TOPIC% Global Settings

	* One line description, shown in the %TWIKIWEB%.TextFormattingRules topic:
		* Set SHORTDESCRIPTION = LDAP Server user password automated changer.

	* The LDAP Server you will contact:
		* Set LDAP_SERVER = orelhao.integral.com.br
	* Base DN from where searches will start at your server
		* Set LDAP_BASE_DN = dc=integral,dc=com,dc=br
	* Filter to select the *current* user (maybe a lot trickier, suggestions are welcome!)
		* Set LDAP_FILTER = (&(objectClass=posixAccount)(uid=%s))

	* Debug plugin: (See output in =data/debug.txt=)
		* Set DEBUG = 1

---++ Plugin Installation Instructions

__Note:__ You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

	* Download the ZIP file from the Plugin web (see below)
	* Unzip ==%TOPIC%.zip== in your twiki installation directory. Content:
	  | *File:* | *Description:* |
	  | ==data/TWiki/%TOPIC%.txt== | Plugin topic |
	  | ==data/TWiki/%TOPIC%.txt,v== | Plugin topic repository |
	  | ==lib/TWiki/Plugins/%TOPIC%.pm== | Plugin Perl module |
	* Test if the plugin is correctly installed:
		* Create a topic and adds the %<nop>LDAPPASSWORDCHANGER<nop>% tag to it. Preview and Save the test topic. You will see a dialog box asking you your old and new passwords. If you're able to fill the fields and change your LDAP Server user password, everything is ok.

---++ Plugin Info

|  Plugin Author: | %TWIKIWEB%.LuisCampos |
|  Plugin Version: | 20 May 2004 (V1.000) |
|  Change History: | <!-- specify latest version first -->&nbsp; |
|  20 May 2004: | Initial version |
|  CPAN Dependencies: | [[http://search.cpan.org/~gbarr/perl-ldap-0.31/lib/Net/LDAP.pod][Net::LDAP]], [[http://search.cpan.org/author/LDS/CGI.pm-3.05/CGI.pm][CGI]] |
|  Other Dependencies: | Your TWiki should be running under LDAP-based authentication schema |
|  Perl Version: | 5.8.1 |
|  Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
|  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |

__Related Topics:__ %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, DefaultPlugin

-- %MAINWEB%.LuisCampos - 20 May 2004