阿里云物联网平台：创建云网关产品（MQTT）

添加云网关

1. 登录物联网平台控制台。

2. 在实例概览页面，单击目标尊享型实例。

3. 在左侧导航栏，选择设备管理 > 云网关，单击添加云网关。

4. 配置基本信息，然后单击下一步。

   参数	说明
   云网关名称	为云网关命名。名称在实例内需具有唯一性。支持中文、英文字母、日文、数字、下划线（_），长度限制4~30个字符，一个中文或日文占2个字符。
   协议	选择MQTT。
   自定义端口号	取值范围为1024～65535。默认端口号为1883。
   是否开启数据解析	选择云网关设备是否开启数据解析功能。 物联网平台透传云网关设备数据，您可根据实际业务需要，开启数据解析功能。您可在数据解析脚本中实现transformPayload()方法，将设备上报的原始数据转换为标准的JSON格式或物模型的Alink协议格式。数据解析功能的详细说明，请参见什么是消息解析。
   认证类型	一方认证 您需要将设备认证信息（UserName、Password、SN）导入物联网平台，物联网平台会基于设备认证信息对设备进行认证。 三方认证 您需要选择阿里云函数计算或外部HTTPS认证方式。阿里云函数计算FC的更多信息，请参见什么是函数计算。 阿里云FC：需设置设备认证FC服务、设备认证FC函数和授权，您可以选择已有的FC函数或创建新的FC函数FC认证函数的入参、出参需要符合规范，认证函数名称可以自定义。认证函数的入参、出参说明，请参见表 1. FC认证函数说明。 单击创建服务，跳转到函数计算控制台创建服务。服务的详细说明，请参见管理服务。 单击创建函数，跳转到函数计算控制台创建函数。函数的详细说明，请参见管理函数。 如您还未创建AliyunIOTAccessingFCRole，单击创建RAM角色，跳转到RAM控制台。创建角色和授权策略，请参见创建RAM角色。 外部HTTPS：必须配置设备认证HTTPS URL，可以配置自定义认证参数。 设备认证URL以https://开头。物联网平台通过HTTPS方式调用自定义的设备认证服务，实现HTTPS调用的入参、出参需要符合规范。具体说明，请参见表 2. HTTPS认证参数说明。 最多配置10个自定义认证参数（Key:Value）。 参数Key：参数名称，长度不可超过64个字符。 参数Value：参数值，长度不可超过64个字符。支持设置为变量，变量格式为${变量名名称}。支持的变量为： ${username}：设备建连时上传MQTT的userName。 ${password}：设备建连时上传MQTT的password ${clientId}：设备建连时上传的MQTT的Client ID信息 ${cert.***}：证书信息，其中***可取值cn、serial、issuer。 ${userProperties.***}：Connect报文中的自定义数据UserProperty，***为自定义字段标识符。
   是否开启设备X.509证书认证	开启设备X.509证书认证 需要配置是否开启OCSP： 不开启 服务端证书的OCSP验证 客户端证书的OCSP验证 客户端+服务端证书的OCSP验证 说明 OCSP表示在线证书状态协议，该协议用于向签发证书的CA（Certificate Authority）中心发起查询请求，检查证书是否被吊销。 客户端证书的OCSP校验是在客户端发送消息时执行，如果证书已经吊销，服务端会主动关闭连接。 服务端OCSP Stapling功能默认缓存时间是5分钟至60分钟之间，缓存过期后第一个访问请求OCSP Stapling将不生效，直到重新获取OCSP Stapling信息为止。 不开启设备X.509证书认证 需要配置是否开启OCSP： 不开启 服务端证书的OCSP验证 说明 OCSP表示在线证书状态协议，该协议用于向签发证书的CA（Certificate Authority）中心发起查询请求，检查证书是否被吊销。 客户端证书的OCSP校验是在客户端发送消息时执行，如果证书已经吊销，服务端会主动关闭连接。 服务端OCSP Stapling功能默认缓存时间是5分钟至60分钟之间，缓存过期后第一个访问请求OCSP Stapling将不生效，直到重新获取OCSP Stapling信息为止。

   表 1. FC认证函数说明

   参数类型	参数名称	数据类型	是否必选	描述
   请求参数	userName	String	是	设备建连时上传MQTT的userName。 userName支持英文字母、数字、短划线（-）、下划线（_）、at（@）、英文句号（.）和英文冒号（:），长度限制为4~32个字符。userName在产品维度下不可重复。
   	password	String	是	设备建连时上传MQTT的password。 password支持英文字母、数字、短划线（-）、下划线（_）、at（@）、英文句号（.）和英文冒号（:），长度限制为1~32个字符。
   	clientId	String	是	设备建连时上传的MQTT的Client ID信息。
   	certificateCommonName	String	否	该参数为X.509证书规范中的commonName字段。使用X.509数字证书进行设备身份认证时，需上传该参数。
   返回参数	result	String	是	认证是否成功，true表示成功，false表示失败。
   	message	String	否	认证失败时返回的错误信息。
   	deviceName	String	否	认证成功时，userName对应的设备名称。 设备首次建连时，物联网平台会根据deviceName返回值自动创建对应的设备。

   FC认证函数返回参数示例：

   {
       "result":"true",
       "deviceName":"device_TH",
       "message":""
   }

   表 2. HTTPS认证参数说明

   参数类型	参数名称	数据类型	是否必选	描述	示例
   请求方法	Method	String	是	请求方法取值POST。	POST Content-Type: application/json body:{ "username": "UN001", "password": "PW001", "certificateCommonName": "CN001" }
   Header	Content-Type	String	是	HTTPS Header中定义数据的编码格式，目前只支持application/json。 若使用其他编码格式，会返回参数错误。
   请求参数Body	username	String	是	设备建连时上传MQTT的username。 username支持英文字母、数字、短划线（-）、下划线（_）、at（@）、英文句号（.）和英文冒号（:），长度限制为4~32个字符。username在产品维度下不可重复。
   	password	String	是	设备建连时上传MQTT的password。 password支持英文字母、数字、短划线（-）、下划线（_）、at（@）、英文句号（.）和英文冒号（:），长度限制为1~32个字符。
   	certificateCommonName	String	否	该参数为X.509证书规范中的commonName字段。使用X.509数字证书进行设备身份认证时，需上传该参数。
   返回参数Body	deviceName	String	是	认证成功时，username对应的设备名称。 设备首次建连时，物联网平台会根据devicename返回值自动创建对应的设备。	body:{ "deviceName": "device_TH" }

