From 7391056daf49d055bf3a8c812cbb765fe05e4a28 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 9 Apr 2019 23:29:04 +0400
Subject: [PATCH] :sparkles: Add OAuth2 scopes with SecurityScopes, upgrade
 Security (#141)

* :sparkles: Upgrade OAuth2 Security with scopes handling

* :memo: Update Security tutorial with OAuth2 and JWT

* :sparkles: Add tutorial code for OAuth2 with scopes (and JWT)

* :white_check_mark: Add tests for tutorial/OAuth2 with scopes

* :bug: Fix security_scopes type declaration

* :sparkles: Add docs and tests for SecurityScopes
---
 docs/img/tutorial/security/image11.png        | Bin 0 -> 80863 bytes
 docs/src/security/tutorial004.py              |  29 +-
 docs/src/security/tutorial005.py              | 162 +++++++++
 docs/tutorial/security/oauth2-jwt.md          |  55 ++-
 docs/tutorial/security/oauth2-scopes.md       | 191 +++++++++++
 fastapi/dependencies/models.py                |   4 +
 fastapi/dependencies/utils.py                 |  38 ++-
 fastapi/security/__init__.py                  |   7 +-
 fastapi/security/oauth2.py                    |   7 +-
 mkdocs.yml                                    |   1 +
 .../test_security/test_tutorial005.py         | 313 ++++++++++++++++++
 11 files changed, 773 insertions(+), 34 deletions(-)
 create mode 100644 docs/img/tutorial/security/image11.png
 create mode 100644 docs/src/security/tutorial005.py
 create mode 100644 docs/tutorial/security/oauth2-scopes.md
 create mode 100644 tests/test_tutorial/test_security/test_tutorial005.py

diff --git a/docs/img/tutorial/security/image11.png b/docs/img/tutorial/security/image11.png
new file mode 100644
index 0000000000000000000000000000000000000000..3e1a0ce9195bce6a9471e536dc71d5ce6f2581de
GIT binary patch
literal 80863
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
bx}z&?|1SZHW2_&r%u`WRds6%u{PuqV_55v_

literal 0
Hc-jL100001

diff --git a/docs/src/security/tutorial004.py b/docs/src/security/tutorial004.py
index edbac86f62..bac77a4b11 100644
--- a/docs/src/security/tutorial004.py
+++ b/docs/src/security/tutorial004.py
@@ -1,7 +1,7 @@
 from datetime import datetime, timedelta
 
 import jwt
-from fastapi import Depends, FastAPI, HTTPException, Security
+from fastapi import Depends, FastAPI, HTTPException
 from fastapi.security import OAuth2PasswordBearer, OAuth2PasswordRequestForm
 from jwt import PyJWTError
 from passlib.context import CryptContext
@@ -12,7 +12,6 @@ from starlette.status import HTTP_403_FORBIDDEN
 # openssl rand -hex 32
 SECRET_KEY = "09d25e094faa6ca2556c818166b7a9563b93f7099f6f0f4caa6cf63b88e8d3e7"
 ALGORITHM = "HS256"
-TOKEN_SUBJECT = "access"
 ACCESS_TOKEN_EXPIRE_MINUTES = 30
 
 
@@ -32,7 +31,7 @@ class Token(BaseModel):
     token_type: str
 
 
-class TokenPayload(BaseModel):
+class TokenData(BaseModel):
     username: str = None
 
 
@@ -83,20 +82,26 @@ def create_access_token(*, data: dict, expires_delta: timedelta = None):
         expire = datetime.utcnow() + expires_delta
     else:
         expire = datetime.utcnow() + timedelta(minutes=15)
-    to_encode.update({"exp": expire, "sub": TOKEN_SUBJECT})
+    to_encode.update({"exp": expire})
     encoded_jwt = jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)
     return encoded_jwt
 
 
-async def get_current_user(token: str = Security(oauth2_scheme)):
+async def get_current_user(token: str = Depends(oauth2_scheme)):
+    credentials_exception = HTTPException(
+        status_code=HTTP_403_FORBIDDEN, detail="Could not validate credentials"
+    )
     try:
         payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
-        token_data = TokenPayload(**payload)
+        username: str = payload.get("sub")
+        if username is None:
+            raise credentials_exception
+        token_data = TokenData(username=username)
     except PyJWTError:
-        raise HTTPException(
-            status_code=HTTP_403_FORBIDDEN, detail="Could not validate credentials"
-        )
+        raise credentials_exception
     user = get_user(fake_users_db, username=token_data.username)
+    if user is None:
+        raise credentials_exception
     return user
 
 
@@ -110,15 +115,15 @@ async def get_current_active_user(current_user: User = Depends(get_current_user)
 async def route_login_access_token(form_data: OAuth2PasswordRequestForm = Depends()):
     user = authenticate_user(fake_users_db, form_data.username, form_data.password)
     if not user:
-        raise HTTPException(status_code=400, detail="Incorrect email or password")
+        raise HTTPException(status_code=400, detail="Incorrect username or password")
     access_token_expires = timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)
     access_token = create_access_token(
-        data={"username": form_data.username}, expires_delta=access_token_expires
+        data={"sub": user.username}, expires_delta=access_token_expires
     )
     return {"access_token": access_token, "token_type": "bearer"}
 
 
-@app.get("/users/me", response_model=User)
+@app.get("/users/me/", response_model=User)
 async def read_users_me(current_user: User = Depends(get_current_active_user)):
     return current_user
 
diff --git a/docs/src/security/tutorial005.py b/docs/src/security/tutorial005.py
new file mode 100644
index 0000000000..f13e2310e6
--- /dev/null
+++ b/docs/src/security/tutorial005.py
@@ -0,0 +1,162 @@
+from datetime import datetime, timedelta
+from typing import List
+
+import jwt
+from fastapi import Depends, FastAPI, HTTPException, Security
+from fastapi.security import (
+    OAuth2PasswordBearer,
+    OAuth2PasswordRequestForm,
+    SecurityScopes,
+)
+from jwt import PyJWTError
+from passlib.context import CryptContext
+from pydantic import BaseModel, ValidationError
+from starlette.status import HTTP_403_FORBIDDEN
+
+# to get a string like this run:
+# openssl rand -hex 32
+SECRET_KEY = "09d25e094faa6ca2556c818166b7a9563b93f7099f6f0f4caa6cf63b88e8d3e7"
+ALGORITHM = "HS256"
+ACCESS_TOKEN_EXPIRE_MINUTES = 30
+
+
+fake_users_db = {
+    "johndoe": {
+        "username": "johndoe",
+        "full_name": "John Doe",
+        "email": "johndoe@example.com",
+        "hashed_password": "$2b$12$EixZaYVK1fsbw1ZfbX3OXePaWxn96p36WQoeG6Lruj3vjPGga31lW",
+        "disabled": False,
+    },
+    "alice": {
+        "username": "alice",
+        "full_name": "Alice Chains",
+        "email": "alicechains@example.com",
+        "hashed_password": "$2b$12$gSvqqUPvlXP2tfVFaWK1Be7DlH.PKZbv5H8KnzzVgXXbVxpva.pFm",
+        "disabled": True,
+    },
+}
+
+
+class Token(BaseModel):
+    access_token: str
+    token_type: str
+
+
+class TokenData(BaseModel):
+    username: str = None
+    scopes: List[str] = []
+
+
+class User(BaseModel):
+    username: str
+    email: str = None
+    full_name: str = None
+    disabled: bool = None
+
+
+class UserInDB(User):
+    hashed_password: str
+
+
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+
+oauth2_scheme = OAuth2PasswordBearer(
+    tokenUrl="/token",
+    scopes={"me": "Read information about the current user.", "items": "Read items."},
+)
+
+app = FastAPI()
+
+
+def verify_password(plain_password, hashed_password):
+    return pwd_context.verify(plain_password, hashed_password)
+
+
+def get_password_hash(password):
+    return pwd_context.hash(password)
+
+
+def get_user(db, username: str):
+    if username in db:
+        user_dict = db[username]
+        return UserInDB(**user_dict)
+
+
+def authenticate_user(fake_db, username: str, password: str):
+    user = get_user(fake_db, username)
+    if not user:
+        return False
+    if not verify_password(password, user.hashed_password):
+        return False
+    return user
+
+
+def create_access_token(*, data: dict, expires_delta: timedelta = None):
+    to_encode = data.copy()
+    if expires_delta:
+        expire = datetime.utcnow() + expires_delta
+    else:
+        expire = datetime.utcnow() + timedelta(minutes=15)
+    to_encode.update({"exp": expire})
+    encoded_jwt = jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)
+    return encoded_jwt
+
+
+async def get_current_user(
+    security_scopes: SecurityScopes, token: str = Depends(oauth2_scheme)
+):
+    credentials_exception = HTTPException(
+        status_code=HTTP_403_FORBIDDEN, detail="Could not validate credentials"
+    )
+    try:
+        payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
+        username: str = payload.get("sub")
+        if username is None:
+            raise credentials_exception
+        token_scopes = payload.get("scopes", [])
+        token_data = TokenData(scopes=token_scopes, username=username)
+    except (PyJWTError, ValidationError):
+        raise credentials_exception
+    user = get_user(fake_users_db, username=token_data.username)
+    if user is None:
+        raise credentials_exception
+    for scope in security_scopes.scopes:
+        if scope not in token_data.scopes:
+            raise HTTPException(
+                status_code=HTTP_403_FORBIDDEN, detail="Not enough permissions"
+            )
+    return user
+
+
+async def get_current_active_user(
+    current_user: User = Security(get_current_user, scopes=["me"])
+):
+    if current_user.disabled:
+        raise HTTPException(status_code=400, detail="Inactive user")
+    return current_user
+
+
+@app.post("/token", response_model=Token)
+async def route_login_access_token(form_data: OAuth2PasswordRequestForm = Depends()):
+    user = authenticate_user(fake_users_db, form_data.username, form_data.password)
+    if not user:
+        raise HTTPException(status_code=400, detail="Incorrect username or password")
+    access_token_expires = timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)
+    access_token = create_access_token(
+        data={"sub": user.username, "scopes": form_data.scopes},
+        expires_delta=access_token_expires,
+    )
+    return {"access_token": access_token, "token_type": "bearer"}
+
+
+@app.get("/users/me/", response_model=User)
+async def read_users_me(current_user: User = Depends(get_current_active_user)):
+    return current_user
+
+
+@app.get("/users/me/items/")
+async def read_own_items(
+    current_user: User = Security(get_current_active_user, scopes=["items"])
+):
+    return [{"item_id": "Foo", "owner": current_user.username}]
diff --git a/docs/tutorial/security/oauth2-jwt.md b/docs/tutorial/security/oauth2-jwt.md
index a28f4e95fe..4958d35f27 100644
--- a/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/tutorial/security/oauth2-jwt.md
@@ -46,7 +46,7 @@ So, the thief won't be able to try to use that password in another system (as ma
 
 PassLib is a great Python package to handle password hashes.
 
-It supports many secure hashing algorithms, and utilities to work with them.
+It supports many secure hashing algorithms and utilities to work with them.
 
 The recommended algorithm is "Bcrypt".
 
@@ -69,7 +69,7 @@ Import the tools we need from `passlib`.
 Create a PassLib "context". This is what will be used to hash and verify passwords.
 
 !!! tip
-    The PassLib context also has functionality to use different hashing algorithms, deprecate old ones, but allow verifying them, etc.
+    The PassLib context also has functionality to use different hashing algorithms, including deprecate old ones only to allow verifying them, etc.
 
     For example, you could use it to read and verify passwords generated by another system (like Django) but hash any new passwords with a different algorithm like Bcrypt.
 
@@ -81,7 +81,7 @@ And another utility to verify if a received password matches the hash stored.
 
 And another one to authenticate and return a user.
 
-```Python hl_lines="7 50 57 58 61 62 71 72 73 74 75 76 77"
+```Python hl_lines="7 39 56 57 60 61 70 71 72 73 74 75 76"
 {!./src/security/tutorial004.py!}
 ```
 
