authenticationoauth-2.0access-tokenrefresh-token

Should access tokens be refreshed automatically or manually?


In the last few days I've been reading on Authentication with refresh and access tokens, but this is one thing I can't find the answer to. Let's say an expired access token is sent. Should the backend automatically refresh it (if a refresh token was provided), or the refreshing should only be done at a refresh endpoint?

As an example, consider the two following auth flows:

Automatically Refreshing

  1. User authenticates with username and password. The API sends back a short lived access token containing his data, and a long lived refresh token.
  2. For every request that requires authentication/authorization, the user will send both tokens on the request headers.
  3. If the access token is expired, the API will check if a valid refresh token was sent, if it is active and if it belongs to the same user as the access token. If everything looks good then it will sign a new access token and update the response headers with it.

Front-end doesn't have to worry about refreshing the token, but it still has to look up response headers after each request to check if a new token was sent.

Manually Refreshing

  1. User authenticates with username and password. The API sends back a short lived access token containing his data, and a long lived refresh token.
  2. For every request that requires authentication/authorization, the user will send his access token.
  3. When the access token expires, the user will send his refresh token to the refresh/ route. The API checks if the token is valid. If everything looks good, it returns a new access token.

After every request, the client has to check if the token expired, and if it did it will have to perform a new request to refresh the token. More requests are being made to the server, but on the other hand responsibilities are better separated, since auth route is only responsible for handling access tokens, while the refresh token handling lives in another route.

I've had some hard time finding resources on the subject, so I'm not quite about sure which solution is better, or even if the solutions I described are correct at all. If I had to pick one, I would go with Automatically Refreshing, since less requests are made, and the client side usability looks better, but as I said, I'm not 100% on this, and thus I'm making that thread.

How should access tokens be refreshed?


Solution

  • It feels to me that you are missing a role here, which is that of the Authorization Server (AS):

    It is always the client's responsibility to refresh tokens and only the access token should be sent to the API. The API's only OAuth job is verify the access token and authorize based on its contents.

    It is possible that you have an API that is doing the job of the Authorization Server. I would aim to separate these roles.