Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple Rails engine to authorize users against github oauth
Ruby JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app initial commit
config
lib initial commit
script
test initial commit
.gitignore
Gemfile
Gemfile.lock initial commit
MIT-LICENSE
README.md
Rakefile
rails-auth-github.gemspec

README.md

rails-auth-github

A simple Rails plugin that provides authentication with github oauth.

It's basically a port of sinatra_auth_github to Rails.

Note: this is an initial release, so it may be buggy. Use at your own risk.

Install

Add the gem to your Gemfile:

gem "rails-auth-github", "~> 0.0.1"

Configure

You can configure rails-auth-github using config.github_auth in either config/application.rb or environment-specific config files, with following options:

  • config.github_auth.client_id (required)
  • config.github_auth.client_secret (required)
  • config.github_auth.scopes
  • config.github_auth.oauth_domain
  • config.github_auth.callback_url

Usage

This engine provides following helpers for use in controllers:

authenticate!

authenticated?

logout!

github_user

github_raw_request(path)

github_request(path)

github_public_organization_access?(name)

github_organization_access?(name)

github_team_access?(team_id) (requires 'user' scope)

github_public_organization_authenticate!(name)

github_organization_authenticate!(name)

github_team_authenticate!(team_id) (requires 'user' scope)

Also, github_user, github_public_organization_access?, github_organization_access?, and github_team_access? are available as view helpers.

TODO

  • tests
Something went wrong with that request. Please try again.