@@ -94,7 +94,7 @@ Import the modules installed.
 
 Create a random secret key that will be used to sign the JWT tokens.
 
-To generate a secure random secret, key use the command:
+To generate a secure random secret key use the command:
 
 ```bash
 openssl rand -hex 32
@@ -104,15 +104,13 @@ And copy the output to the variable `SECRET_KEY` (don't use the one in the examp
 
 Create a variable `ALGORITHM` with the algorithm used to sign the JWT token and set it to `"HS256"`.
 
-And another one for the `TOKEN_SUBJECT`, and set it to, for example, `"access"`.
-
 Create a variable for the expiration of the token.
 
 Define a Pydantic Model that will be used in the token endpoint for the response.
 
 Create a utility function to generate a new access token.
 
-```Python hl_lines="3 6 13 14 15 16 30 31 32 80 81 82 83 84 85 86 87 88"
+```Python hl_lines="3 6 13 14 15 29 30 31 79 80 81 82 83 84 85 86 87"
 {!./src/security/tutorial004.py!}
 ```
 
@@ -124,7 +122,7 @@ Decode the received token, verify it, and return the current user.
 
 If the token is invalid, return an HTTP error right away.
 
-```Python hl_lines="91 92 93 94 95 96 97 98 99 100"
+```Python hl_lines="90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105"
 {!./src/security/tutorial004.py!}
 ```
 
@@ -134,10 +132,33 @@ Create a `timedelta` with the expiration time of the token.
 
 Create a real JWT access token and return it.
 
-```Python hl_lines="114 115 116 117 118"
+```Python hl_lines="114 115 116 117 118 119 120 121 122 123"
 {!./src/security/tutorial004.py!}
 ```
 
