跳至主要內容

自訂登入體驗錯誤頁面

在登入流程中,終端使用者有時可能會看到預設的錯誤頁面。常見情境包括:

  • 工作階段過期:使用者登入花費過久,導致工作階段逾時。
  • 直接造訪登入網址:使用者開啟書籤或分享 /sign-in 網址(繞過正常登入按鈕)。
  • 不存在的路徑:使用者導向到驗證流程中不存在的路徑。
  • 社交登入回呼問題:在社交回呼頁面找不到社交工作階段。
  • 無效的一次性連結(magic link)一次性權杖 (one-time token, magic link)(如組織邀請或無密碼登入)已過期或已被使用。

預設情況下,Logto 會在這些情境下顯示通用錯誤頁面(例如 404「未知工作階段」頁面)。為了提升使用者遇到錯誤時的體驗,你需要設定以下參數:

  • 未知工作階段重新導向網址 (Unknown session redirect URL):當找不到工作階段時,將使用者導向的備援網址。
  • 支援電子郵件與支援網站 (Support email & Support website):顯示於錯誤頁面的聯絡資訊。

未知工作階段重新導向網址 (Unknown session redirect URL)

Logto 採用 OpenID Connect (OIDC) 流程進行驗證 (Authentication)。有效的 OIDC 授權流程必須由你的應用程式啟動,例如,點擊應用程式的「登入」按鈕會向 Logto 發送 OIDC 授權請求,進而建立安全的工作階段(cookie)。

然而,若使用者直接存取 /sign-in,繞過工作階段驗證,則在以下情況會出現「未知工作階段」404 錯誤:

  • 工作階段過期
  • 使用者將登入連結加入書籤或分享
  • 缺少授權上下文

為了解決這個問題,Logto 新增了 unknownSessionRedirectUrl 設定。當你設定此網址後,Logto 會自動將使用者重新導向到指定頁面,以重新啟動新的登入流程,而不是顯示 404 錯誤。

設定方式:

  1. 前往 主控台 > 登入體驗 > 註冊與登入 > 進階設定
  2. 將「未知工作階段重新導向網址」設為你的服務首頁或產品首頁。例如,Logto Cloud 會設為 "https://cloud.logto.io"。

支援聯絡資訊 (Support contact info)

若發生其他錯誤(如造訪無效路徑、社交回呼找不到工作階段、或開啟過期的一次性連結),Logto 會顯示預設錯誤頁面。為協助使用者,你可以在這些無法避免的錯誤頁面上顯示聯絡資訊。

驗證 (Authentication) 錯誤頁面與支援聯絡資訊

設定方式:

  1. 前往 主控台 > 登入體驗 > 內容 > 支援
  2. 設定你的支援電子郵件地址
  3. 設定你的支援或官方網站網址

這樣即使發生問題,使用者也能清楚知道如何取得協助。