NAME

RT::Extension::ResetPassword - add "forgot your password?" link to RT instance

DESCRIPTION

This extension for RT adds a new "Forgot your password?" link to the front of your RT instance. Any user can request that RT send them a password reset token by email. RT will send the user a one-time URL which he or she can use to reset her password. This extension allows only users that already have passwords reset their passwords by email. There isn't yet an option to only allow privileged or unpriviliged users to reset their passwords.

INSTALLATION

perl Makefile.PL

make

make install

May need root permissions

make initdb

Only run this the first time you install this module.

If you run this twice, you may end up with duplicate data in your database.

If you are upgrading this module, check for upgrading instructions in case changes need to be made to your database.

Edit your /opt/rt4/etc/RT_SiteConfig.pm

If you are using RT 4.2 or greater, add this line:

Plugin('RT::Extension::ResetPassword');

For RT 4.0, add this line:

Set(@Plugins, qw(RT::Extension::ResetPassword));

or add RT::Extension::ResetPassword to your existing @Plugins line.

Clear your mason cache

rm -rf /opt/rt4/var/mason_data/obj

Restart your webserver

UPGRADING

If you are upgrading from version 0.05, you will need to run make initdb as documented in INSTALLATION to install the Template used by this Extension.

CONFIGURATION

The contents of the email sent to users can be found in the global PasswordReset template (do not confuse this with the core PasswordChange template).

If you want to prevent unauthorised visitors from determining what user accounts exist and whether they are disabled, set HidePasswordResetErrors to 1 in your RT configuration; then any password reset request will appear to the requestor to have resulted in an email being sent, thus not revealing the reasons for any failure. All failures will still be logged with an appropriate diagnostic message.

AUTHOR

Best Practical Solutions, LLC <modules@bestpractical.com>

BUGS

All bugs should be reported via email to

L<bug-RT-Extension-ResetPassword@rt.cpan.org|mailto:bug-RT-Extension-ResetPassword@rt.cpan.org>

or via the web at

L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-ResetPassword>.

LICENSE AND COPYRIGHT

This software is Copyright (c) 2012-2014 by Best Practical Solutions, LLC

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991