在這篇文章中，我們將示範如何使用 Logto 作為 Outline 的 OpenID Connect (OIDC) 身份提供者。
最好的部分是 Logto 和 Outline 都是開源的。在這篇文章中，我們將示範如何使用 Logto 作為 Outline 的 OpenID Connect (OIDC) 身份提供者。
開始之前，請確保你擁有以下資源：
如果你自行託管 Logto，請參閱 Logto 的「入門指南」文檔設置你的 Logto 實例。
如果使用 Logto Cloud，請透過輸入 URL https://cloud.logto.io/ 開啟 Logto 主控台，或輸入你為自行託管設置的端點。
接下來，導航到「應用程序」選項卡並點擊「創建應用程序」。
在出現的模態中，選擇「傳統網站」並提供應用程序名稱，如「Outline」。然後點擊「創建應用程序」。
你將被引導到 Logto 的教學頁面。在右上角點擊「跳過」以繼續前往應用程序詳情頁面。
在「重定向 URI」部分，輸入以下值：
例如，如果你在 http://localhost:3000 託管 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 | 保持默認值；無需設置 |
由於 Outline 需要提供用戶的電郵，你需要配置電郵登入或提供可信賴電郵地址的社會登入，如 Google 登入。
請參見 配置連接器 了解更多有關在 Logto 中配置連接器的信息。
啟動 Outline 實例並訪問其端點。你應該會看到中心有一個標有「繼續使用 OpenID Connect」的按鈕；可以通過設置 OIDC_DISPLAY_NAME 環境變量自定義。
點擊按鈕，你將被引導到 Logto 的登入體驗。
如果一切配置正確，當你在 Logto 完成登入或註冊過程後，你將被重定向回 Outline。然後你可以在頁面的左下角看到你的個人信息。
如果在集成過程中遇到任何問題，請隨時通過電郵 [email protected] 聯繫我們或加入我們的 Discord 伺服器！