For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/modules/auth.md (or send Accept: text/markdown).
身份認證模組
通過 Better Auth 的身份與會話。
建立並驗證真實賬戶
身份驗證意味著證明誰在使用該應用程式。啟動 Postgres 並首先使用資料庫指南執行遷移，然後保持 Web 伺服器執行。開啟http://localhost:3000/auth,選擇電子郵件/密碼註冊，輸入您的姓名、電子郵件和密碼，然後提交。保留 EMAIL_PROVIDER=local 進行第一次測試。
當流程請求電子郵件程式碼時，請在另一個瀏覽器選項卡中開啟 http://localhost:3000/mail-preview，找到該地址的最新訊息並將其程式碼複製回登入表單。如果程式碼過期，請請求新的程式碼。這些訊息保留在本地發件箱中；反覆檢查外部收件箱將找不到它們。登出，然後再次登入以確認資料庫支援的帳戶正常工作。
如果註冊報告資料庫連線或缺少表錯誤，請完成資料庫設定而不是啟用社交登入。 Google、GitHub、Apple、X 和 Microsoft 按鈕需要自己的提供商應用程式和回撥設定；僅在其提供程式指南完成後才啟用它。 Better Auth 是出廠預設引擎，不需要付費身份驗證帳戶即可進行本地電子郵件登入。
選擇啟用的登入方式
基礎包含郵箱/密碼、OTP 與可配置的社交認證。Better Auth 負責身份與會話，應用則組合供應商配置與 OTP 的事務性投遞。
只啟用你已配置的社交供應商。供應商客戶端金鑰與認證金鑰留在服務端。
把身份連線到工作區
已認證的 handler 在訪問工作區記錄之前先解析會話狀態。工作區開通必須保持冪等，使重放生命週期鉤子不會建立重複的歸屬記錄。
驗證會話行為
測試登入、無效或過期 OTP、一次性消費、退出與匿名訪問拒絕。記憶體介面卡測試覆蓋 handler 語義；生產資料庫持久化與真實供應商回撥需要單獨驗收。