oauth-dropins 1.2

Drop-in App Engine OAuth client handlers for many popular sites.

This is a collection of drop-in Google App Engine request handlers for the initial OAuth client flows for many popular sites, including Blogger, Dropbox, Facebook, Flickr, Google+, Instagram, Twitter, Tumblr, and WordPress.com.

Check out the demo app! https://oauth-dropins.appspot.com/

Quick start

Here’s a full example of using the Facebook drop-in.

1. Install oauth-dropins into your App Engine app.

1. Put your Facebook application’s ID and secret in two plain text files in your app’s root directory, facebook_app_id and facebook_app_secret. (If you use git, you’ll probably also want to add them to your .gitignore.)

1. Create a facebook_oauth.py file with these contents:

from oauth_dropins import facebook
import webapp2

application = webapp2.WSGIApplication([
  ('/facebook/start_oauth', facebook.StartHandler.to('/facebook/oauth_callback')),
  ('/facebook/oauth_callback', facebook.CallbackHandler.to('/next'))]

1. Add these lines to app.yaml:

- url: /facebook/(start_oauth|oauth_callback)
  script: facebook_oauth.application
  secure: always

Voila! Send your users to /facebook/start_oauth when you want them to connect their Facebook account to your app, and when they’re done, they’ll be redirected to /next?access_token=... in your app.

All of the sites provide the same API. To use a different one, just import the site module you want and follow the same steps. The filenames for app keys and secrets also differ by site; appengine_config.py has the full list.