Rails API and Facebook login (featuring Doorkeeper and OAuth 2 authorization).

When it comes to add Facebook login to Rails application there’re tons of guides and examples how to do it using Devise and Omniauth gems. That works well when you need to make it work with “classic” Rails application. But if you have Rails API application that powers your iOS/Android application it’s a bit different story.

Note: This post is only about backend part and it assumes that you know how to obtain Facebook access token (it’s described in this doc).

So that’s what we have:

  • Rails API application with protected endpoints that are accessible only by authenticated users (authenticated through Facebook).
  • iOS/Android client that does Facebook authentication and provides us users’s Facebook access token.

We gonna use Doorkeeper gem to add OAuth 2 authorization support for our Rails API. By default Doorkeeper supports all common grants like Authorization code, Client credentials, Implicit grant, etc. But it doesn't work for us. All that we’re going to get from mobile clients is users's access token from Facebook. Here comes the Assertion grant. Since it's not supported by Doorkeeper by default we need to use this doorkeeper-grants_assertion extension. That's how the flow works:

where Relying Party is our Rails API, Client is iOS/Android app, Token Service is Facebook.

Let’s configure Doorkeeper to support that flow. That’s how your config/initializers/doorkeeper.rb might look:

Yeah, that simple. Authentication::Facebook class is just a simple service that fetches the user information using Facebook's access token and tries to create a new user or return existing one based on user's Facebook id. It might look like this:

That’s basically it. Finally, you can test that everything works by making a request to our Rails API:

where OAUTH_CLIENT_ID is your id of Doorkeeper's OAuth Application (you can read more about it here), YOUR_FACEBOOK_ACCESS_TOKEN is your Facebook access token (just to test, you can generate it in Facebook's Graph API Explorer). After running that request you'll get something like:

That’s all! Here’s the access_token you can use to do authorized requests to your endpoints!