簡化使用 Logto 進行 Outline 身份驗證
在本文中，我們將演示如何使用 Logto 作為 Outline 的 OpenID Connect (OIDC) 身份提供者。
Founder
介紹
- Logto 是一個簡單的身份解決方案，具備你所需的所有功能。它支持多種登入方式，包括用戶名、電子郵件、電話號碼和流行的社交登入如 Google 和 GitHub。
- Outline 是一個為成長中的團隊服務的知識庫。
最棒的是，Logto 和 Outline 都是開源的。在本文中，我們將演示如何使用 Logto 作為 Outline 的 OpenID Connect (OIDC) 身份提供者。
先決條件
首先，確保你具備以下條件：
- 一個運行中的 Logto 實例或 Logto Cloud 帳戶訪問權限。
- 一個具有環境變量存取權的 Outline 託管環境。
配置 Logto
如果你自我託管 Logto，請參閱 Logto 的「入門指南」文檔設置你的 Logto 實例。
如果你使用 Logto Cloud，請透過輸入 URL https://cloud.logto.io/ 打開 Logto 控制台，或者輸入你設置的自我託管端點。
接下來，導航到「應用程序」標籤並點擊「創建應用程序」。
在出現的模態框中，選擇「傳統網頁」，並提供一個應用程序名稱，例如「Outline」。然後點擊「創建應用程序」。
你將被定向到 Logto 的教程頁面。點擊右上角的「跳過」以進入應用程序詳細信息頁面。
在「重定向 URI」部分，輸入以下值：
例如，如果你將 Outline 託管在 http://localhost:3000，則值應為：
點擊底部的「保存變更」按鈕。成功後，保持此頁面打開，因為它對 Outline 配置很有用。
配置 Outline
遵循 Outline 託管指南 中的步驟，直到到達身份驗證配置步驟。由於 Outline 默認支持 OIDC 兼容身份驗證提供者，你可以輕鬆在 Logto 應用程序詳情頁面找到大部分所需的配置值。
請參考下表來獲取必要的配置詳情：
| Outline 環境變量 | Logto 顯示名稱 |
|---|---|
| OIDC_CLIENT_ID | App ID |
| OIDC_CLIENT_SECRET | App Secret |
| OIDC_AUTH_URI | 授權端點 |
| OIDC_TOKEN_URI | 令牌端點 |
| OIDC_USERINFO_URI | 使用者信息端點 |
這是另一個包含額外變量的表：
| Outline 環境變量 | 描述 |
|---|---|
| OIDC_USERNAME_CLAIM | 設置為用戶名 |
| OIDC_DISPLAY_NAME | 可選 - 根據需要自定義 |
| OIDC_SCOPES | 保持默認；無需設定 |
僅限自我託管：在 Logto 中配置電子郵件登入
由於 Outline 需要提供使用者的電子郵件，因此你需要配置電子郵件登入或提供可靠電子郵件地址的社交登入，如 Google 登入。
參見 配置連接器 以了解有關在 Logto 中配置連接器的更多信息。
檢查站：測試 Logto 和 Outline 集成
啟動 Outline 實例並訪問其端點。你應該看到中心有一個標記為「繼續使用 OpenID Connect」的按鈕；可以通過設置 OIDC_DISPLAY_NAME 環境變量進行自定義。
點擊按鈕，然後你將被帶到 Logto 登入體驗。
如果一切配置正確，當你在 Logto 完成登入或註冊過程後，你將被重新導向回 Outline。然後你可以在頁面左下角看到你的個人信息。
如果在整合過程中遇到任何問題，請隨時通過電子郵件 [email protected] 聯繫我們或 加入我們的 Discord 伺服器！