一型一密认证方式下,同一产品下所有设备可以烧录相同的设备标志信息,即所有设备包含相同的产品证书(ProductKey和ProductSecret)。设备发送激活请求时,物联网平台会进行身份确认,认证通过后,下发设备接入所需信息。

背景信息

一型一密认证支持两种使用方式:一型一密免预注册、一型一密预注册,对比说明如下表所示。

注意
  • 采用一型一密认证方式,设备烧录相同的标志信息,存在产品证书泄露风险。您可以在物联网平台控制台的产品详情页面,手动关闭动态注册开关,拒绝新设备的认证请求。
  • 一型一密动态注册时必须使用TLS加密,如果您的设备端SDK无法运行TLS加密,则无法使用一型一密认证方式,请采用一机一密认证方式。
对比项 一型一密免预注册 一型一密预注册
接入协议 MQTT协议 HTTP协议、MQTT协议
支持地域 华东2(上海)
  • HTTP协议:除华北2(北京)、华南1(深圳)以外的所有地域。
  • MQTT协议:物联网平台支持的所有地域。
功能特点 不需要在物联网平台预注册设备DeviceName。使用方法,请参见下文“操作步骤”。 需要在物联网平台预注册设备DeviceName。使用方法,请参见下文“操作步骤”。
使用限制 物联网平台允许最多5个物理设备使用同一组ProductKey、ProductSecret、DeviceName进行激活,并为不同物理设备下发不同的ClientID、DeviceToken。
  • 同一组设备证书只能用于激活一个物理设备。

    若DeviceName名下已激活物理设备A,但物理设备B需要使用该DeviceName,则您可以在物联网平台上删除设备A,使设备A的DeviceSecret作废,再使用原DeviceName重新添加设备,激活物理设备B。

  • 若设备因丢失DeviceSecret等原因需要重新激活,需您调用ResetThing接口,重置设备状态为未激活,然后将设备重新联网激活。此时,物联网平台下发的DeviceSecret不变。

使用流程

一型一密认证使用流程示意图如下。

一型一密流程

操作步骤

  1. 创建产品:在物联网平台控制台创建产品。
  2. 开启动态注册:在已创建产品的产品详情页面,开启动态注册开关。
    物联网平台将进行短信验证,以确认是您本人操作。
    说明 若设备发出激活请求时,物联网平台校验发现该开关未开启,将拒绝新设备的动态激活请求。已激活设备不受影响。
    开启动态注册
  3. 可选:批量添加设备单个添加设备:若使用一型一密预注册认证方式接入设备,您需在已创建产品下添加设备。
    因设备激活时会校验DeviceName,建议您采用可以直接从设备中读取到的ID,如设备的MAC地址、IMEI或SN码等,作为DeviceName使用。

    添加设备成功后,物联网平台为设备颁发DeviceSecret。设备初始状态为未激活

  4. 产线烧录:开发设备端SDK,完成产线烧录。
    设备端C SDK开发的详细内容,请参见Link SDK
    1. 下载设备端C SDK
    2. 初始化设备端SDK,开通设备端SDK动态注册。在设备端SDK中,填入产品证书(ProductKey和ProductSecret)。
      具体操作,请参见MQTT动态注册
    3. 根据实际需求,完成设备端SDK开发,如OTA开发、子设备接入、设备物模型开发、设备影子开发等。
      各功能开发方法,请参见Link SDK
    4. 在产线上,将已开发完成的设备SDK烧录至设备中。
  5. 设备联网。
    设备上电联网后,携带ProductKey、ProductSecret、DeviceName发起认证请求。请参见基于MQTT通道的设备动态注册基于HTTP通道的设备动态注册
  6. 物联网平台激活设备。
    • 一型一密预注册:物联网平台校验通过后,为实际物理设备下发步骤3中为该设备颁发的DeviceSecret。至此,物理设备获得连接物联网平台所需的设备证书(ProductKey、DeviceName和DeviceSecret),可以与物联网平台建立连接,进行数据通信。
    • 一型一密免预注册:物联网平台校验通过后,下发ClientID、DeviceToken。设备后续通过ProductKey、ProductSecret和下发的ClientID、DeviceToken与物联网平台建立连接,进行数据通信。

      当多个不同ClientID的物理设备共用一个DeviceName时,物联网平台控制台产品详情页将提示当前产品下有设备同时有两个ClientID。您可根据以下操作,指定保留唯一物理设备,或清除所有物理设备:

      1. 产品详情页,单击该提示后的查看,跳转到产品下的风险设备列表。
      2. 设备管理 > 设备,单击列表中设备对应的查看,进入设备详情页,页面显示当前连接的ClientID,单击ClientID右侧的切换清除
        • 切换:从下拉列表选择ClientID,通过该ClientID对应设备的首次连接时间,或者单击日志服务,通过该ClientID对应设备的云端运行日志,判断其是否为需要保留的物理设备。选择要保留的物理设备的ClientID,单击确认。未被选择的ClientID对应物理设备,将被禁止连接。

          有关云端运行日志说明,请参见云端运行日志

        • 清除:所有物理设备都将被禁止连接。