+
+### Technical details about the JWT "subject" `sub`
+
+The JWT specification says that there's a key `sub`, with the subject of the token.
+
+It's optional to use it, but that's where you would put the user's identification, so we are using it here.
+
+JWT might be used for other things apart from identifying a user and allowing him to perform operations directly on your API.
+
+For example, you could identify a "car" or a "blog post".
+
+Then you could add permissions about that entity, like "drive" (for the car) or "edit" (for the blog).
+
+And then, you could give that JWT token to a user (or bot), and he could use it to perform those actions (drive the car, or edit the blog post) without even needing to have an account, just with the JWT token your API generated for that.
+
+Using these ideas, JWT can be used for way more sophisticate scenarios.
+
+In those cases, several of those entities could have the same ID, let's say `foo` (a user `foo`, a car `foo`, and a blog post `foo`).
+
+So, to avoid ID collisions, when creating the JWT token for the user, you could prefix the value of the `sub` key, e.g. with `username:`.
+
+The important thing to have in mind is that the `sub` key should have a unique identifier across the entire application.
+
 ## Check it
 
 Run the server and go to the docs: <a href="http://127.0.0.1:8000/docs" target="_blank">http://127.0.0.1:8000/docs</a>.
@@ -158,7 +179,7 @@ Password: `secret`
 
 <img src="/img/tutorial/security/image08.png">
 
