Omniauth::Kerberos

omniauth-kerberos is a simple OmniAuth strategy to authenticate using a Kerberos server. omniauth-kerberos can be used as an authenticator for OmniAuth MultiPassword.

Installation

Add this line to your application’s Gemfile:

gem 'omniauth-kerberos'

And then execute:

$ bundle

Or install it yourself as:

$ gem install omniauth-kerberos

Kerberos development headers are required to build dependencies.

On Debian try:

$ sudo apt-get install libkrb5-dev

Usage

Use omniauth-kerberos like any other OmniAuth strategy:

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :kerberos
end

You still need to configure your system for Kerberos usage like specifying realms. If you has your own login form you can specify the fields to use:

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :kerberos, :fields => [ :login, :pwd ]
end

Options

title
The title text shown on default login form.
(default: "Restricted Access")

fields
The request parameter names to fetch username and password.
(default: [ "username", "password" ])

License

MIT License