## Primeira dependência "dependable" { #first-dependency-dependable }

Você pode criar uma primeira dependência ("dependable") dessa forma:

{* ../../docs_src/dependencies/tutorial005_an_py310.py hl[8:9] *}

Esse código declara um parâmetro de consulta opcional, `q`, com o tipo `str`, e então retorna esse parâmetro.

### 의존성 요구사항 { #dependency-requirements }

(헤더같은) 요청 요구사항이나 하위-의존성을 선언할 수 있습니다:

{* ../../docs_src/dependencies/tutorial006_an_py310.py hl[8,13] *}

### 오류 발생시키기 { #raise-exceptions }

다음 의존성은 기존 의존성과 동일하게 예외를 `raise`할 수 있습니다:

{* ../../docs_src/dependencies/tutorial006_an_py310.py hl[10,15] *}

### 값 반환하기 { #return-values }

값을 반환하거나, 그러지 않을 수 있으며 값은 사용되지 않습니다.

{* ../../docs_src/dependencies/tutorial006_an_py310.py hl[8,13] *}

### 触发异常 { #raise-exceptions }

路径装饰器依赖项与正常的依赖项一样，可以 `raise` 异常：

{* ../../docs_src/dependencies/tutorial006_an_py310.py hl[10,15] *}

### 返回值 { #return-values }

无论路径装饰器依赖项是否返回值，路径操作都不会使用这些值。

因此，可以复用在其他位置使用过的、（能返回值的）普通依赖项，即使没有使用这个值，也会执行该依赖项：

{* ../../docs_src/dependencies/tutorial006_an_py310.py hl[11,16] *}

{* ../../docs_src/security/tutorial005_an_py310.py hl[5,9,13,47,65,106,108:116,122:126,130:136,141,157] *}

では、これらの変更を一つずつ確認していきます。

## OAuth2 のセキュリティスキーム { #oauth2-security-scheme }

最初の変更点は、`me` と `items` の 2 つのスコープを持つ OAuth2 セキュリティスキームを宣言していることです。

`scopes` パラメータは、各スコープをキー、その説明を値とする `dict` を受け取ります:

{* ../../docs_src/security/tutorial005_an_py310.py hl[63:66] *}

{* ../../docs_src/security/tutorial005_an_py310.py hl[5,9,13,47,65,106,108:116,122:126,130:136,141,157] *}

이제 변경 사항을 단계별로 살펴보겠습니다.

## OAuth2 보안 스킴 { #oauth2-security-scheme }

첫 번째 변경 사항은 이제 사용 가능한 스코프 2개(`me`, `items`)로 OAuth2 보안 스킴을 선언한다는 점입니다.

`scopes` 매개변수는 각 스코프를 키로 하고, 설명을 값으로 하는 `dict`를 받습니다:

{* ../../docs_src/security/tutorial005_an_py310.py hl[63:66] *}

{* ../../docs_src/security/tutorial005_an_py310.py hl[5,9,13,47,65,106,108:116,122:126,130:136,141,157] *}

Ahora revisemos esos cambios paso a paso.

## Esquema de seguridad OAuth2 { #oauth2-security-scheme }

{* ../../docs_src/security/tutorial004_an_py310.py hl[93:110] *}

## Die *Pfadoperation* `/token` aktualisieren { #update-the-token-path-operation }

Erstellen Sie ein <abbr title="Zeitdifferenz">`timedelta`</abbr> mit der Ablaufzeit des Tokens.

Erstellen Sie einen echten JWT-Zugriffstoken und geben Sie ihn zurück.

{* ../../docs_src/security/tutorial004_an_py310.py hl[121:136] *}

{* ../../docs_src/security/tutorial004_an_py310.py hl[93:110] *}

## Actualizar la *path operation* `/token` { #update-the-token-path-operation }

Crea un `timedelta` con el tiempo de expiración del token.

Crea un verdadero token de acceso JWT y devuélvelo.

{* ../../docs_src/security/tutorial004_an_py310.py hl[121:136] *}

from tests.utils import needs_py310, workdir_lock


@pytest.fixture(
    name="client",
    params=[
        pytest.param("tutorial002_py310", marks=needs_py310),
        pytest.param("tutorial002_an_py310", marks=needs_py310),
    ],
)
def get_client(request: pytest.FixtureRequest):
    mod = importlib.import_module(f"docs_src.background_tasks.{request.param}")

    client = TestClient(mod.app)
    return client

{* ../../docs_src/security/tutorial005_an_py310.py hl[5,9,13,47,65,106,108:116,122:126,130:136,141,157] *}

Passons maintenant en revue ces changements étape par étape.

## Déclarer le schéma de sécurité OAuth2 { #oauth2-security-scheme }