-Call the endpoint `/users/me`, you will get the response as:
+Call the endpoint `/users/me/`, you will get the response as:
 
 ```JSON
 {
@@ -180,15 +201,17 @@ If you open the developer tools, you could see how the data sent and received is
 
 ## Advanced usage with `scopes`
 
-We didn't use it in this example, but `Security` can receive a parameter `scopes`, as a list of strings.
+OAuth2 has the notion of "scopes".
+
+You can use them to add a specific set of permissions to a JWT token.
 
-It would describe the scopes required for a specific path operation, as different path operations might require different security scopes, even while using the same `OAuth2PasswordBearer` (or any of the other tools).
+Then you can give this token to a user directly or a third party, to interact with your API with a set of restrictions.
 
-This only applies to OAuth2, and it might be, more or less, an advanced feature, but it is there, if you need to use it.
+You can learn how to use them and how they are integrated into **FastAPI** in the next section.
 
 ## Recap
 
-This concludes our tour for the security features of **FastAPI**.
+With what you have seen up to now, you can set up a secure **FastAPI** application using standards like OAuth2 and JWT.
 
 In almost any framework handling the security becomes a rather complex subject quite quickly.
 
@@ -205,3 +228,7 @@ And you can use directly many well maintained and widely used packages like `pas
 But it provides you the tools to simplify the process as much as possible without compromising flexibility, robustness or security.
 
 And you can use secure, standard protocols like OAuth2 in a relatively simple way.
