michaelholzheimer / single_auth Goto Github PK

Plugin implements HTTP authentication method in Redmine.

Plugin allows transparent authentication of the User using his domain account throuht Web-server module (for ex. "Mod_NTLM" in Apache).

User authorizes in Web-form on Web-server (for ex. Apache). Web-server connects to LDAP-server (for ex. Active Directory) through module (for ex. "Mod_NTLM") and checks User`s credentials. If authorization is complete, module transfers User credentials to Redmine through Environment Variable (for ex. "REMOTE_USER"). Redmine checks User credentials from Variable in it's own Users DB. If User is inside DB, Redmine will login User with it's account, otherwise Redmine will add User into DB, and login User with it's account.

In Plugin Settings you can set Server environment variable if it differs from "REMOTE_USER".

Attention! Web-server should be cofigured for plugin with neccessary module and LDAP server.

To install plugin, go to the folder "plugins" in root directory of Redmine. Clone plugin in that folder.

	git clone https://github.com/tdvsdv/single_auth.git

Restart your web-server.

Plugin aims to support and is tested under the following Redmine implementations:

• Redmine 2.3.1
• Redmine 2.3.2
• Redmine 2.3.3

Plugin aims to support and is tested under the following Ruby implementations:

• Ruby 1.9.2
• Ruby 1.9.3
• Ruby 2.0.0

Plugin aims to support and is tested under the following Rails implementations:

• Rails 3.2.13

Copyright (c) 2011-2013 Vladimir Pitin, Danil Kukhlevskiy. [skin]: https://github.com/tdvsdv/redmine_alex_skin For better appearance we recommend to use this plugin with Redmine skin of our team - [Redmine Alex Skin][skin].

Another plugins of our team you can see on site http://rmplus.pro