Skip to content

OAuth Design

Jump to bottom
Rohan Nagar edited this page Sep 1, 2017 · 4 revisions

When a user is adding a service to their account for the first time, this is the flow that needs to happen.

Steps

  1. The user taps on the service they want to add.
  2. Pilot sees which service the user wants to add, and makes a network request to Lightning at the URL path /{service}/oauthUrl.
  3. Pilot gets the OAuth URL from Lightning's response, and opens the URL for the user to see in a browser (either in-app or in Safari).
  4. The user authenticates Pilot on the service's website.
  5. The service makes a network call to the provided callback URL (this is set up either on the service's app page or in the OAuth URL from Lightning). This callback URL should be the Pilot app.
  6. With the user's auth tokens that Pilot gets from the callback, Pilot updates the user account in Thunder with the new OAuth keys.
  7. Pilot waits for a success from Thunder - on success, the user is taken back to the home screen with the new service enabled.

Flowchart

OAuth Flowchart

Clone this wiki locally