+
+In the next (optional) section you can see how to extend this even further, using OAuth2 "scopes", for a more fine-grained permission system following standards.
+
+OAuth2 with scopes (explained in the next section) is the mechanism used by many big authentication providers, like Facebook, Google, GitHub, Microsoft, Twitter, etc.
diff --git a/docs/tutorial/security/oauth2-scopes.md b/docs/tutorial/security/oauth2-scopes.md
new file mode 100644
index 0000000000..51e28daafd
--- /dev/null
+++ b/docs/tutorial/security/oauth2-scopes.md
@@ -0,0 +1,191 @@
+You can use OAuth2 scopes directly with **FastAPI**, they are integrated to work seamlessly.
+
+This would allow you to have a more fine-grained permission system, following standards like OAuth2, integrated into your OpenAPI application (and the API docs).
+
+OAuth2 with scopes is the mechanism used by many big authentication providers, like Facebook, Google, GitHub, Microsoft, Twitter, etc. They use it to provide specific permissions to users and applications.
+
+Every time you "log in with" Facebook, Google, GitHub, Microsoft, Twitter, that application is using OAuth2 with scopes.
+
+In this section you will see how to manage authentication and authorization with the same OAuth2 with scopes in your **FastAPI** application.
+
+!!! warning
+    This is a more or less advanced section. If you are just starting, you can skip it.
+
+    You don't necessarily need OAuth2 scopes, you can handle authentication and authorization however you want.
+
+    But OAuth2 with scopes can be nicely integrated into your API (with OpenAPI) and your API docs.
+    
+    Nevertheless, you still enforce those scopes or any other security/authorization requirement however you need in your code.
+
+    In many cases, OAuth2 with scopes can be an overkill.
+    
+    But if you know you need it, or you are curious, keep reading.
+
+## OAuth2 scopes and OpenAPI
+
+The OAuth2 specification defines "scopes" as a list of strings separated by spaces.
+
+The content of each of these strings can have any format, but should not contain spaces.
+
+These scopes represent "permissions".
+
+In OpenAPI (e.g. the API docs), you can define "security schemes", the same as you saw in the previous sections.
+
+When one of these security schemes uses OAuth2, you can also declare and use scopes.
+
+## Global view
+
+First, let's quickly see the parts that change from the previous section about OAuth2 and JWT. Now using OAuth2 scopes:
+
+```Python hl_lines="2 5 9 13 48 66 106 115 116 117 122 123 124 125 126 131 145 158"
+{!./src/security/tutorial005.py!}
+```
+
+Now let's review those changes step by step.
+
+## OAuth2 Security scheme
+
+The first change is that now we are declaring the OAuth2 security scheme with two available scopes, `me` and `items`.
+
+The `scopes` parameter receives a `dict` with each scope as a key and the description as the value:
+
+```Python hl_lines="64 65 66 67"
+{!./src/security/tutorial005.py!}
+```
+
+Because we are now declaring those scopes,they will show up in the API docs when you log-in/authorize.
+
+And you will be able to select which scopes you want to give access to: `me` and `items`.
+
+This is the same mechanism used when you give permissions while logging in with Facebook, Google, GitHub, etc:
+
+<img src="/img/tutorial/security/image11.png">
+
+## JWT token with scopes
+
+Now, modify the token *path operation* to return the scopes requested.
+
+We are still using the same `OAuth2PasswordRequestForm`. It includes a property `scopes` with each scope it received.
+
+And we return the scopes as part of the JWT token.
+
+!!! danger
+    For simplicity, here we are just adding the scopes received directly to the token.
+
+    But in your application, for security, you should make sure you only add the scopes that the user is actually able to have, or the ones you have predefined.
+
+```Python hl_lines="145"
+{!./src/security/tutorial005.py!}
+```
+
+## Declare scopes in *path operations* and dependencies
+
+Now we declare that the *path operation* for `/users/me/items/` requires the scope `items`.
+
+For this, we import and use `Security` from `fastapi`.
+
+You can use `Security` to declare dependencies (just like `Depends`), but `Security` also receives a parameter `scopes` with a list of scopes (strings).
+
+In this case, we pass a dependency function `get_current_active_user` to `Security` (the same way we would do with `Depends`).
+
+But we also pass a `list` of scopes, in this case with just one scope: `items` (it could have more).
+
+And the dependency function `get_current_active_user` can also declare sub-dependencies, not only with `Depends` but also with `Security`. Declaring its own sub-dependency function (`get_current_user`), and more scope requirements.
+
+In this case, it requires the scope `me` (it could require more than one scope).
+
+!!! note
+    You don't necessarily need to add different scopes in different places.
+    
+    We are doing it here to demonstrate how **FastAPI** handles scopes declared at different levels.
+
+```Python hl_lines="5 131 158"
+{!./src/security/tutorial005.py!}
+```
+
+## Use `SecurityScopes`
+
+Now update the dependency `get_current_user`.
+
+This is the one used by the dependencies above.
+
+Here's were we are declaring the same OAuth2 scheme we created above as a dependency: `oauth2_scheme`.
+
+Because this dependency function doesn't have any scope requirements itself, we can use `Depends` with `oauth2_scheme`, we don't have to use `Security`.
+
+We also declare a special parameter of type `SecurityScopes`, imported from `fastapi.security`.
+
+This `SecurityScopes` class is similar to `Request` (`Request` was used to get the request object directly).
+
+The parameter `security_scopes` will be of type `SecurityScopes`. It will have a property `scopes` with a list containing all the scopes required by itself and all the dependencies that use this as a sub-dependency. That means, all the "dependants" or all the super-dependencies (the contrary of sub-dependencies).
+
+We verify that all the scopes required, by this dependency and all the dependants (including *path operations*), are included in the scopes provided in the token received, otherwise raise an `HTTPException`.
+
+We also check that the token data is validated with the Pydantic model (catching the `ValidationError` exception), and if we get an error reading the JWT token or validating the data with Pydantic, we also raise an `HTTPException`.
+
+By validating the data with Pydantic we can make sure that we have, for example, exactly a `list` of `str` with the scopes and a `str` with the `username`. Instead of, for example, a `dict`, or something else, as it could break the application at some point later.
+
+
+```Python hl_lines="9 13 106 48 106 115 116 117 122 123"
+{!./src/security/tutorial005.py!}
+```
+
+So, as the other dependency `get_current_active_user` has as a sub-dependency this `get_current_user`, the scope `"me"` declared at `get_current_active_user` will be included in the `security_scopes.scopes` `list` inside of `get_current_user`.
+
+And as the *path operation* itself also declares a scope `"items"`, it will also be part of this `list` `security_scopes.scopes` in `get_current_user`.
+
+Here's how the hierarchy of dependencies and scopes looks like:
+
+* The *path operation* `read_own_items` has:
+    * Required scopes `["items"]` with the dependency:
+    * `get_current_active_user`:
+        *  The dependency function `get_current_active_user` has:
+            * Required scopes `["me"]` with the dependency:
+            * `get_current_user`:
+                * The dependency function `get_current_user` has:
+                    * No scopes required by itself.
+                    * A dependency using `oauth2_scheme`.
+                    * A `security_scopes` parameter of type `SecurityScopes`:
+                        * This `security_scopes` parameter has a property `scopes` with a `list` containing all these scopes declared above, so:
+                            * `security_scopes.scopes` will contain `["me", "items"]`
+
+## More details about `SecurityScopes`
+
+You can use `SecurityScopes` at any point, and in multiple places, it doesn't have to be at the "root" dependency.
+
+It will always have the security scopes declared in the current `Security` dependencies and all the super-dependencies/dependants.
+
+Because the `SecurityScopes` will have all the scopes declared by super-dependencies/dependants, you can use it to verify that a token has the required scopes in a central dependency function, and then declare different scope requirements in different *path operations*.
+
+## Check it
+
+If you open the API docs, you can authenticate and specify which scopes you want to authorize.
+
+<img src="/img/tutorial/security/image11.png">
+
+If you don't select any scope, you will be "authenticated", but when you try to access `/users/me/` or `/users/me/items/` you will get an error saying that you don't have enough permissions.
+
+And if you select the scope `me` but not the scope `items`, you will be able to access `/users/me/` but not `/users/me/items/`.
+
+That's what would happen to a third party application that tried to access one of these *path operations* with a token provided by a user, depending on how many permissions the user gave the application.
+
+## About third party integrations
+
+In this example we are using the OAuth2 "password" flow.
+
+This is appropriate when we are logging in to our own application, probably with our own frontend.
+
+Because we can trust it to receive the `username` and `password`, as we control it.
+
+But if you are building an OAuth2 application that others would connect to (i.e., if you are building an authentication provider equivalent to Facebook, Google, GitHub, etc.) you should use one of the other flows.
+
+The most common is the implicit flow.
+
+The most secure is the code flow, but is more complex to implement as it requires more steps. As it is more cumbersome, many providers end up suggesting the implicit flow.
+
+!!! note
+    It's common that each authentication provider names their flows in a different way, to make it part of their brand.
+
+    But in the end, they are implementing the same OAuth2 standard.
+
+**FastAPI** includes utilities for all these OAuth2 authentication flows in `fastapi.security.oauth2`.
diff --git a/fastapi/dependencies/models.py b/fastapi/dependencies/models.py
index d7fbf853d1..8bba5e369c 100644
--- a/fastapi/dependencies/models.py
+++ b/fastapi/dependencies/models.py
@@ -27,6 +27,8 @@ class Dependant:
         call: Callable = None,
         request_param_name: str = None,
         background_tasks_param_name: str = None,
