設定 GitHub 社交登入

Logto 的 GitHub 社交登入官方連接器。

提示:

本指南假設你已對 Logto 連接器 (Connectors) 有基本了解。若不熟悉，請參閱 連接器 (Connectors) 指南以開始使用。

開始使用

GitHub 連接器使終端使用者能夠透過 GitHub OAuth 2.0 驗證協議，使用他們自己的 GitHub 帳戶登入你的應用程式。

使用 GitHub 帳戶登入

前往 GitHub 網站並使用你的 GitHub 帳戶登入。如果你還沒有帳戶，可以註冊一個新帳戶。

建立並配置 OAuth 應用程式

按照 建立 OAuth 應用程式 指南，註冊一個新應用程式。

在 Application name 中命名你的新 OAuth 應用程式，並填寫應用程式的 Homepage URL。你可以將 Application description 欄位留空，並將 Authorization callback URL 自訂為 ${your_logto_origin}/callback/${connector_id}。connector_id 可以在 Logto 管理控制台連接器詳細資訊頁面的頂部欄位找到。

備註:

如果在登入時遇到錯誤訊息「The redirect_uri MUST match the registered callback URL for this application.」，請嘗試對齊 GitHub OAuth 應用程式的 Authorization Callback URL 與 Logto 應用程式的重定向 URL（當然，包括協議）來解決問題。

我們建議不要勾選 Enable Device Flow 前的方框，否則在行動裝置上使用 GitHub 登入的使用者必須在 GitHub 應用程式中確認初始登入操作。許多 GitHub 使用者並未在手機上安裝 GitHub 行動應用程式，這可能會阻礙登入流程。如果你希望終端使用者確認他們的登入流程，請忽略我們的建議。詳情請參閱 device flow。

管理 OAuth 應用程式

前往 OAuth Apps 頁面，你可以新增、編輯或刪除現有的 OAuth 應用程式。 你也可以在 OAuth 應用程式詳細資訊頁面中找到 Client ID 並生成 Client secrets。

配置你的連接器

在前一節提到的 OAuth 應用程式詳細資訊頁面中，填寫 clientId 和 clientSecret 欄位，使用獲得的 Client ID 和 Client Secret。

scope 是一個以空格分隔的 scopes 列表。如果未提供，scope 預設為 read:user。

配置類型

名稱	類型
clientId	string
clientSecret	string
scope	string

測試 GitHub 連接器

就是這樣。GitHub 連接器現在應該可用了。別忘了 在登入體驗中啟用社交連接器。

參考資料

GitHub - 開發者 - 應用程式

GitHub - 開發者 - 應用程式 - 建立 OAuth 應用程式