Rubius: A simple native Ruby RADIUS authentication gem

Rubius provides a simple interface to RADIUS authentication

Requirements

Rubius works with the following RADIUS servers:

Installation

Include the gem in your Gemfile:

gem "rubius"

And then run bundler:

$ bundle install

Or install using rubygems

$ gem install rubius

You can then use it in your programs:

require 'rubius'

Another way would be to clone the git repository

$ git clone git://github.com/rahvin/rubius.git

And then install the gem

$ cd rubius
$ rake install

Quick Start

$ cd /my/rails/app
$ rails generate rubius:install

This will create an initial ‘config/rubius.yml’ configuration file and a ‘config/radius-dictionary’ RADIUS dictionary file, it will also create an initializer in ‘config/initializers/rubius.rb’ to load Rubius when your application starts up.

Now configure your RADIUS server properties in ‘config/rubius.yml’. When you’re done, you can authenticate with:

if Rubius::Authenticator.authenticate('username', 'password')
        # woohoo
end

Contributing to Rubius

Copyright © 2011 Ralph Rooding. See LICENSE.txt for further details.