omniauth-rightsignature 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3e34cb3f33934745d47708a01a192e1dcb7a40f2
-  data.tar.gz: e2e61a5243809859410d56802da5133e6d80368a
+  metadata.gz: 7d0764759e69b1e48d8cff0de91950b0813190e7
+  data.tar.gz: 4502540d79db1e0ea6d559d6875d18eab2b61ac0
 SHA512:
-  metadata.gz: e32f52f5276a80e7d6ba782591d069c079891eb49811827514cb5ee963a225b3317bb2877bf46ad4a592273fef4687dad173320be11dbc409e6107dd6321bd67
-  data.tar.gz: 86c9054d6f95f6a062a5320d0aa4f15a56122723bea2928498d9fce6535921ded39f148d1d70e48b832452d014a82345a9942af7f4ec50ae1df963d83dd24123
+  metadata.gz: 5742475fddf7e7c2a75d878269ad88a54bb89e09d81bd6ed0570d271fde3b9b8bd8b10b686bfddabf83d8e09b560d0941f85f57019f03525c70d65511e6b946e
+  data.tar.gz: 4838481ebe2ca631853c665949706ae199e982cea65397a5abd1aae22409547ce01e1e5308e6f2393b7db5071fb80d15772ab8192ac9f6ce644d10338ccecf42

data/.gitignore

