README.md

Path: README.md
Last Update: Thu May 02 01:13:24 +0000 2013

# Ruby OpenID

A Ruby library for verifying and serving OpenID identities.

[![Build Status](secure.travis-ci.org/openid/ruby-openid.png)](http://travis-ci.org/openid/ruby-openid)

## Features

  * Easy to use API for verifying OpenID identites - OpenID::Consumer
  * Support for serving OpenID identites - OpenID::Server
  * Does not depend on underlying web framework
  * Supports multiple storage mechanisms (Filesystem, ActiveRecord, Memory)
  * Example code to help you get started, including:
    * Ruby on Rails based consumer and server
    * OpenIDLoginGenerator for quickly getting creating a rails app that uses
      OpenID for authentication
    * ActiveRecordOpenIDStore plugin
  * Comprehensive test suite
  * Supports both OpenID 1 and OpenID 2 transparently

## Installing

Before running the examples or writing your own code you‘ll need to install the library. See the INSTALL file or use rubygems:

    gem install ruby-openid

Check the installation:

    $ irb
    irb> require 'rubygems'
    => false
    irb> gem 'ruby-openid'
    => true

The library is known to work with Ruby 1.8.4 on Unix, Max OSX and Win32. Examples have been tested with Rails 1 to 3.

## Getting Started

The best way to start is to look at the rails_openid example. You can run it with:

    cd examples/rails_openid
    script/server

If you are writing an OpenID Relying Party, a good place to start is: `examples/rails_openid/app/controllers/consumer_controller.rb`

And if you are writing an OpenID provider: `examples/rails_openid/app/controllers/server_controller.rb`

The library code is quite well documented, so don‘t be squeamish, and look at the library itself if there‘s anything you don‘t understand in the examples.

## Homepage

  * [GitHub](http://github.com/openid/ruby-openid)
  * [Website](http://openid.net/)

## Community

Discussion regarding the Ruby OpenID library and other JanRain OpenID libraries takes place on the [OpenID mailing list](openid.net/developers/dev-mailing-lists/).

Please join this list to discuss, ask implementation questions, report bugs, etc. Also check out the openid channel on the freenode IRC network.

If you have a bugfix or feature you‘d like to contribute, don‘t hesitate to send it to us: [How to contribute](openidenabled.com/contribute/).

## Author

Copyright 2006-2012, JanRain, Inc.

Contact openid@janrain.com or visit the [OpenID channel on pibb.com](pibb.com/go/openid).

## License

Apache Software License. For more information see the LICENSE file.

[Validate]