+        security_scopes_param_name: str = None,
+        security_scopes: List[str] = None,
     ) -> None:
         self.path_params = path_params or []
         self.query_params = query_params or []
@@ -37,5 +39,7 @@ class Dependant:
         self.security_requirements = security_schemes or []
         self.request_param_name = request_param_name
         self.background_tasks_param_name = background_tasks_param_name
+        self.security_scopes = security_scopes
+        self.security_scopes_param_name = security_scopes_param_name
         self.name = name
         self.call = call
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 86b4ca0058..4cf737d670 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -20,6 +20,8 @@ from uuid import UUID
 from fastapi import params
 from fastapi.dependencies.models import Dependant, SecurityRequirement
 from fastapi.security.base import SecurityBase
+from fastapi.security.oauth2 import OAuth2, SecurityScopes
+from fastapi.security.open_id_connect_url import OpenIdConnect
 from fastapi.utils import UnconstrainedConfig, get_path_param_names
 from pydantic import Schema, create_model
 from pydantic.error_wrappers import ErrorWrapper
@@ -46,18 +48,32 @@ param_supported_types = (
 )
 
 
-def get_sub_dependant(*, param: inspect.Parameter, path: str) -> Dependant:
+def get_sub_dependant(
+    *, param: inspect.Parameter, path: str, security_scopes: List[str] = None
+) -> Dependant:
     depends: params.Depends = param.default
     if depends.dependency:
         dependency = depends.dependency
     else:
         dependency = param.annotation
-    sub_dependant = get_dependant(path=path, call=dependency, name=param.name)
-    if isinstance(depends, params.Security) and isinstance(dependency, SecurityBase):
+    security_requirement = None
+    security_scopes = security_scopes or []
+    if isinstance(depends, params.Security):
+        dependency_scopes = depends.scopes
+        security_scopes.extend(dependency_scopes)
+    if isinstance(dependency, SecurityBase):
+        use_scopes = []
+        if isinstance(dependency, (OAuth2, OpenIdConnect)):
+            use_scopes = security_scopes
         security_requirement = SecurityRequirement(
-            security_scheme=dependency, scopes=depends.scopes
+            security_scheme=dependency, scopes=use_scopes
         )
+    sub_dependant = get_dependant(
+        path=path, call=dependency, name=param.name, security_scopes=security_scopes
+    )
+    if security_requirement:
         sub_dependant.security_requirements.append(security_requirement)
+    sub_dependant.security_scopes = security_scopes
     return sub_dependant
 
 
@@ -81,7 +97,9 @@ def get_flat_dependant(dependant: Dependant) -> Dependant:
     return flat_dependant
 
 
-def get_dependant(*, path: str, call: Callable, name: str = None) -> Dependant:
+def get_dependant(
+    *, path: str, call: Callable, name: str = None, security_scopes: List[str] = None
+) -> Dependant:
     path_param_names = get_path_param_names(path)
     endpoint_signature = inspect.signature(call)
     signature_params = endpoint_signature.parameters
@@ -89,7 +107,9 @@ def get_dependant(*, path: str, call: Callable, name: str = None) -> Dependant:
     for param_name in signature_params:
         param = signature_params[param_name]
         if isinstance(param.default, params.Depends):
-            sub_dependant = get_sub_dependant(param=param, path=path)
+            sub_dependant = get_sub_dependant(
+                param=param, path=path, security_scopes=security_scopes
+            )
             dependant.dependencies.append(sub_dependant)
     for param_name in signature_params:
         param = signature_params[param_name]
@@ -138,6 +158,8 @@ def get_dependant(*, path: str, call: Callable, name: str = None) -> Dependant:
             dependant.request_param_name = param_name
         elif lenient_issubclass(param.annotation, BackgroundTasks):
             dependant.background_tasks_param_name = param_name
+        elif lenient_issubclass(param.annotation, SecurityScopes):
+            dependant.security_scopes_param_name = param_name
         elif not isinstance(param.default, params.Depends):
             add_param_to_body_fields(param=param, dependant=dependant)
     return dependant