@@ -0,0 +1,11 @@
+*.gem
+*~
+.bundle
+.rvmrc
+.yardoc
+Gemfile.lock
+coverage/*
+doc/*
+log/*
+measurement/*
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--order random

data/.rubocop.yml

@@ -0,0 +1,60 @@
+Lint/HandleExceptions:
+  Enabled: false
+
+Metrics/BlockNesting:
+  Max: 2
+
+Metrics/LineLength:
+  AllowURI: true
+  Enabled: false
+
+Metrics/MethodLength:
+  CountComments: false
+  Max: 15
+
+Metrics/ParameterLists:
+  Max: 4
+  CountKeywordArgs: true
+
+Metrics/AbcSize:
+  Enabled: false
+
+Style/AccessModifierIndentation:
+  EnforcedStyle: outdent
+
+Style/CollectionMethods:
+  PreferredMethods:
+    map:      'collect'
+    reduce:   'inject'
+    find:     'detect'
+    find_all: 'select'
+
+Style/Documentation:
+  Enabled: false
+
+Style/DotPosition:
+  EnforcedStyle: trailing
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/EachWithObject:
+  Enabled: false
+
+Style/Encoding:
+  Enabled: false
+
+Style/HashSyntax:
+  EnforcedStyle: hash_rockets
+
+Style/Lambda:
+  Enabled: false
+
+Style/RaiseArgs:
+  EnforcedStyle: compact
+
+Style/SpaceInsideHashLiteralBraces:
+  EnforcedStyle: no_space
+
+Style/TrailingComma:
+  EnforcedStyleForMultiline: 'comma'

data/.travis.yml

@@ -0,0 +1,26 @@
+bundler_args: --without development
+env:
+  global:
+    - JRUBY_OPTS="$JRUBY_OPTS --debug"
+gemfile:
+  - Gemfile
+  - Gemfile.rack-1.3.x
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.3
+  - 2.0.0
+  - 2.1
+  - 2.2
+  - jruby-18mode
+  - jruby-19mode
+  - jruby-head
+  - rbx-2
+  - ruby-head
+matrix:
+  allow_failures:
+    - rvm: jruby-head
+    - rvm: rbx-2
+    - rvm: ruby-head
+  fast_finish: true
+sudo: false

data/.yardopts

@@ -0,0 +1,4 @@
+--markup markdown
+--markup-provider maruku
+-
+LICENSE.md

data/Gemfile

@@ -0,0 +1,33 @@
+source 'https://rubygems.org'
+
+gem 'jruby-openssl', :platforms => :jruby
+gem 'rake'
+gem 'yard'
+
+group :development do
+  gem 'growl'
+  platforms :ruby_19, :ruby_20 do
+    gem 'guard'
+    gem 'guard-bundler'
+    gem 'guard-rspec'
+  end
+  gem 'kramdown'
+  gem 'plymouth', :platforms => [:ruby_19, :ruby_20, :ruby_21]
+  gem 'pry'
+  gem 'pry-debugger', :platforms => [:mri_19, :mri_20]
+  gem 'pry-byebug', :platforms => [:mri_21]
+  gem 'rb-fsevent'
+end
+
+group :test do
+  gem 'coveralls'
+  gem 'json', '>= 1.8.1', :platforms => [:jruby, :ruby_18, :ruby_19]
+  gem 'mime-types', '~> 1.25', :platforms => [:jruby, :ruby_18]
+  gem 'rack-test'
+  gem 'rest-client', '~> 1.6.0', :platforms => [:jruby, :ruby_18]
+  gem 'rspec', '~> 3.0'
+  gem 'rubocop', '>= 0.25', :platforms => [:ruby_19, :ruby_20, :ruby_21]
+  gem 'simplecov', '>= 0.9'
+end
+
+gemspec

data/Gemfile.rack-1.3.x

@@ -0,0 +1,25 @@
+source 'https://rubygems.org'
+
+gem 'jruby-openssl', :platforms => :jruby
+gem 'rack', '~> 1.3.0'
+gem 'rake'
+gem 'yard'
+
+group :test do
+  gem 'coveralls', :require => false
+  gem 'json', '>= 1.8.1', :platforms => [:jruby, :rbx, :ruby_18, :ruby_19]
+  gem 'mime-types', '~> 1.25', :platforms => [:jruby, :ruby_18]
+  gem 'rack-test'
+  gem 'rest-client', '~> 1.6.0', :platforms => [:jruby, :ruby_18]
+  gem 'rspec', '>= 2.14'
+  gem 'rubocop', '>= 0.23', :platforms => [:ruby_19, :ruby_20, :ruby_21]
+  gem 'simplecov', :require => false
+end
+
+platforms :rbx do
+  gem 'racc'
+  gem 'rubinius-coverage', '~> 2.0'
+  gem 'rubysl', '~> 2.0'
+end
+
+gemspec

data/Guardfile

@@ -0,0 +1,10 @@
+guard 'rspec', :version => 2 do
+  watch(/^spec\/.+_spec\.rb$/)
+  watch(/^lib\/(.+)\.rb$/)     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb') { 'spec/' }
+end
+
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end

data/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2010-2013 Michael Bleigh and Intridea, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,167 @@
+# OmniAuth-RightSignature: Standardized Multi-Provider Authentication
+
+[![Gem Version](http://img.shields.io/gem/v/omniauth.svg)][gem]
+[![Build Status](http://img.shields.io/travis/intridea/omniauth.svg)][travis]
+[![Dependency Status](http://img.shields.io/gemnasium/intridea/omniauth.svg)][gemnasium]
+[![Code Climate](http://img.shields.io/codeclimate/github/intridea/omniauth.svg)][codeclimate]
+[![Coverage Status](http://img.shields.io/coveralls/intridea/omniauth.svg)][coveralls]
+[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/intridea/omniauth/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
+
+[gem]: https://rubygems.org/gems/omniauth
+[travis]: http://travis-ci.org/intridea/omniauth
+[gemnasium]: https://gemnasium.com/intridea/omniauth
+[codeclimate]: https://codeclimate.com/github/intridea/omniauth
+[coveralls]: https://coveralls.io/r/intridea/omniauth
+
+**OmniAuth 1.0 has several breaking changes from version 0.x. You can set
+the dependency to `~> 0.3.2` if you do not wish to make the more difficult
+upgrade. See [the wiki](https://github.com/intridea/omniauth/wiki/Upgrading-to-1.0)
+for more information.**
+
+## An Introduction
+OmniAuth is a library that standardizes multi-provider authentication for
+web applications. It was created to be powerful, flexible, and do as
+little as possible. Any developer can create **strategies** for OmniAuth
+that can authenticate users via disparate systems. OmniAuth strategies
+have been created for everything from Facebook to LDAP.
+
+In order to use OmniAuth in your applications, you will need to leverage
+one or more strategies. These strategies are generally released
+individually as RubyGems, and you can see a [community maintained list](https://github.com/intridea/omniauth/wiki/List-of-Strategies)
+on the wiki for this project.
+
+One strategy, called `Developer`, is included with OmniAuth and provides
+a completely insecure, non-production-usable strategy that directly
+prompts a user for authentication information and then passes it
+straight through. You can use it as a placeholder when you start
+development and easily swap in other strategies later.
+
+## Getting Started
+Each OmniAuth strategy is a Rack Middleware. That means that you can use
+it the same way that you use any other Rack middleware. For example, to
+use the built-in Developer strategy in a Sinatra application I might do
+this:
+
+```ruby
+require 'sinatra'
+require 'omniauth'
+
+class MyApplication < Sinatra::Base
+  use Rack::Session::Cookie
+  use OmniAuth::Strategies::Developer
+end
+```
+
+Because OmniAuth is built for *multi-provider* authentication, I may
+want to leave room to run multiple strategies. For this, the built-in
+`OmniAuth::Builder` class gives you an easy way to specify multiple
+strategies. Note that there is **no difference** between the following
+code and using each strategy individually as middleware. This is an
+example that you might put into a Rails initializer at
+`config/initializers/omniauth.rb`:
+
+```ruby
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :developer unless Rails.env.production?
+  provider :twitter, ENV['TWITTER_KEY'], ENV['TWITTER_SECRET']
+end
+```
+
+You should look to the documentation for each provider you use for
+specific initialization requirements.
+
+## Integrating OmniAuth Into Your Application
+OmniAuth is an extremely low-touch library. It is designed to be a
+black box that you can send your application's users into when you need
+authentication and then get information back. OmniAuth was intentionally
+built not to automatically associate with a User model or make
+assumptions about how many authentication methods you might want to use
+or what you might want to do with the data once a user has
+authenticated. This makes OmniAuth incredibly flexible. To use OmniAuth,
+you need only to redirect users to `/auth/:provider`, where `:provider`
+is the name of the strategy (for example, `developer` or `twitter`).
+From there, OmniAuth will take over and take the user through the
+necessary steps to authenticate them with the chosen strategy.
+
+Once the user has authenticated, what do you do next? OmniAuth simply
+sets a special hash called the Authentication Hash on the Rack
+environment of a request to `/auth/:provider/callback`. This hash
+contains as much information about the user as OmniAuth was able to
+glean from the utilized strategy. You should set up an endpoint in your
+application that matches to the callback URL and then performs whatever
+steps are necessary for your application. For example, in a Rails app I
+would add a line in my `routes.rb` file like this:
+
+```ruby
+get '/auth/:provider/callback', to: 'sessions#create'
+```
+
+And I might then have a `SessionsController` with code that looks
+something like this:
+
+```ruby
+class SessionsController < ApplicationController
+  def create
+    @user = User.find_or_create_from_auth_hash(auth_hash)
+    self.current_user = @user
+    redirect_to '/'
+  end
+
+  protected
+
+  def auth_hash
+    request.env['omniauth.auth']
+  end
+end
+```
+
+The `omniauth.auth` key in the environment hash gives me my
+Authentication Hash which will contain information about the just
+authenticated user including a unique id, the strategy they just used
+for authentication, and personal details such as name and email address
+as available. For an in-depth description of what the authentication
+hash might contain, see the [Auth Hash Schema wiki page](https://github.com/intridea/omniauth/wiki/Auth-Hash-Schema).
+
+Note that OmniAuth does not perform any actions beyond setting some
+environment information on the callback request. It is entirely up to
+you how you want to implement the particulars of your application's
+authentication flow.
+
+## Logging
+OmniAuth supports a configurable logger. By default, OmniAuth will log
+to `STDOUT` but you can configure this using `OmniAuth.config.logger`:
+
+```ruby
+# Rails application example
+OmniAuth.config.logger = Rails.logger
+```
+
+## Resources
+The [OmniAuth Wiki](https://github.com/intridea/omniauth/wiki) has
+actively maintained in-depth documentation for OmniAuth. It should be
+your first stop if you are wondering about a more in-depth look at
+OmniAuth, how it works, and how to use it.
+
+## Supported Ruby Versions
+OmniAuth is tested under 1.8.7, 1.9.3, 2.0.0, 2.1.0, JRuby, and Rubinius.
+
+## Versioning
+This library aims to adhere to [Semantic Versioning 2.0.0][semver]. Violations
+of this scheme should be reported as bugs. Specifically, if a minor or patch
+version is released that breaks backward compatibility, that version should be
+immediately yanked and/or a new version should be immediately released that
+restores compatibility. Breaking changes to the public API will only be
+introduced with new major versions. As a result of this policy, you can (and
+should) specify a dependency on this gem using the [Pessimistic Version
+Constraint][pvc] with two digits of precision. For example:
+
+    spec.add_dependency 'omniauth', '~> 1.0'
+
+[semver]: http://semver.org/
+[pvc]: http://docs.rubygems.org/read/chapter/16#page74
+
+## License
+Copyright (c) 2010-2013 Michael Bleigh and Intridea, Inc. See [LICENSE][] for
+details.
+
+[license]: LICENSE.md

data/Rakefile

@@ -0,0 +1,17 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task :test => :spec
+
+begin
+  require 'rubocop/rake_task'
+  RuboCop::RakeTask.new
+rescue LoadError
+  task :rubocop do
+    $stderr.puts 'RuboCop is disabled'
+  end
+end
+
+task :default => [:spec, :rubocop]

data/lib/omniauth/auth_hash.rb

@@ -0,0 +1,54 @@
+require 'hashie/mash'
+
+module OmniAuth
+  # The AuthHash is a normalized schema returned by all OmniAuth
+  # strategies. It maps as much user information as the provider
+  # is able to provide into the InfoHash (stored as the `'info'`
+  # key).
+  class AuthHash < Hashie::Mash
+    def self.subkey_class
+      Hashie::Mash
+    end
+
+    # Tells you if this is considered to be a valid
+    # OmniAuth AuthHash. The requirements for that
+    # are that it has a provider name, a uid, and a
+    # valid info hash. See InfoHash#valid? for
+    # more details there.
+    def valid?
+      uid? && provider? && info? && info.valid?
+    end
+
+    def regular_writer(key, value)
+      if key.to_s == 'info' && !value.is_a?(InfoHash)
+        value = InfoHash.new(value)
+      end
+      super
+    end
+
+    class InfoHash < Hashie::Mash
+      def self.subkey_class
+        Hashie::Mash
+      end
+
+      def name
+        return self[:name] if self[:name]
+        return "#{first_name} #{last_name}".strip if first_name? || last_name?
+        return nickname if nickname?
+        return email if email?
+        nil
+      end
+
+      def name?
+        !!name # rubocop:disable DoubleNegation
+      end
+      alias_method :valid?, :name?
+
+      def to_hash
+        hash = super
+        hash['name'] ||= name
+        hash
+      end
+    end
+  end
+end