1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
OmniAuth Tumblr
================
This gem is an OmniAuth 1.0 Strategy for authenticating with the [Tumblr API](http://developers.tumblr.com)
An example Rails application is available:
<https://github.com/jamiew/omniauth-rails-app>
Setup
-----
Register your application with [Tumblr](http://www.tumblr.com/oauth/apps).
*Important*: your callback URL needs to be specified as `http://[hostname]/auth/tumblr/callback`.
The Tumblr API does not respect the dynamic ?oauth_callback URL passed by Omniauth. ([related thread](https://groups.google.com/forum/?fromgroups#!searchin/tumblr-api/callback$20url/tumblr-api/5k_afNDUB5s/gfaNMnRtINoJ))
In order to authenticate with Tumblr in both development and production we recommend
registering a "-dev" app with Tumblr which points at localhost:3000 or yourapp.dev (not ideal)
Using services like https://ngrok.com works like a charm.
Usage
-----
Get started by adding the Tumblr strategy to your `Gemfile`:
```ruby
gem 'omniauth-tumblr'
```
In a Rails app, add the Tumblr provider to your Omniauth middleware, e.g.
in a file like @config/initializers/omniauth.rb@:
```ruby
Rails.application.config.middleware.use OmniAuth::Builder do
provider :tumblr, ENV['TUMBLR_KEY'], ENV['TUMBLR_SECRET']
end
```
In any Rack app you can add the Tumblr strategy like so:
```ruby
use OmniAuth::Builder do
provider :tumblr, ENV['TUMBLR_KEY'], ENV['TUMBLR_SECRET']
end
```
License
-------
Copyright (c) 2011-2012 [Jamie Wilkinson](http://jamiedubs.com)
This source code released under an MIT license.
|