@@ -282,6 +304,10 @@ async def solve_dependencies(
         if background_tasks is None:
             background_tasks = BackgroundTasks()
         values[dependant.background_tasks_param_name] = background_tasks
+    if dependant.security_scopes_param_name:
+        values[dependant.security_scopes_param_name] = SecurityScopes(
+            scopes=dependant.security_scopes
+        )
     return values, errors, background_tasks
 
 
diff --git a/fastapi/security/__init__.py b/fastapi/security/__init__.py
index 32d69e74d3..de88d8f151 100644
--- a/fastapi/security/__init__.py
+++ b/fastapi/security/__init__.py
@@ -6,5 +6,10 @@ from .http import (
     HTTPBearer,
     HTTPDigest,
 )
-from .oauth2 import OAuth2, OAuth2PasswordBearer, OAuth2PasswordRequestForm
+from .oauth2 import (
+    OAuth2,
+    OAuth2PasswordBearer,
+    OAuth2PasswordRequestForm,
+    SecurityScopes,
+)
 from .open_id_connect_url import OpenIdConnect
diff --git a/fastapi/security/oauth2.py b/fastapi/security/oauth2.py
index d779bcae1e..31ddc946df 100644
--- a/fastapi/security/oauth2.py
+++ b/fastapi/security/oauth2.py
@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import List, Optional
 
 from fastapi.openapi.models import OAuth2 as OAuth2Model, OAuthFlows as OAuthFlowsModel
 from fastapi.params import Form
@@ -159,3 +159,8 @@ class OAuth2PasswordBearer(OAuth2):
             else:
                 return None
         return param
+
+
+class SecurityScopes:
+    def __init__(self, scopes: List[str] = None):
+        self.scopes = scopes or []
diff --git a/mkdocs.yml b/mkdocs.yml
index 811d3c197d..d7cf5f2422 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -56,6 +56,7 @@ nav:
             - Get Current User: 'tutorial/security/get-current-user.md'
             - Simple OAuth2 with Password and Bearer: 'tutorial/security/simple-oauth2.md'
             - OAuth2 with Password (and hashing), Bearer with JWT tokens: 'tutorial/security/oauth2-jwt.md'
+            - OAuth2 scopes: 'tutorial/security/oauth2-scopes.md'
         - Using the Request Directly: 'tutorial/using-request-directly.md'    
         - SQL (Relational) Databases: 'tutorial/sql-databases.md'
         - Async SQL (Relational) Databases: 'tutorial/async-sql-databases.md'
diff --git a/tests/test_tutorial/test_security/test_tutorial005.py b/tests/test_tutorial/test_security/test_tutorial005.py
new file mode 100644
index 0000000000..d0f0bdf044
--- /dev/null
+++ b/tests/test_tutorial/test_security/test_tutorial005.py
@@ -0,0 +1,313 @@
+from starlette.testclient import TestClient
+
+from security.tutorial005 import (
+    app,
+    create_access_token,
+    fake_users_db,
+    get_password_hash,
+    verify_password,
+)
+
+client = TestClient(app)
+
+openapi_schema = {
+    "openapi": "3.0.2",
+    "info": {"title": "Fast API", "version": "0.1.0"},
+    "paths": {
+        "/token": {
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Token"}
+                            }
+                        },
+                    },
+                    "422": {
+                        "description": "Validation Error",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/HTTPValidationError"
+                                }
+                            }
+                        },
+                    },
+                },
+                "summary": "Route Login Access Token Post",
+                "operationId": "route_login_access_token_token_post",
+                "requestBody": {
+                    "content": {
+                        "application/x-www-form-urlencoded": {
+                            "schema": {
+                                "$ref": "#/components/schemas/Body_route_login_access_token"
+                            }
+                        }
+                    },
+                    "required": True,
+                },
+            }
+        },
+        "/users/me/": {
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/User"}
+                            }
+                        },
+                    }
+                },
+                "summary": "Read Users Me Get",
+                "operationId": "read_users_me_users_me__get",
+                "security": [{"OAuth2PasswordBearer": ["me"]}],
+            }
+        },
+        "/users/me/items/": {
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {"application/json": {"schema": {}}},
+                    }
+                },
+                "summary": "Read Own Items Get",
+                "operationId": "read_own_items_users_me_items__get",
+                "security": [{"OAuth2PasswordBearer": ["items", "me"]}],
+            }
+        },
+    },
+    "components": {
+        "schemas": {
+            "Body_route_login_access_token": {
+                "title": "Body_route_login_access_token",
+                "required": ["username", "password"],
+                "type": "object",
+                "properties": {
+                    "grant_type": {
+                        "title": "Grant_Type",
+                        "pattern": "password",
+                        "type": "string",
+                    },
+                    "username": {"title": "Username", "type": "string"},
+                    "password": {"title": "Password", "type": "string"},
+                    "scope": {"title": "Scope", "type": "string", "default": ""},
+                    "client_id": {"title": "Client_Id", "type": "string"},
+                    "client_secret": {"title": "Client_Secret", "type": "string"},
+                },
+            },
+            "Token": {
+                "title": "Token",
+                "required": ["access_token", "token_type"],
+                "type": "object",
+                "properties": {
+                    "access_token": {"title": "Access_Token", "type": "string"},
+                    "token_type": {"title": "Token_Type", "type": "string"},
+                },
+            },
+            "User": {
+                "title": "User",
+                "required": ["username"],
+                "type": "object",
+                "properties": {
+                    "username": {"title": "Username", "type": "string"},
+                    "email": {"title": "Email", "type": "string"},
+                    "full_name": {"title": "Full_Name", "type": "string"},
+                    "disabled": {"title": "Disabled", "type": "boolean"},
+                },
+            },
+            "ValidationError": {
+                "title": "ValidationError",
+                "required": ["loc", "msg", "type"],
+                "type": "object",
+                "properties": {
+                    "loc": {
+                        "title": "Location",
+                        "type": "array",
+                        "items": {"type": "string"},
+                    },
+                    "msg": {"title": "Message", "type": "string"},
+                    "type": {"title": "Error Type", "type": "string"},
+                },
+            },
+            "HTTPValidationError": {
+                "title": "HTTPValidationError",
+                "type": "object",
+                "properties": {
+                    "detail": {
+                        "title": "Detail",
+                        "type": "array",
+                        "items": {"$ref": "#/components/schemas/ValidationError"},
+                    }
+                },
+            },
+        },
+        "securitySchemes": {
+            "OAuth2PasswordBearer": {
+                "type": "oauth2",
+                "flows": {
+                    "password": {
+                        "scopes": {
+                            "me": "Read information about the current user.",
+                            "items": "Read items.",
+                        },
+                        "tokenUrl": "/token",
+                    }
+                },
+            }
+        },
+    },
+}
+
+
+def get_access_token(username="johndoe", password="secret", scope=None):
+    data = {"username": username, "password": password}
+    if scope:
+        data["scope"] = scope
+    response = client.post("/token", data=data)
+    content = response.json()
+    access_token = content.get("access_token")
+    return access_token
+
+
+def test_openapi_schema():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200
+    assert response.json() == openapi_schema
+
+
+def test_login():
+    response = client.post("/token", data={"username": "johndoe", "password": "secret"})
+    assert response.status_code == 200
+    content = response.json()
+    assert "access_token" in content
+    assert content["token_type"] == "bearer"
+
+
+def test_login_incorrect_password():
+    response = client.post(
+        "/token", data={"username": "johndoe", "password": "incorrect"}
+    )
+    assert response.status_code == 400
+    assert response.json() == {"detail": "Incorrect username or password"}
+
+
+def test_login_incorrect_username():
+    response = client.post("/token", data={"username": "foo", "password": "secret"})
+    assert response.status_code == 400
+    assert response.json() == {"detail": "Incorrect username or password"}
+
+
+def test_no_token():
+    response = client.get("/users/me")
+    assert response.status_code == 403
+    assert response.json() == {"detail": "Not authenticated"}
+
+
+def test_token():
+    access_token = get_access_token(scope="me")
+    response = client.get(
+        "/users/me", headers={"Authorization": f"Bearer {access_token}"}
+    )
+    print(response.json())
+    assert response.status_code == 200
+    assert response.json() == {
+        "username": "johndoe",
+        "full_name": "John Doe",
+        "email": "johndoe@example.com",
+        "disabled": False,
+    }
+
+
+def test_incorrect_token():
+    response = client.get("/users/me", headers={"Authorization": "Bearer nonexistent"})
+    assert response.status_code == 403
+    assert response.json() == {"detail": "Could not validate credentials"}
+
+
+def test_incorrect_token_type():
+    response = client.get(
+        "/users/me", headers={"Authorization": "Notexistent testtoken"}
+    )
+    assert response.status_code == 403
+    assert response.json() == {"detail": "Not authenticated"}
+
+
+def test_verify_password():
+    assert verify_password("secret", fake_users_db["johndoe"]["hashed_password"])
+
+
+def test_get_password_hash():
+    assert get_password_hash("secretalice")
+
+
+def test_create_access_token():
+    access_token = create_access_token(data={"data": "foo"})
+    assert access_token
+
+
+def test_token_no_sub():
+    response = client.get(
+        "/users/me",
+        headers={
+            "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiZm9vIn0.9ynBhuYb4e6aW3oJr_K_TBgwcMTDpRToQIE25L57rOE"
+        },
+    )
+    assert response.status_code == 403
+    assert response.json() == {"detail": "Could not validate credentials"}
+
+
+def test_token_no_username():
+    response = client.get(
+        "/users/me",
+        headers={
+            "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJmb28ifQ.NnExK_dlNAYyzACrXtXDrcWOgGY2JuPbI4eDaHdfK5Y"
+        },
+    )
+    assert response.status_code == 403
+    assert response.json() == {"detail": "Could not validate credentials"}
+
+
+def test_token_no_scope():
+    access_token = get_access_token()
+    response = client.get(
+        "/users/me", headers={"Authorization": f"Bearer {access_token}"}
+    )
+    assert response.status_code == 403
+    assert response.json() == {"detail": "Not enough permissions"}
+
+
+def test_token_inexistent_user():
+    response = client.get(
+        "/users/me",
+        headers={
+            "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VybmFtZTpib2IifQ.HcfCW67Uda-0gz54ZWTqmtgJnZeNem0Q757eTa9EZuw"
+        },
+    )
+    assert response.status_code == 403
+    assert response.json() == {"detail": "Could not validate credentials"}
+
+
+def test_token_inactive_user():
+    access_token = get_access_token(
+        username="alice", password="secretalice", scope="me"
+    )
+    response = client.get(
+        "/users/me", headers={"Authorization": f"Bearer {access_token}"}
+    )
+    print(response.json())
+    assert response.status_code == 400
+    assert response.json() == {"detail": "Inactive user"}
+
+
+def test_read_items():
+    access_token = get_access_token(scope="me items")
+    response = client.get(
+        "/users/me/items/", headers={"Authorization": f"Bearer {access_token}"}
+    )
+    assert response.status_code == 200
+    assert response.json() == [{"item_id": "Foo", "owner": "johndoe"}]
-- 
2.47.3