omniauth_dailycred 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 !binary "U0hBMQ==":
-  metadata.gz: feab5e8cbd41a360a390fdc4517f53307189f5cd
-  data.tar.gz: 6e2bb63dc502082e8334e4e3b3d8bcfa039269a8
+  metadata.gz: 0b47a27e0054f179b403fbee7447c982b704a06e
+  data.tar.gz: 05caa3c58caf5d76037e89808d48ec0da36b45ac
 !binary "U0hBNTEy":
-  metadata.gz: 75ae7e38a66b470a76d355b986f202c8f1c7cb71560beee843f790f9cde0c34e6ac1ec0a838017d4cb797bd25c71bafa1c760428d4a5da0d226bbf7f3f069851
-  data.tar.gz: db71d0719ba32ababc9dbc4d4afbca88a3faf9a34f9c2987548f11d05d7415f6047578f77dbb6ee3a974d2a902f3afd0e700ef51c0d7887ae703365e9b983a9b
+  metadata.gz: fca6b792956cf751f530a2bcb8ae097e21adf56078d0d4f7114bb667166b94153d2d7f9c9d58d849feb5647144db5a0cc5e919527223f5a7544a41088eb850f4
+  data.tar.gz: 1d168af544c63db3a784d251a49f64868b57d4dbe71a7709805a64e149f2d04d79fea1a83c2ec582833c585c1b2f2841f60f830808209a147aeac2935caa3207

data/README.md

@@ -1,29 +1,100 @@
-# OmniauthDailycred
+# Omniauth_Dailycred
 
-TODO: Write a gem description
+This gem is intended for users who solely want to interact with [dailycred](https://www.dailycred.com) through omniauth. If you are looking into a more comprehensive authentication solution with dailycred, you should see our [rails engine](https://github.com/dailycred/dailycred).
 
-## Installation
+Because we've extracted OAuth login from the [Rails engine](https://github.com/dailycred/dailycred) into its own [omniauth gem](https://github.com/dailycred/omniauth_dailycred), it's now extremely easy to implement dailycred in an existing project.
 
-Add this line to your application's Gemfile:
+## Why?
 
-    gem 'omniauth_dailycred'
+Even if you've already set up authentication, Dailycred can be extremely helpful as a proxy for other authentication providers. For example:
 
-And then execute:
+* Not all OAuth providers allow you to pass state, and none of them allow you to pass additional parameters like ['referrer'](https://www.dailycred.com/api/server-side).
+* You get instant access to a [comprehensive dashboard](https://www.dailycred.com/demo) to view your users and get a deeper insight into their behavior.
+* Only implement one omniauth provider, and then send your user to any [identity provider](https://www.dailycred.com/api/providers) by sending them to the following route:
 
-    $ bundle
+	/auth/dailycred?identity_provider=[provider]
+	
 
-Or install it yourself as:
 
-    $ gem install omniauth_dailycred
+##Installation
 
-## Usage
+In your gemfile
 
-TODO: Write usage instructions here
+~~~
+gem 'omniauth_dailycred'
+~~~
 
-## Contributing
+Then run `bundle`.
+
+##Usage
+
+Create an initializer at `config/initializers/omniauth.rb` with the following:
+
+~~~
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :dailycred, ENV['DAILYCRED_CLIENT_ID'], ENV['DAILYCRED_SECRET']
+end
+~~~
+
+Then simply send your users to `auth/dailycred` and they will be forwarded through the OAuth flow. The following parameters can be passed along to dailycred:
+
+1. action
+1. identity_provider
+1. referrer
+1. access_token
+
+If you run into an SSL Error, it's because omniauth can't find your ssl certicate. Try modifying `config/initializers/omniauth.rb` to look like the following:
+
+~~~
+opts = {:client_options => {:ssl => {}}}
+
+if File.exists?('/etc/ssl/certs')
+  opts[:client_options][:ssl][:ca_path] = '/etc/ssl/certs'
+end
+if File.exists?('/opt/local/share/curl/curl-ca-bundle.crt')
+  opts[:client_options][:ssl][:ca_file] = '/opt/local/share/curl/curl-ca-bundle.crt'
+end
+
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :dailycred, ENV['DAILYCRED_CLIENT_ID'], ENV['DAILYCRED_SECRET'], opts
+end
+~~~
+
+Follow the omniauth instructions to [integrate omniauth into your application](https://github.com/intridea/omniauth#integrating-omniauth-into-your-application) for further setup details.
+
+In your *callback*, `request.env['omniauth.auth']` will look something like the following:
+
+~~~
+{
+       "provider" => "dailycred",
+            "uid" => "userid-xx-yy",
+           "info" => {
+                 "token" => "token-xxyy-token",
+              "provider" => "dailycred",
+                   "uid" => "userid-xx-yy",
+                   "ban" => false,
+             "user_type" => "CONVERTED",
+            "identities" => {},
+               "display" => "test@test.com",
+                "emails" => {},
+               "picture" => "https://www.dailycred.com/user/pic?user_id=userid-xx-yy&size=50",
+            "updated_at" => 1366670682849,
+               "created" => Mon, 15 Apr 2013 18:20:28 +0000,
+                 "email" => "test@test.com",
+        "last_logged_in" => 1366670682848,
+              "verified" => false,
+                 "guest" => false,
+            "attributes" => {},
+         "access_tokens" => {
+            "dailycred" => "token-xxyy-token"
+        },
+          "access_token" => "token-xxyy-token"
+    },
+    "credentials" => {
+          "token" => "token-xxyy-token",
+        "expires" => false
+    },
+          "extra" => {}
+}
+~~~
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request

data/lib/omniauth_dailycred.rb

@@ -1,6 +1,3 @@
-require "omniauth_dailycred/version"
+Dir[File.expand_path('../omniauth_dailycred/*', __FILE__)].each { |f| require f }
 require "omniauth/strategies/dailycred"
 
-module OmniauthDailycred
-  # Your code goes here...
-end

data/lib/omniauth_dailycred/version.rb

@@ -1,3 +1,3 @@
 module OmniauthDailycred
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: omniauth_dailycred
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Hank Stoever
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-17 00:00:00.000000000 Z
+date: 2013-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: omniauth
@@ -102,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.0
+rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
 summary: Use if you only want to communicate with Dailycred through omniauth.