一、准入条件

• 接入小米账号服务前，请先完成如下准备工作：

1.成为开发者

1.1 创建快应用

• 创建成功后，在应用详情页获取AppID，此ID将在后续账号服务中作为关键凭证

2. 启用小米账号服务

2.1 授权登录进入账号服务

• 在开发者站->管理中心左侧导航栏选择「账号服务」

2.2 启用账号服务

• 在小米账号未接入服务模块中找到已创建的快应用，点击需要开通服务的应用，进入账号接入服务页面

• 点击「立即启用」按钮

2.3 填写回调地址

• 填写回调地址以启用服务。

• 什么是回调地址？

OAuth2.0 是一类基于回调的授权协议，授权服务器借助回调地址以 302 跳转形式将下发的授权码传递到您服务的相关接口，在保护您用户安全访问的同时，也保护了授权服务器的安全。一个好的回调地址设置应该是能够将下发的授权码送达到您的服务端接口，以便接下来通过授权码请求下发访问令牌，您在填写回调地址时需要注意以下事项：

1. 填写的地址必须符合 URI 规范，填写后可以修改
2. 您可以配置多个回调地址，多个回调地址请用半角分号“;”分隔，比如 https://mi.com/;https://id.mi.com/
3. HTTP 和 HTTPS 视为不同域，比如 http://mi.com/ 和 https://mi.com/ 需要分别填写
4. 不同的端口视为不同域，比如 https://www.mi.com 和 https://www.mi.com:8080 需要分别填写
5. 请求传递的参数 redirect_uri，其域名部分可以是注册时填写的回调地址的同级或子域名，路径部分可以是同级或子路径，但是 SCHEME 和端口号必须相同

• 回调地址示例：

假设您申请时填写的回调地址是：https://abc.com/oauth，那么 redirect_uri 的参数可以是：

https://abc.com/oauth?x=1&y=2
https://x.abc.com/oauth?x=1&y=2
https://x.abc.com/oauth/path?x=1&y=2

不可以是：

http://abc.com/oauth?x=1&y=2  // SCHEME 不匹配
https://abc.com:8080/oauth?x=1&y=2  // 端口号不匹配

3.一键登录

3.1 启用账号服务

1. 若您曾经开通过授权登录服务，则无需进行操作，直接进入【3.2 启用一键登录】步骤。
2. 若您未曾开通过授权登录服务，需要先开通授权登录服务，详细步骤同【2.1 授权登录进入账号服务】。

3.2 启用一键登录

• 登录小米开放平台，左侧导航栏选 “开放服务”

• 在未启用服务模块中找到 「一键登录服务」并点击，即可进入到一键登录服务页面，按页面步骤提示即可启用该服务

a.开始启用服务：若确定启用该服务，请点击 启用服务按钮，点击后即进入信息填写页面

b.填写信息：依据页面信息填写要求完成信息填写，填写完成后，点击底部 “提交”按钮。

c.等待信息审核 ：提交后自动进入“信息审核”页，预计2个工作日审核完成。

注：审核通过则进入下一步；驳回则按提示修改后 “重新申请”

d.添加证书指纹 ：审核通过后，进入“添加证书指纹”环节

• 点击 “前往添加”按钮，即可跳转至「添加证书指纹页」

• 在“应用证书指纹”页，依据页面提示上传证书指纹，点击 #保存 按钮，即可提交

e.服务启用成功：添加指纹后自动进入“服务接入”页，显示 “服务状态：成功启用服务”，在此页面支持查看服务状态、停用服务，查看接入指南文档，查看及更改联系人信息