> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-TW/llms.txt

# 驗證概覽

Mastra 可讓你選擇處理身分驗證的方式，以最適合你技術堆疊的身分系統保護 API 與 [Studio](https://mastra.zisheng.pro/zh-TW/docs/studio/overview) 的存取權。

你可以先使用基本的共用密鑰 JWT 驗證，並在需要更進階的身分功能時改用知名服務。

## 驗證會保護哪些項目

設定身分驗證會同時鎖定兩個項目：

- **Studio UI**：Studio 會顯示登入畫面（SSO、電子郵件／密碼或兩者），並強制執行角色型存取控制，以決定每位團隊成員可查看及執行的內容。
- **API 路由**：所有內建路由（`/api/agents/*`、`/api/workflows/*` 等）和自訂路由都需要驗證，無論請求來自 Studio 或直接 API 呼叫。

身分驗證並非必要。如果未設定驗證，所有路由和 Studio 都可供公開存取。你可以使用 `requiresAuth: false`，針對個別自訂路由啟用公開存取。

若要控制自訂端點的身分驗證，請參閱[自訂 API 路由](https://mastra.zisheng.pro/zh-TW/docs/server/custom-api-routes)。如需進一步瞭解如何保護 Studio 部署，請參閱 [Studio 驗證文件](https://mastra.zisheng.pro/zh-TW/docs/studio/auth)。

> **警告:** 預設驗證設定會保護 `/api/*`，並將 `/api`、`/api/auth/*` 視為公開路由。設定自訂 `server.apiPrefix` 後，這些預設值將不再符合，內建路由也會落在受保護的模式之外。請更新 `server.auth.protected` 和 `server.auth.public`，以參照新的前綴。

> **備註:** Studio 的身分驗證目前支援下列服務：Simple Auth、JWT、WorkOS、Better Auth 和 Google。

## 可用服務

### 內建

- [Simple Auth](https://mastra.zisheng.pro/zh-TW/docs/server/auth/simple-auth)：供開發與 API 金鑰使用的權杖對使用者對應
- [JSON Web Token (JWT)](https://mastra.zisheng.pro/zh-TW/docs/server/auth/jwt)：驗證以 HMAC 簽署的 JWT

### 第三方整合

- [Auth0](https://mastra.zisheng.pro/zh-TW/docs/server/auth/auth0)
- [Better Auth](https://mastra.zisheng.pro/zh-TW/docs/server/auth/better-auth)
- [Clerk](https://mastra.zisheng.pro/zh-TW/docs/server/auth/clerk)
- [Firebase](https://mastra.zisheng.pro/zh-TW/docs/server/auth/firebase)
- [Google](https://mastra.zisheng.pro/zh-TW/docs/server/auth/google)
- [Okta](https://mastra.zisheng.pro/zh-TW/docs/server/auth/okta)
- [Supabase](https://mastra.zisheng.pro/zh-TW/docs/server/auth/supabase)
- [WorkOS](https://mastra.zisheng.pro/zh-TW/docs/server/auth/workos)

### 進階

- [Composite Auth](https://mastra.zisheng.pro/zh-TW/docs/server/auth/composite-auth)：結合多個驗證 Provider
- [自訂驗證 Provider](https://mastra.zisheng.pro/zh-TW/docs/server/auth/custom-auth-provider)：建立自己的 Provider