https://github.com/atomaka/devise-kerberos-authenticatable

Devise extension to authenticate against MIT Kerberos
https://github.com/atomaka/devise-kerberos-authenticatable

Last synced: 15 days ago
JSON representation

Devise extension to authenticate against MIT Kerberos

• Host: GitHub
• URL: https://github.com/atomaka/devise-kerberos-authenticatable
• Owner: atomaka
• License: mit
• Created: 2013-04-21T04:27:12.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2015-06-23T09:12:35.000Z (over 9 years ago)
• Last Synced: 2023-03-12T07:24:52.312Z (over 1 year ago)
• Language: Ruby
• Size: 200 KB
• Stars: 10
• Watchers: 3
• Forks: 4
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
#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](https://github.com/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

* Update your gemfile

```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 ]```

* Update your Devise model app/models/user.rb

```

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](https://github.com/jwilson511/devise_pam_authenticatable)