atomaka/devise-kerberos-authenticatable: Devise extension to authenticate against MIT Kerberos

Devise extension to authenticate against MIT Kerberos

Find a file

Andrew Tomaka 31411d22ae Merge pull request #1 from paulrw/master Bumped devise dependency version and fixed kerberos adapter returning true for invalid credentials		2014-01-26 01:41:02 -08:00
lib	Bumped devise dependency version and fixed kerberos adapter return true for invalid credentials	2014-01-25 14:23:11 +00:00
.gitignore	Initial gem code	2013-04-21 00:32:23 -04:00
devise-kerberos-authenticatable.gemspec	Bumped devise dependency version and fixed kerberos adapter return true for invalid credentials	2014-01-25 14:23:11 +00:00
LICENSE	Initial gem code	2013-04-21 00:32:23 -04:00
README.md	Index on a blank field will cause issues	2013-04-26 21:09:16 -04:00

#devise-kerberos-authenticatable

##Description

devise-kerberos-authenticatable is a Devise exenstion that can be used to authenticate against Kerberos as setup in your local krb5.conf file.

##Installation

###Dependencies timfel-krb5-auth depends on the headers and development libraries for MIT Kerberos.

sudo apt-get install libkrb5-dev ###Server Setup Modify your /etc/krb5.conf file as necessary to authenticate against your Kerberos server.

###Rails Setup

gem 'devise-kerberos-authenticatable', :git => 'git://github.com/atomaka/devise-kerberos-authenticatable.git'

Edit config/initializers/devise.rb to use a username instead of email for login.

config.authentication_keys = [ :username ]

devise :kerberos_authenticatable
attr_accessible :username

Update your User table in your database to include the username field and remove the index from the email field.
Rebuild your Devise views automatically or by hand.

rake generate devise:views

##Other

Currently only supports authentication and does not include password modification functionality.
Initial code based largely on devise_pam_authenticatable