5. 完成证书配置，单击完成。

   手动输入

   说明

   以下配置的证书都为PEM格式。

   • 必须配置服务端证书和服务端证书私钥。

     通过云网关（MQTT）接入的设备仅支持TLS协议，因此，为了业务安全性，您需要预先配置设备接入的原服务器的CA证书和私钥。

     例如您的证书链从上至下为服务端根证书、服务端中间证书（可包含多层中间证书，例如依次有中间证书A、中间证书B）和服务端证书，则：云网关侧配置为：

     • 服务端证书：依次输入服务端证书和服务端中间证书（例如依次为中间证书B、中间证书A）。

     • 服务端证书私钥：输入对应的服务端证书私钥。

   • 如果开启设备X.509证书认证，需要配置设备端根证书。

     例如您的证书链从上至下为设备根证书、设备中间证书（可包含多层中间证书，例如依次有中间证书A、中间证书B）和设备证书，则云网关侧配置为：

     设备端证书：依次输入设备中间证书（例如依次为中间证书B、中间证书A）和设备端根证书。

   • 如果OCSP认证方式为服务端证书的OCSP验证或客户端+服务端证书的OCSP验证，需要配置信任证书，即服务端的根证书。

6. 在云网关列表，查看云网关信息，包含云网关名称、云网关ID、网关URL、状态和关联产品等。

   重要

   您需保存云网关URL，对应设备连接物联网平台的MQTT接入域名需替换为该云网关URL。您可直接配置云网关URL为新接入域名，也可配置CNAME将接入域名解析到该云网关URL。

   

可选：编辑云网关

创建云网关成功后，在云网关列表，找到对应云网关，单击右侧操作栏的编辑，修改云网关名称、证书信息、FC认证函数。