1
0
Fork 0
devise-kerberos-authenticat.../README.md

36 lines
1.1 KiB
Markdown
Raw Normal View History

2013-04-21 00:26:36 -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](https://github.com/timfel/krb5-auth) depends on the headers and development libraries for MIT Kerberos.
2013-04-21 00:29:57 -04:00
2013-04-21 00:26:36 -04:00
```sudo apt-get install libkrb5-dev```
###Server Setup
Modify your /etc/krb5.conf file as necessary to authenticate against your Kerberos server.
###Rails Setup
* Edit config/initializers/devise.rb to use a username instead of email for login.
2013-04-21 00:29:57 -04:00
2013-04-21 00:26:36 -04:00
```config.authentication_keys = [ :username ]```
* Update your Devise model app/models/user.rb
2013-04-21 00:29:57 -04:00
2013-04-21 00:26:36 -04:00
```
devise :kerberos_authenticatable
attr_accessible :username
```
2013-04-21 00:29:57 -04:00
2013-04-21 00:26:36 -04:00
* Rebuild your Devise views automatically or by hand.
2013-04-21 00:29:57 -04:00
2013-04-21 00:26:36 -04:00
```
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)