使用 Logto 構建 SvelteKit 身份驗證
學習如何通過整合 Logto SDK,在 SvelteKit 中構建用戶身份驗證流程。
開始
簡介
- Logto 是一個開源的 Auth0 替代方案,用於構建身份基礎設施。它支持各種登入方式,包括使用者名稱、電子郵件、電話號碼和流行的社群登入,例如 Google 和 GitHub。
- SvelteKit 是一個用於快速開發可靠、高性能 Web 應用程式的框架,使用 Svelte。
在本教程中,我們將向你展示如何通過整合 Logto SDK 來使用 SvelteKit 構建使用者身份驗證流程。教程使用 TypeScript 作為程式語言。
先決條件
在開始之前,請確保你具備以下條件:
- 一個 Logto 帳戶。如果你還沒有,可以 免費註冊。
- A SvelteKit 開發環境和一個專案。
創建一個 Logto 應用程式
要開始,請創建一個類型為 "傳統 Web" 的 Logto 應用程式。按照以下步驟創建 Logto 應用程式:
- 登入到 Logto 控制台。
- 在左側導航欄中,點擊 應用程式。
- 點擊 創建應用程式。
- 在打開的頁面中,找到 "傳統 Web" 部分並定位到 "SvelteKit" 卡片。
- 點擊 開始構建,輸入你的應用程式名稱。
- 點擊 創建。
然後你應該會看到一個互動指南,指導你如何將 Logto SDK 整合到你的 SvelteKit 應用程式中。以下內容可以作為未來的參考。
整合 Logto SDK
安裝
通過你喜愛的套件管理器安裝 Logto SDK:
添加 Logto 鉤子
在你的 hooks.server.ts
文件中,添加以下代碼將 Logto 鉤子注入到你的伺服器中:
由於這些信息是敏感的,建議使用環境變量:
如果你有多個鉤子,可以使用 the sequence() helper 函數 來將它們鏈接起來:
現在你可以在 locals
對象中訪問 Logto 客戶端。對於 TypeScript,你可以將類型添加到 app.d.ts
:
我們稍後會討論 user
對象。
實現登錄和登出
配置重定向 URI
切換到 Logto 控制台的應用程式詳細資料頁面。添加一個重定向 URI http://localhost:3000/callback
。
重定向 URI 是 OAuth 2.0 的概念,表示身份驗證後應重定向的位置。
同樣,將 http://localhost:3000/
添加到 "登出後重定向 URI" 部分。
登出後重定向 URI 是 OAuth 2.0 的概念,表示登出後應重定向的位置。
然後點擊 "保存" 來保存更改。
回到你的應用程式,在你希望實現登錄和登出的頁面中,定義以下操作:
然後在你的 Svelte 組件中使用這些操作:
顯示用戶信息
要顯示用戶的信息,你可以將 locals.user
對象注入到版面中,從而使其在所有頁面中可用:
在你的 Svelte 組件中:
檢查點:運行應用程式
現在你可以運行應用程式並嘗試使用 Logto 登入/登出:
- 在瀏覽器中打開應用程式,你應該會看到 "登入" 按鈕。
- 點擊 "登入" 按鈕,你應該會被重 定向到 Logto 登入頁面。
- 登入後,你應該會被重定向回應用程式,並且你應該會看到使用者數據和 "登出" 按鈕。
- 點擊 "登出" 按鈕,你應該會被重定向到 Logto 登出頁面,然後被重定向回應用程式,處於未登入狀態。
如果在整合過程中遇到任何問題,請隨時 加入我們的 Discord 伺服器 與社群和 Logto 團隊聊天!