DEV Community

Cover image for Explaining how OAuth works with Spotify as an example

Explaining how OAuth works with Spotify as an example

Nikita Kholin on January 24, 2019

Have you ever wondered what is OAuth, how it works, and why any more or less popular website implements it? In this article, we'll explore those qu...
Collapse
 
lepture profile image
Hsiaoming Yang

Hi Nikita, thanks for your post.

Since you are using Flask as an example and the library you mentioned in "Don't invent a bicycle" is a Django app library, I would like to add a Flask wheel here.

github.com/lepture/authlib

The documentation for the Flask integration is docs.authlib.org/en/latest/client/...

Collapse
 
hmlon profile image
Nikita Kholin

Awesome!
Thanks for the library, I didn't know about it. I'll be sure to check it out.

Collapse
 
lepture profile image
Hsiaoming Yang

Actually, before Authlib. There were Flask-OAuth and Flask-OAuthlib. But both of them are deprecated now.

Collapse
 
temmyraharjo profile image
temmyraharjo

Great article. But I curious asking is the Scope is same with Security role? If same which one you prefer put all the sec-role in the OAuth or built in by yourself in the application?

Collapse
 
phlash profile image
Phil Ashby

In the access token itself, these are the same thing. How an application understands the token content and uses it is different for each app.

For example - we have an application that handles workflow profiles (think Jira ticket lifecycle) on a per-user basis. Some people can edit profiles, others can execute. The app needs to know who you are, so you get the right profile, and we use the scope to determine if you can edit or execute. What we don't do is try and put the whole profile into OAuth properties. Note that OAuth and the authentication system does not understand profiles at all, it simple associates the words 'edit' and 'execute' with user identities, the application applies meaning to those terms locally.

Collapse
 
temmyraharjo profile image
temmyraharjo

Because what I think when we put scope in OAuth. It means that everytime we define scope: create_user, read_user, update_user, delete_user (let's say we have big module). We need to retrieve from OAuth to process all that information which is not efficient.

I always thinking that OAuth only need to be use for getting the token and refresh token. While security role is defined in the application it self to process the business logi..

Thread Thread
 
phlash profile image
Phil Ashby

As usual - it depends :)

In our case, we have a need to share roles across a number of endpoints / APIs / applications in a single-sign-on environment. These roles are managed centrally through OAuth tokens. What the roles /mean/ when a specific application or endpoint receives them is defined locally (as I described in the example above).

If you have a single application, and it already has local permissions / role management capability, then you have little need to move that elsewhere. Indeed your driver for using OAuth is likely different too, typically such applications need to accept identity assertions from other environments such as Google or Facebook, whereas we are building an SSO platform for ourselves... YMMV!