跳至主要內容

設定 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. 從應用程式詳細頁取得 AppIDAppSecret
  4. 將步驟 3 取得的值填入 Logto Console 的 clientIdclientSecret 欄位
  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)