Skip to main content

Grants

Client Credentials Grant​

If the access token owner is a machine, such as a server or an application acting on its own behalf, rather than an individual user, the client can use the Client Credentials Grant. This grant is designed for scenarios where the client needs to access resources autonomously without the context of a specific user.

Auth Code Grant with PKCE​

If the access token owner is a user, the recommended grant is the Authorization Code Grant with Proof Key for Code Exchange (PKCE). This grant involves a series of steps where the client redirects the user to the authorization server, the user grants access, and the server provides an authorization code that the client exchanges for an access token. PKCE adds an extra layer of security to protect against authorization code interception attacks.

Refresh Token Grant​

If the client already has a refresh token, it can use the Refresh Token Grant to obtain a new access token without requiring the user's interaction. This grant is useful for long-lived sessions and background processes.

Which Grant?​

Grants are different ways a client can obtain an access_token that will authorize it to use the resource server.

Deciding which grant to use depends on the type of client the end user will be using.

+-------+
| Start |
+-------+
  V
  |
+------------------------+              +-----------------------+
| Have a refresh token?  |>----Yes----->|  Refresh Token Grant  |
+------------------------+              +-----------------------+
  V
  |
  No
  |
+---------------------+
|     Who is the      |                  +--------------------------+
| Access token owner? |>---A Machine---->| Client Credentials Grant |
+---------------------+                  +--------------------------+
  V
  |
  |
 A User
  |
  |
+----------------------+
| What type of client? |
+----------------------+
  |
  |                                 +---------------------------+
  |>-----------Server App---------->| Auth Code Grant with PKCE |
  |                                 +---------------------------+
  |
  |                                 +---------------------------+
  |>-------Browser Based App------->| Auth Code Grant with PKCE |
  |                                 +---------------------------+
  |
  |                                 +---------------------------+
  |>-------Native Mobile App------->| Auth Code Grant with PKCE |
                                    +---------------------------+