Sunday, May 20, 2012

Design for Facebook authentication in an iOS app that also accesses a secured web service


Goal: Allow a user to authentication with Facebook into an iOS application which requires access to a protected web service that I'm running.



Assumptions: There is a native authentication (and registration) system in place for those users that opt not to use Facebook for sign in.



Details:



  • Assume we want to offer the option for a user to sign in with Facebook without creating a separate account/credential for our system.

  • Because we support our own native auth mechanism (username and password) we have our own user IDs and issue an authentication token that is used for subsequent interactions after the initial credential validation.



I'm surprised that Facebook doesn't have best practices for this in their developer documentation. All the existing documentation is either assuming you are building FB auth into a website, or a standalone mobile app with no service that requires authentication.



Here's my initial thoughts on how this would be designed but want validation on whether it's correct.



  1. Client pops the Facebook iOS Login

  2. UI User signs in with Facebook credentials and gets access token

  3. iOS App passes access token to our server



  4. Our server talks to FB graph API using access token to (a) validate the token and (b) get the FB user ID for that access token.



    e.g. Our server would call https://graph.facebook.com/me/?access_token=XYZ which would return profile info in a JSON object





  5. Assuming it's valid, our server extracts the User ID from the JSON object and checks whether the user already has an account. If so, we issue our own auth ticket to client to use for that session. If user doesn't have an account, we create a new one with the Facebook User ID, assign our own unique UserID and issue our auth ticket.



  6. Client then passes auth ticket back on subsequent interactions that need authentication.



This seems like the right approach to me but not sure if I'm missing something insanely basic and going down the wrong (complicated) path.


Source: Tips4all

2 comments:

  1. I just dealt with this myself, and here's the part that bit me:

    In your step 5... It's possible for a user to register for an account with you entirely separate from their Facebook ID, right? Then some other time they log in with Facebook.... And you just created them a second account and lost their first one.

    There needs to be a way to be logged in to your web service, then log in to facebook, and capture the association between the facebook ID and the local account.

    Apart from that, your plan sounds solid.

    ReplyDelete
  2. I am trying to figure out how to deal with the same situation.
    The central missing piece to me is in Step 3:


    3) iOS App passes access token to our server


    Please correct me if I'm wrong - but the transmission of the access token is not encrypted - thus anyone listening on the network can replay the token for the length of the session and impersonate the user.

    The solution here would be to transmit over https. Thoughts?

    Either way fantastic post - you provided some valuable insight.

    ReplyDelete