應用程式使用者的登入

你的應用程式內建帳戶系統

在 Kliv 上建置的應用程式有自己的使用者,也就是使用你產品的客戶、會員或團隊成員。每個應用程式從一開始就內建完整的使用者登入系統。你不需要整合驗證服務,也不必自己管理密碼儲存:只要描述誰應該能夠登入,其餘由 Kliv 處理。

有一點要分清楚:本頁談的是你應用程式的使用者。你自己團隊(與你一起在 Kliv 上建置應用程式的人,包括貴組織使用的任何企業 SSO)的登入是另一回事,請參閱使用者管理。

登入方式

你的應用程式的使用者可以透過以下方式登入:

  • 電子郵件與密碼 — 使用已驗證電子郵件地址的傳統帳戶
  • 使用 Google 登入與使用 Facebook 登入 — 用既有帳戶一鍵完成社群登入
  • 密碼金鑰(Passkey,WebAuthn) — 利用裝置的生物辨識或安全金鑰進行無密碼登入
  • 雙重驗證(TOTP) — 以驗證器應用程式產生的限時驗證碼作為第二道步驟

在對話中告訴 Kliv 你的應用程式要提供哪些方式即可。「讓使用者可以用電子郵件或 Google 註冊,並支援密碼金鑰」這樣就夠了。

組織與角色

使用者不必只是一份扁平的清單。你的應用程式的使用者可以隸屬於組織,並在組織內擔任不同角色。這很適合團隊型產品與 B2B 應用程式:一家公司註冊後邀請成員,每個人能做什麼則取決於其角色。描述你需要哪些角色,Kliv 就會幫你設定。

登入與資料存取

登入不只是門口的一道關卡,它還決定每位使用者能接觸到什麼。資料存取遵循資料庫的資料列層級安全規則,因此已登入的使用者只能讀取與寫入這些規則所允許的資料列。資料列層級安全的運作方式請參閱資料庫。

代理也是如此。如果你的應用程式包含代理,使用者的登入狀態會限定代理代表他們可以讀取的範圍:回答某位使用者問題的代理,無法取用該使用者自己看不到的資料列。請參閱代理與你的資料。

使用你自己的 Google 或 Facebook 憑證

使用 Google 和 Facebook 登入時,Kliv 管理的金鑰可以直接使用,你不需要在服務供應商那裡註冊任何東西。使用自己的金鑰是選擇性的:這樣一來,供應商的同意畫面會顯示你的應用程式名稱,而不是 Kliv。

如果使用自己的金鑰,你需要針對訪客登入時使用的每個位址,向供應商註冊一個重新導向 URI:

https://<你的網站位址>/api/v2/auth/oauth/<供應商>/complete

例如:https://example.com/api/v2/auth/oauth/google/complete。每個位址都需要一個:每個自訂網域各一個;如果訪客會使用網站的 <網站代碼>.kliv.site 位址,也要為它註冊一個。會重新導向到主要網域的 www 位址則不需要。

你不必自己組合這些 URI。網站設定 → 社交登入 → 使用你自己的 OAuth 憑證 會列出你網站的確切 URI,每個都附有複製按鈕。

要加在哪裡:

  • **Google:**在 Google Cloud Console 中開啟你的 OAuth 用戶端,將它們新增到「已授權的重新導向 URI」(Authorized redirect URIs)。「已授權的 JavaScript 來源」可以留空。
  • **Facebook:**在你的 Meta 開發者應用程式中開啟 Facebook 登入設定,將它們新增到「有效的 OAuth 重新導向 URI」(Valid OAuth Redirect URIs)。

「使用 Apple 登入」只支援 Kliv 管理的金鑰。

使用自己的金鑰時,預覽位址上無法登入,請在已發布的網站上測試。

相關文件