# Security Tools

When you need to declare dependencies with OAuth2 scopes you use `Security()`.

But you still need to define what is the dependable, the callable that you pass as a parameter to `Depends()` or `Security()`.

There are multiple tools that you can use to create those dependables, and they get integrated into OpenAPI so they are shown in the automatic docs UI, they can be used by automatically generated clients and SDKs, etc.

Вы можете создавать зависимости, которые имеют **подзависимости**.

Их **вложенность** может быть любой глубины.

**FastAPI** сам займётся их управлением.

## Первая зависимость { #first-dependency-dependable }

Можно создать первую зависимость следующим образом:

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

Она объявляет необязательный параметр запроса `q` как строку, а затем возвращает его.

* 共享业务逻辑（同一段代码逻辑反复复用）
* 共享数据库连接
* 实施安全、认证、角色权限等要求
* 以及更多其他内容...

同时尽量减少代码重复。

## 第一步 { #first-steps }

先来看一个非常简单的例子。它现在简单到几乎没什么用。

但这样我们就可以专注于**依赖注入**系统是如何工作的。

### 创建依赖项，或“dependable” { #create-a-dependency-or-dependable }

首先关注依赖项。

它只是一个函数，且可以接收与*路径操作函数*相同的所有参数：

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

大功告成。

**2 行**。

它的形式和结构与所有*路径操作函数*相同。

Im vorherigen Beispiel haben wir ein <abbr title="Dictionary – Zuordnungstabelle: In anderen Sprachen auch Hash, Map, Objekt, Assoziatives Array genannt">`dict`</abbr> von unserer Abhängigkeit („Dependable“) zurückgegeben:

{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[9] *}

Aber dann haben wir ein `dict` im Parameter `commons` der *Pfadoperation-Funktion*.

* Cross-Origin Resource Sharing: Cross-Origin Resource Sharing (do not translate to "Compartilhamento de Recursos de Origem Cruzada")
* Deep Learning: Deep Learning (do not translate to "Aprendizado Profundo")
* dependable: dependable
* dependencies: dependências
* deprecated: descontinuado
* docs: documentação
* FastAPI app: aplicação FastAPI
* framework: framework (do not translate)
* feature: funcionalidade
* guides: tutoriais

Ama bu sayede **Dependency Injection** sisteminin nasıl çalıştığına odaklanabiliriz.

### Bir dependency (bağımlılık) veya "dependable" Oluşturun { #create-a-dependency-or-dependable }

Önce dependency'e odaklanalım.

Bu, bir *path operation function*'ın alabileceği parametrelerin aynısını alabilen basit bir fonksiyondur:

Но так мы сможем сосредоточиться на том, как работает система **Dependency Injection**.

### Создайте зависимость, или «dependable» (от чего что-то зависит) { #create-a-dependency-or-dependable }

Сначала сосредоточимся на зависимости.

Это просто функция, которая может принимать те же параметры, что и *функция обработки пути*:

**FastAPI** はそれらを解決してくれます。

## 最初の依存関係「依存可能なもの」 { #first-dependency-dependable }

以下のような最初の依存関係（「依存可能なもの」）を作成することができます:

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

これはオプショナルのクエリパラメータ`q`を`str`として宣言し、それを返すだけです。

これは非常にシンプルです（あまり便利ではありません）が、サブ依存関係がどのように機能するかに焦点を当てるのに役立ちます。

## 第二の依存関係 「依存可能なもの」と「依存」 { #second-dependency-dependable-and-dependant }

Veamos un ejemplo muy simple. Será tan simple que no es muy útil, por ahora.

Pero de esta manera podemos enfocarnos en cómo funciona el sistema de **Inyección de Dependencias**.

### Crear una dependencia, o "dependable" { #create-a-dependency-or-dependable }

Primero enfoquémonos en la dependencia.

Es solo una función que puede tomar todos los mismos parámetros que una *path operation function* puede tomar:

**Dependency Injection** sistemine daha derinlemesine geçmeden önce, bir önceki örneği geliştirelim.

## Önceki Örnekten Bir `dict` { #a-dict-from-the-previous-example }

Önceki örnekte, dependency'mizden ("dependable") bir `dict` döndürüyorduk:

{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[9] *}

Ama sonra *path operation function* içindeki `commons` parametresinde bir `dict` alıyoruz.