簡化 Outline 認證與 Logto
在這篇文章中，我們將示範如何使用 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」部分，輸入以下值：
例如，如果你在 http://localhost:3000 託管 Outline，則該值應為：
點擊底部的「保存更改」按鈕。成功後，保持此頁面打開，因為它對 Outline 配置將很有用。
配置 Outline
按照 Outline 託管指南 中的步驟，直到達到認證配置步驟。由於 Outline 預設支持 OIDC 兼容的認證提供者，你可以在 Logto 應用程序詳情頁面輕鬆找到大部分需要的配置值。
請參考以下表格了解必要的配置詳情：
| Outline 環境變量 | Logto 顯示名稱 |
|---|---|
| OIDC_CLIENT_ID | 應用 ID |
| OIDC_CLIENT_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 伺服器！