0
Fork 0
mirror of https://github.com/logto-io/logto.git synced 2025-02-03 21:48:55 -05:00
logto/packages/connectors/connector-xiaomi/README.zh-CN.md

72 lines
2.9 KiB
Markdown
Raw Normal View History

# 小米社交连接器
小米社交登录 Logto 官方连接器 [中文文档](#小米社交连接器)
**目录**
- [小米社交连接器](#小米社交连接器)
- [开始上手](#开始上手)
- [配置小米 OAuth 应用](#配置小米-oauth-应用)
- [权限范围说明](#权限范围说明)
- [测试小米连接器](#测试小米连接器)
- [参考](#参考)
小米是一家全球知名的科技公司,提供包括智能手机、智能家居等在内的多种产品和服务。本连接器可以帮助终端用户使用小米账号登录你的应用。
## 开始上手
1. 在[小米开放平台](https://dev.mi.com/)创建开发者账号
2. 访问[小米帐号服务](https://dev.mi.com/passport/oauth2/applist)
3. 创建一个新应用(如果还没有)
## 配置小米 OAuth 应用
1. 访问[小米帐号服务](https://dev.mi.com/passport/oauth2/applist)
2. 配置 OAuth 设置:
- 打开要用于登录的应用,点击「回调地址」(如果没有编辑过回调地址,会显示为「启用」)
- 添加授权回调地址: `${your_logto_origin}/callback/${connector_id}`
- `connector_id` 可以在 Logto 管理控制台连接器详情页顶部找到
3. 从应用详情页获取 `AppID``AppSecret`
4. 将第 3 步获取的值填入 Logto 管理控制台的 `clientId``clientSecret` 字段
5. 可选配置:
- `skipConfirm`: 在用户已登录小米账号的情况下,是否跳过小米授权确认页面,默认为 false
## 权限范围说明
默认情况下,连接器请求以下权限:
- `1`: 读取用户资料
可配置的权限范围:
| 权限值 | 描述 | API 接口 |
|-------|------|----------|
| 1 | 获取用户资料 | user/profile |
| 3 | 获取用户 open_id | user/openIdV2 |
| 1000 | 获取小米路由器信息 | 路由器 |
| 1001 | 访问所有小米路由器信息 | 路由器 |
| 2001 | 访问小米云日历 | 小米云 |
| 2002 | 访问小米云闹钟 | 小米云 |
| 6000 | 使用米家智能家居服务 | 米家 |
| 6002 | 添加第三方设备到米家 | 米家 |
| 6003 | Alexa 控制小米设备 | 米家 |
| 6004 | 第三方服务访问小米设备 | 米家 |
| 7000 | 关注黄页服务号 | 小米云 |
| 11000 | 获取小米云相册 | 小米云 |
| 12001 | 保存应用数据到小米云 | 小米云 |
| 12005 | 使用健康心电图服务 | 健康 |
| 16000 | 获取小米卡包卡券 | app/get_pass |
| 20000 | 启用小爱智能语音服务 | 小爱 |
| 40000 | 启用云端 AI 服务 | 内部使用 |
可以通过空格分隔配置多个权限范围,例如: `1 3 6000`
## 测试小米连接器
大功告成!别忘了在[登录体验](https://docs.logto.io/zh-CN/connectors/social-connectors#enable-social-sign-in)中启用该连接器。
## 参考
- [小米 OAuth 2.0 文档](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1708)
- [小米获取用户信息文档](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1517)