本文介绍了用户的云端如何与ID²的服务端对接。

本文档适用于通过其他平台接入的IoT设备对接ID²的场景。如果您通过阿里云物联网平台接入IoT设备,那么请忽略此文档。如果您通过阿里云物联网平台接入IoT设备,那么请忽略此文档。

1. 前提条件

准备好AccessKey。您需要在阿里云账号下生成AccessKey,该账号必须与ID²管理控制台、购买ID²授权的账号保持一致。

说明 AccessKey生成请参见文档:AccessKey生成

您需要下载并集成适合您业务平台的服务端SDK:

2. 服务端接口对接

2.1 依赖包安装

参考SDK目录下aliyun-id2-sample/README,安装依赖包。

2.2 服务端接口对接

服务端接口对接请参考服务端API手册,您也可以参考/aliyun-id2-sample中的示例代码。

3. 服务端接口验证(可选)

  • 由于设备端适配还没有完成,您可以通过调试ID²来模拟设备端,配合完成服务端对接的验证。此处建议您使用调试类ID²进行接口验证。
  • 您也可以跳过此步骤,在设备端适配完成后,进行全链路的自主验证
说明 调试类ID²仅限于在“对接调试”阶段使用,不能作为正式的ID²使用。

3.1 生成调试ID²

登录IoT设备身份认证控制台进入“调试服务”-“调试ID²”页面,单击生成调试ID²,获取到的调试ID²如下:

3.2 开启服务端调试

进入服务端调试页面

3.3 获取authCode

服务端调试提供了authCode生成助手,用于模拟设备端生成authCode。您可以此authCode在服务端调用verify接口发起认证请求。

说明 调试ID²归属在固定产品下,产品的ProductKey在图中所示位置获取。

3.3.1 选择ID²

在调试ID²列表中选择一个ID²,单击生成。authCode生成成功,单击复制复制authCode。

3.3.2 验证

使用上一步获取的authCode,在服务端调用 verify 接口。接口返回 code 值为 200 表示服务端接口调试成功。其他code值请参考服务端错误码