https://github.com/jgraichen/omniauth-kerberos

OmniAuth strategy for kerberos authentication.
https://github.com/jgraichen/omniauth-kerberos

authentication kerberos omniauth omniauth-strategy password ruby

Last synced: 25 days ago
JSON representation

OmniAuth strategy for kerberos authentication.

• Host: GitHub
• URL: https://github.com/jgraichen/omniauth-kerberos
• Owner: jgraichen
• License: mit
• Created: 2012-04-21T11:07:19.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2024-07-22T10:57:15.000Z (7 months ago)
• Last Synced: 2025-01-13T18:15:15.462Z (about 1 month ago)
• Topics: authentication, kerberos, omniauth, omniauth-strategy, password, ruby
• Language: Ruby
• Size: 12.7 KB
• Stars: 15
• Watchers: 5
• Forks: 6
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Omniauth::Strategies::Kerberos

[![Build Status](https://travis-ci.org/jgraichen/omniauth-kerberos.svg)](https://travis-ci.org/jgraichen/omniauth-kerberos)

[![Code Climate](https://codeclimate.com/github/jgraichen/omniauth-kerberos/badges/gpa.svg)](https://codeclimate.com/github/jgraichen/omniauth-kerberos)

[![Test Coverage](https://codeclimate.com/github/jgraichen/omniauth-kerberos/badges/coverage.svg)](https://codeclimate.com/github/jgraichen/omniauth-kerberos/coverage)

**omniauth-kerberos** is a simple [OmniAuth](https://github.com/intridea/omniauth) strategy to authenticate using a Kerberos server. **omniauth-kerberos** can be used as an authenticator for [OmniAuth MultiPassword](https://github.com/jgraichen/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:

```ruby

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:

```ruby

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](http://www.opensource.org/licenses/mit-license.php)

Copyright (c) 2012, Jan Graichen