########################################################
# 	Mantis Bugtracker Add-On
# 	adLogin Version 1.00
#	2010 plugin by Cas Nuy www.NUY.info
########################################################

This plugin allows for integrated login with AD credentials.

If you installed Mantis under IIS and want to have single signon with AD, all you need to do is the following: 
1. Disable Anonymous access for the Mantis website 
2. Ensure Integrated Windows Authentication is ticked 
Users listed in the user-table with their windows username, will be automatically logged on.

********************************************************************************************
* Installation                                                                             *
********************************************************************************************
Like any other plugin. 

This plugin uses the function auth_attempt_script_login, which in the past was enough for getting access.
As of version 1.2.x this function offers less functionality than before.
This fuction is available in core\authentication_api.php
In order to overcome this, one needs to add 3 lines at the end of this function:
# set the cookies
	$p_perm_login=false;
	auth_set_cookies( $t_user_id, $p_perm_login );
	auth_set_tokens( $t_user_id );
	
Add these just before the comment line stating:
# ok, we're good to login now

In addition, one can uncomment the line:
	# user_increment_login_count( $t_user_id );
It should look like:
	user_increment_login_count( $t_user_id );
In that case still all logins are counted.	

The change mentioned above can bring additional security risks in case you Mantis is on the WWW opposite an intranet.
********************************************************************************************
Configuration options                                                                      *
********************************************************************************************
None

********************************************************************************************
License                                                                                    *
********************************************************************************************
This plugin is distributed under the same conditions as Mantis itself.

********************************************************************************************
Mantis Issue                                                                               *
********************************************************************************************
http://www.mantisbt.org/bugs/view.php?id=????

********************************************************************************************
Greetings                                                                                  *
********************************************************************************************
Cas Nuy 
cas@nuy.info
http://www.nuy.info