# 環境變數 { #environment-variables }

/// tip

如果你已經知道什麼是「環境變數」並且知道如何使用它們，你可以放心跳過這一部分。

///

環境變數（也稱為「**env var**」）是一個獨立於 Python 程式碼**之外**的變數，它存在於**作業系統**中，可以被你的 Python 程式碼（或其他程式）讀取。

環境變數對於處理應用程式**設定**（作為 Python **安裝**的一部分等方面）非常有用。

## 建立和使用環境變數 { #create-and-use-env-vars }

你在 **shell（終端機）**中就可以**建立**和使用環境變數，並不需要用到 Python：

//// tab | Linux, macOS, Windows Bash

<div class="termy">

```console

この単純な例では、完全に安全ではありませんが、トークンとして同じ `username` をそのまま返します。

/// tip | 豆知識

次の章では、パスワードハッシュ化と <abbr title="JSON Web Tokens - JSON Web Token">JWT</abbr> トークンを使った本当に安全な実装を見ます。

しかし今は、必要な特定の詳細に集中しましょう。

///

{* ../../docs_src/security/tutorial003_an_py310.py hl[87] *}

/// tip | 豆知識

仕様に従うと、この例と同じく `access_token` と `token_type` を含む JSON を返す必要があります。

# 進階使用者指南 { #advanced-user-guide }

## 更多功能 { #additional-features }

主要的[教學 - 使用者指南](../tutorial/index.md) 應足以帶你快速瀏覽 **FastAPI** 的所有核心功能。

在接下來的章節中，你會看到其他選項、設定，以及更多功能。

/// tip

接下來的章節**不一定是「進階」**。

而且對於你的使用情境，解法很可能就在其中某一節。

///

## 先閱讀教學 { #read-the-tutorial-first }

只要掌握主要[教學 - 使用者指南](../tutorial/index.md) 的內容，你就能使用 **FastAPI** 的大多數功能。

这就是所有带有「使用 Facebook，Google，X (Twitter)，GitHub 登录」的系统背后所使用的机制。

### OAuth 1 { #oauth-1 }

有一个 OAuth 1，它与 OAuth2 完全不同，并且更为复杂，因为它直接包含了有关如何加密通信的规范。

如今它已经不是很流行，没有被广泛使用了。

OAuth2 没有指定如何加密通信，它期望你为应用程序使用 HTTPS 进行通信。

/// tip | 提示

在有关**部署**的章节中，你将了解如何使用 Traefik 和 Let's Encrypt 免费设置 HTTPS。

///

## OpenID Connect { #openid-connect }

OpenID Connect 是另一个基于 **OAuth2** 的规范。

它只是扩展了 OAuth2，并明确了一些在 OAuth2 中相对模糊的内容，以尝试使其更具互操作性。

# 高度なセキュリティ { #advanced-security }

## 追加機能 { #additional-features }

[チュートリアル - ユーザーガイド: セキュリティ](../../tutorial/security/index.md)で扱ったもの以外にも、セキュリティを扱うための追加機能がいくつかあります。

/// tip | 豆知識

次の節は**必ずしも「高度」ではありません**。

あなたのユースケースでは、その中のいずれかに解決策があるかもしれません。

///

## まずチュートリアルを読む { #read-the-tutorial-first }

以下の節は、すでにメインの[チュートリアル - ユーザーガイド: セキュリティ](../../tutorial/security/index.md)を読んでいることを前提とします。

```

</div>

It will serve the documentation on `http://127.0.0.1:8008`.

That way, you can edit the documentation/source files and see the changes live.

/// tip

Alternatively, you can perform the same steps that scripts does manually.

Go into the language directory, for the main docs in English it's at `docs/en/`:

```console
$ cd docs/en/
```

```

</div>

在浏览器中打开 [http://127.0.0.1:8000](http://127.0.0.1:8000)。

在页面中，您可以设置：

* "Item ID"，用于路径。
* "Token"，作为查询参数。

/// tip

注意，查询参数 `token` 将由依赖项处理。

///

通过这样，您可以连接 WebSocket，然后发送和接收消息：

<img src="/img/tutorial/websockets/image05.png">

## 处理断开连接和多个客户端 { #handling-disconnections-and-multiple-clients }

你可以這樣設定它們：

{* ../../docs_src/metadata/tutorial001_py310.py hl[3:16, 19:32] *}

/// tip | 提示

你可以在 `description` 欄位中撰寫 Markdown，輸出時會被正確渲染。

///

使用這些設定後，自動產生的 API 文件會像這樣：

<img src="/img/tutorial/metadata/image01.png">

## 授權識別碼 { #license-identifier }

たとえば、既定の `401 Unauthorized` エラーの代わりに `403 Forbidden` エラーを返す `HTTPBearer` のサブクラスを作成できます:

{* ../../docs_src/authentication_error_status_code/tutorial001_an_py310.py hl[9:13] *}

/// tip | 豆知識

この関数は例外インスタンスを返す点に注意してください。ここでは例外を送出しません。送出は内部の他のコードで行われます。

      <span style="background-color:#007166"><font color="#D3D7CF"> tip </font></span>  Running in development mode, for production use:
             <b>fastapi run</b>

             Logs: