跳至主要內容

設定 Xiaomi 社交登入 (Set up social login with Xiaomi)

Logto 官方提供的 Xiaomi 社交登入連接器。

提示:

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

開始使用​

  1. 前往 小米開放平台 (Xiaomi Open Platform) 建立開發者帳號
  2. 訪問 小米帳號服務 (Xiaomi Account Service)
  3. 若尚未建立應用程式，請新增一個應用程式

設定小米 OAuth 應用程式​

  1. 訪問 小米帳號服務 (Xiaomi Account Service)
  2. 設定 OAuth 相關資訊：
    • 開啟你要用於登入的應用程式，點擊「Callback URL」（若尚未編輯 callback URL，會顯示為「已啟用」）
    • 新增授權 callback URL：${your_logto_origin}/callback/${connector_id}
    • connector_id 可在 Logto Console 連接器詳細頁面頂部找到
  3. 從應用程式詳細頁取得 AppID 與 AppSecret
  4. 將步驟 3 取得的值填入 Logto Console 的 clientId 與 clientSecret 欄位
  5. 可選設定：
    • skipConfirm：當使用者已登入小米帳號時，是否略過小米授權確認頁，預設為 false

權限範圍 (Scopes) 說明​

預設情況下，連接器會請求以下權限範圍 (scope)：

  • 1：讀取使用者個人資料

可用權限範圍如下：

權限範圍值 (Scope Value)說明 (Description)API 介面 (API Interface)
1取得使用者個人資料user/profile
3取得使用者 open_iduser/openIdV2
1000取得小米路由器資訊Mi Router
1001存取所有小米路由器資訊Mi Router
2001存取小米雲端行事曆Mi Cloud
2002存取小米雲端鬧鐘Mi Cloud
6000使用米家智慧家庭服務Mi Home
6002新增第三方裝置至米家Mi Home
6003Alexa 控制小米裝置Mi Home
6004第三方服務存取小米裝置Mi Home
7000關注黃頁服務帳號Mi Cloud
11000取得小米雲端相片Mi Cloud
12001儲存應用程式資料至小米雲端Mi Cloud
12005使用健康 ECG 服務Health
16000取得米錢包通行證app/get_pass
20000啟用小愛語音服務XiaoAI
40000啟用雲端 AI 服務Internal Use

多個權限範圍可用空格分隔設定，例如：1 3 6000。

測試小米連接器​

就是這麼簡單。別忘了在登入體驗中 啟用社交登入 (Enable social sign-in)。

參考資料​

小米 OAuth 2.0 文件 (Xiaomi OAuth 2.0 Documentation)

小米取得使用者資料文件 (Xiaomi Get User Profile Documentation)