> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 身份認證模組

通過 Better Auth 的身份與會話。

## 建立並驗證真實賬戶

身份驗證意味著證明誰在使用該應用程式。啟動 Postgres 並首先使用資料庫指南執行遷移，然後保持 Web 伺服器執行。開啟http://localhost:3000/auth,選擇電子郵件/密碼註冊，輸入您的姓名、電子郵件和密碼，然後提交。保留 EMAIL_PROVIDER=local 進行第一次測試。

當流程請求電子郵件程式碼時，請在另一個瀏覽器選項卡中開啟 http://localhost:3000/mail-preview，找到該地址的最新訊息並將其程式碼複製回登入表單。如果程式碼過期，請請求新的程式碼。這些訊息保留在本地發件箱中；反覆檢查外部收件箱將找不到它們。登出，然後再次登入以確認資料庫支援的帳戶正常工作。

如果註冊報告資料庫連線或缺少表錯誤，請完成資料庫設定而不是啟用社交登入。 Google、GitHub、Apple、X 和 Microsoft 按鈕需要自己的提供商應用程式和回撥設定；僅在其提供程式指南完成後才啟用它。 Better Auth 是出廠預設引擎，不需要付費身份驗證帳戶即可進行本地電子郵件登入。

[建立賬戶前啟動Postgres](https://supastack.dev/zh-tw/docs/web/database.md)

[電子郵件登入程式碼的使用和故障排除](https://supastack.dev/zh-tw/docs/web/setup-ai.md)

[配置Google登入](https://supastack.dev/zh-tw/docs/web/setup-oauth.md)

[新增 Google 登入](https://supastack.dev/zh-tw/docs/web/google-sign-in.md)

[新增 GitHub 登入](https://supastack.dev/zh-tw/docs/web/github-sign-in.md)


## 選擇啟用的登入方式

基礎包含郵箱/密碼、OTP 與可配置的社交認證。Better Auth 負責身份與會話，應用則組合供應商配置與 OTP 的事務性投遞。

只啟用你已配置的社交供應商。供應商客戶端金鑰與認證金鑰留在服務端。


## 把身份連線到工作區

已認證的 handler 在訪問工作區記錄之前先解析會話狀態。工作區開通必須保持冪等，使重放生命週期鉤子不會建立重複的歸屬記錄。


## 驗證會話行為

測試登入、無效或過期 OTP、一次性消費、退出與匿名訪問拒絕。記憶體介面卡測試覆蓋 handler 語義；生產資料庫持久化與真實供應商回撥需要單獨驗收。


如果你想繼續完成設定，可以閱讀《[設定 AI](https://supastack.dev/zh-tw/docs/web/setup-ai.md)》。


## 下一篇

[計費與訪問](https://supastack.dev/zh-tw/docs/modules/billing.md)