Download zip Select Archive Format
Name Last Update history
File dir app Loading commit data... Ajax loader tree
File dir config Loading commit data... Ajax loader tree
File dir test Loading commit data... Ajax loader tree
File txt README.rdoc Loading commit data... Ajax loader tree
File txt init.rb Loading commit data... Ajax loader tree

README.rdoc

Redmine SAML authentication plugin

This redmine plugin enables SAML authentication using the Onelogin toolkit.

The plugin adds two new routes, for the SAML discovery and consumer actions. The discovery (/auth/saml) initiates the SAML exchange and the consumer (/auth/saml/consumer) recieves the SAML assertion and logs the user in.

NB: Work in progress, but functional, see TODO for where this is heading.

Installation

  1. Install required gems

gem install XMLCanonicalizer
gem install ruby-saml
  1. Copy plugin to vendor/plugins

  2. Copy saml_auth.yml.example to config/saml_auth.yml

  3. Configure saml_auth.yml (see below)

  4. Restart webserver/passenger/mongrel_rails

Configuration

Open saml_auth.yml and set up the plugin, a sample configuration is provided. Restart passenger/mongrel after changes to configuration.

Use the following routes to configure your IdP

  • Login: redmine.example.com:3000/auth/saml

  • Consumer: redmine.example.com:3000/auth/saml/consume

Notes

Patches, fixes or complete rewrites are welcome ;)

Todo

  • Enable/disable plugin from config

  • Disable and redirect /login to identity provider

  • Administration screen in Redmine interface

License and copyright

Copyright © 2011 Casper Valdemar Poulsen. License follows Redmine - GNU General Public License v2 (GPL).