This plugins adds SAML authentication support for Redmine thanks to the OmniAuth authentication framework and specially thanks to Redmine Omniauth CAS Plugin.
It merged! This fork will be used for personal development. Please refer original repository: https://github.com/chrodriguez/redmine_omniauth_saml
This fork is temporary to fix for Redmine 4.0. When original support Redmine 4.0, this repository will be deleted.
You can first take a look at general instructions for plugins here.
Note that the plugin is now only compatible with Redmine 3.0 or higher. For Redmine 2.0 see 2.0 branch
Then :
- clone this repository in your plugins/ directory ; if you have a doubt you put it at the good level, you can go to your redmine root directoryand check you have a
plugins/redmine_omniauth_saml/init.rb
file - install the dependencies with bundler :
bundle install
- copy assets by running this command from your redmine root directory (note: the plugin has no migration for now) :
RAILS_ENV=production bundle exec rake redmine:plugins
- restart your Redmine instance (depends on how you host it)
Finally you must configure your SAML settings adding a file in <redmine_folder>/config/initializers
for example named saml.rb
(the name is not important, but it must be a ruby file). A sample file is given in the plugin root folder named sample-saml-initializers.rb
Finaly you need to configure some minor options for the plugin to work, in “Administration” > “Plugins” > “Configure” on the OmniAuth SAML plugin line.