基础技术授权说明

本文档主要介绍:当您在接入思必驰提供的SDK或者API时,如何在控制台完成相关授权参数配置。

如何访问产品授权管理页面?

如果您是在思必驰开放平台创建的基础技术产品,授权管理的入口如下图所示:

如果您是在DUI开放平台创建的全链路产品,授权管理的入口如下图所示:

授权管理

授权管理页面如下图所示,您可以按照接入类型完成相关授权配置;若按设备数授权,也可查看当前产品的设备激活情况;

若您使用的是旧版授权管理页面,请查看文档

接入SDK

所需授权参数如下:

字段 定义
Product ID 创建产品时产生
Product Key和Product Secret 在产品创建完成后,生成一对产品密钥(Product Key和Product Secret),在SDK初始化时需要传入,目前仅在设备注册的情况下使用;
APIKEY

授权时,针对客户端唯一性标识绑定APIKEY,在SDK初始化时需要传入;

鉴权时,通过检查APIKey与绑定的唯一性标识信息是否一致作为鉴权成功的依据;

您需要按照对应的操作系统提供相关信息完成绑定(嵌入式/windows系统无需绑定APIKEY):

Android

通过正式版SHA256、开发板SHA256、package绑定APIKEY,具体操作如下图所示:

iOS

通过bundleID绑定APIKEY,具体操作如下:

如果您的设备在接入时需要支持离线场景、限制特定设备才能激活,可以使用设备授权的高级配置来实现;

设备授权高级配置支持预烧录和预登记;

预烧录

预烧录全称为预烧录设备授权证书模式,即设备出厂前需要将设备的授权证书烧录到设备的永久存储区。

适用于设备出厂前不方便联网,但需要离线激活设备的场景;可以通过在控制台上传设备标识生成授权证书,再烧录到设备的永久存储空间即可激活设备。

具体操作如下:

步骤一:选择需要设备授权高级配置;

步骤二:选择申请预烧录,提前准备好设备标识文件,需注意文件里的设备标识数量需≤当前产品可激活的设备数量,若可用量不足时请联系商务申请;

步骤三:上传设备标识文件;

文件需满足:

  • 格式仅支持txt;
  • 文件里的MAC地址不可重复;若无MAC地址,请联系商务定制开发SDK;
  • 需在原始MAC地址的基础上去除冒号;
  • 文件里每行只能有一个MAC地址;

步骤四:下载生成好的预烧录文件;

预登记

预登记的全称为预先登记设备标识模式,即在授权前先将产品下的设备标识在控制台上进行登记;授权时,通过检查设备信息是否已经登记决定是否授权。

步骤一:选择需要设备授权高级配置;

步骤二:启用设备白名单;

步骤三:上传设备标识,提交即可;

接入API

所需授权参数如下:

字段 定义
Product ID 创建产品时产生
APIKEY

授权时,针对客户端唯一性标识绑定APIKEY,在SDK初始化时需要传入;

鉴权时,通过检查APIKey与绑定的唯一性标识信息是否一致作为鉴权成功的依据;

您需要通过登记公网IP绑定,具体操作如下:

步骤一:选择接入API;

步骤二:登记公网IP,提交即可生成APIKEY;

提示:

1.IP白名单支持多条,可以填写子网掩码长度模糊匹配网段;

2.输入的IP地址为申请服务的机器IP地址,且必须为外网IP,可以访问 https://ip.sb/获取外网IP地址。如果是Linux 或者 macOSX 的系统,或者没有 GUI 的服务器,可以使用 curl myip.ipip.net 这个指令获取到自身的外网 IP;

3.若无需IP限制,可填写:0.0.0.0/0;