Skip to content

Latest commit

 

History

History
65 lines (38 loc) · 1.8 KB

README.md

File metadata and controls

65 lines (38 loc) · 1.8 KB

Omniauth::Strategies::Kerberos

Build Status Code Climate Test Coverage

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

Copyright (c) 2012, Jan Graichen