检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
内部函数 使用说明 华为云IoTDA提供了多个内部函数供用户在模板中使用,使用时请认真阅读每个函数的功能定义,包括入参类型,参数长度,返回值类型等。 整个函数必须是合法的Json格式。 函数中可使用${}变量占位符或者"Ref"函数引用入参定义的参数值。 函数所使用的参数必须在模板参数中声明。
单击“保存并测试”,查看函数运行结果,确认函数逻辑的正确性。 日志显示,已调用了发放设备接口,函数主要逻辑正确。至此,您已完成自定义策略函数的编写,可进行后续步骤。 后续操作 完成自定义策略函数的编写后,创建关联该函数的自定义策略实例以及设备或注册组,通过设备南向操作触发函数,将设备发放到指定目的接入点(设备接入实例)。
使用证书认证的设备采用自定义策略发放设备操作流程如下图所示。 通过自定义策略发放设备功能流程图如下图所示。 函数开发 自定义策略的函数代码编写指南参见创建自定义策略函数。 此处以Java语言为例,如何编写Java语言的函数,参见函数工作流 FunctionGraph > 开发指南> 如何开发函数>
创建自定义鉴权 功能介绍 应用服务器可调用此接口在物联网平台创建一个自定义鉴权。自定义鉴权是指用户可以通过函数服务自定义实现鉴权逻辑,以对接入平台的设备进行身份认证。 单个实例最大可配置10个自定义鉴权 仅标准版实例、企业版实例支持该接口调用,基础版不支持。 调用方法 请参见如何调用API。
自定义鉴权概述 概述 自定义鉴权是指用户可以通过函数服务自定义实现鉴权逻辑,以对接入平台的设备进行身份认证。 在设备接入物联网平台前,用户可以通过应用服务调用控制台配置自定义鉴权信息,然后通过调用函数服务(FunctionGraph)配置自定义鉴权函数。在设备接入物联网平台时,物
参数说明:自定义鉴权器名称,同一租户下的自定义鉴权器名称不能重复。 取值范围:长度不超过128,只允许字母、数字、下划线(_)、连接符(-)的组合。 func_urn 否 String 参数说明:函数的URN(Uniform Resource Name),唯一标识函数,即自定义鉴权器对应的处理函数地址。
使用模板鉴权时,鉴权参数username不能与自定义函数鉴权username格式重叠,否则会使用自定义函数鉴权,比如: {deviceId}|authorizer-name={authorizer-name}|xxx 自定义模板鉴权优先级高于平台默认鉴权,即激活自定义鉴权模板后设备就会使用模板鉴权,不会再使用平台默认鉴权方式。
自定义鉴权使用说明 使用说明 图1 自定义鉴权操作流程 操作步骤 配置自定义鉴权函数:用户通过调用函数服务(FunctionGraph)创建自定义鉴权函数。 图2 函数列表-创建函数 图3 创建函数-参数信息 创建自定义鉴权:用户可以通过Console配置自定义鉴权信息,IoTD
自定义模板鉴权使用说明 使用说明 图1 自定义模板鉴权流程图 操作步骤 创建鉴权模板:进入设备接入控制台左侧导航栏,选择“设备 > 自定义鉴权”,单击“自定义模板”,单击“创建鉴权模板”。本示例演示使用的鉴权模板与系统默认鉴权一致。 图2 自定义鉴权-创建鉴权模板 模板整体内容如下:
组合。 function_id String 参数说明:函数ID,产品配置函数后生成的唯一标识。 取值范围:长度不超过36,只允许字母、数字、下划线(_)、连接符(-)的组合。 urn String 参数说明:产品关联函数的URN(Uniform Resource Name)。
自定义Topic通信 自定义Topic通信概述 $oc开头自定义Topic通信使用说明 非$oc开头自定义Topic通信使用说明 父主题: 消息通信
自定义模板示例 示例1 证书认证设备,不限制UserName与ClientId参数取值,从设备证书通用名称(Common Name)中取值设备ID。 表1 鉴权参数 参数 说明 Client ID 任意值 User Name 任意值 Password 空值 鉴权模板: { "template_name":
String 参数说明:函数的URN(Uniform Resource Name),唯一标识函数,即自定义鉴权器对应的处理函数地址。 signing_enable Boolean 参数说明:是否启动签名校验,启动签名校验后不满足签名要求的鉴权信息将被拒绝,以减少无效的函数调用。推荐用户进行安全的签名校验,默认开启。
参数说明:自定义鉴权器名称,同一租户下的自定义鉴权器名称不能重复。 取值范围:长度不超过128,只允许字母、数字、下划线(_)、连接符(-)的组合。 func_name String 参数说明:自定义鉴权器对应的函数名称。 func_urn String 参数说明:函数的URN(Uniform
删除自定义鉴权 功能介绍 应用服务器可调用此接口在物联网平台上删除指定自定义鉴权。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/device-authorizers/{authorizer_id} 表1 路径参数 参数 是否必选
非$oc开头自定义Topic通信使用说明 使用流程&操作步骤 图1 非$oc开头自定义topic通信 为了适配新老客户的使用,策略默认放通所有“非$oc开头的自定义Topic通信”。新增的资源空间会默认加入策略“system_default_policy”,system_defa
单击“确定”,完成新增自定义Topic。自定义Topic添加成功后,您可以在自定义Topic列表执行修改和删除操作。 创建设备:在该产品下创建设备。创建的设备将继承产品设定的自定义Topic。详情可见:创建设备流程。 设备订阅/发布:查看使用自定义Topic进行通信的最佳实践,了解自定义Topic的发布与订阅的使用。
组合。 function_id String 参数说明:函数ID,产品配置函数后生成的唯一标识。 取值范围:长度不超过36,只允许字母、数字、下划线(_)、连接符(-)的组合。 urn String 参数说明:产品关联函数的URN(Uniform Resource Name)。
定义。 消息上报、属性上报、命令下发、事件类主题。 自定义Topic 用户可以自定义Topic,设备和平台间可以基于用户自定义的Topic进行通信。 自定义topic分类: $oc开头的自定义Topic:在产品中定义需要使用的Topic,这类Topic有$oc/devices/{
删除编解码函数 功能介绍 提供删除编解码函数的功能。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/product-functions/{function_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id