跳至主要內容

設定 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)」（若尚未編輯回調網址，將顯示為「已啟用 (Enabled)」）
    • 新增授權回調網址：${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取得使用者個人資料 (Get user profile)user/profile
3取得使用者 open_id (Get user open_id)user/openIdV2
1000取得小米路由器資訊 (Get Xiaomi router info)Mi Router
1001存取所有小米路由器資訊 (Access all Xiaomi router info)Mi Router
2001存取小米雲端行事曆 (Access Xiaomi cloud calendar)Mi Cloud
2002存取小米雲端鬧鐘 (Access Xiaomi cloud alarm)Mi Cloud
6000使用米家智慧家庭服務 (Use Mi Home smart home service)Mi Home
6002新增第三方裝置至米家 (Add third-party devices to Mi Home)Mi Home
6003Alexa 控制小米裝置 (Alexa control Xiaomi devices)Mi Home
6004第三方服務存取小米裝置 (Third-party service access to Xiaomi devices)Mi Home
7000關注黃頁服務帳號 (Follow Yellow Pages service account)Mi Cloud
11000取得小米雲端相片 (Get Xiaomi cloud photos)Mi Cloud
12001儲存應用程式資料至小米雲端 (Save app data to Mi Cloud)Mi Cloud
12005使用健康 ECG 服務 (Use health ECG service)Health
16000取得米錢包通行證 (Get Mi Wallet passes)app/get_pass
20000啟用小愛語音服務 (Enable XiaoAI voice service)XiaoAI
40000啟用雲端 AI 服務 (Enable cloud AI service)Internal Use

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

測試小米連接器​

就這樣！別忘了在註冊 / 登入流程中 啟用社交登入 (Enable social sign-in)。

參考資料​

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

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