IoT Platform:Crear una puerta de enlace en la nube JT/T 808

Requisitos previos

Debe haber adquirido una instancia Enterprise de la Exclusive Edition. Para obtener más información, consulte Purchase an Enterprise instance.

Contexto

Para obtener información sobre cómo utilizar una puerta de enlace en la nube JT/T 808 para conectar un dispositivo a IoT Platform, consulte JT/T 808 gateways.

Agregar una puerta de enlace en la nube

1. Inicie sesión en la consola de IoT Platform.

2. En la página Instance Overview, haga clic en la instancia Enterprise objetivo de la Exclusive Edition.

3. En el panel de navegación izquierdo, seleccione Device Management > Cloud Gateway y, a continuación, haga clic en Add Cloud Gateway.

4. Configure los parámetros según las instrucciones en pantalla y haga clic en Next. La siguiente tabla describe los parámetros.

   Parámetro	Descripción
   Gateway Name	Introduzca un nombre para la puerta de enlace en la nube. El nombre debe ser único dentro de la instancia. Debe tener entre 4 y 30 caracteres de longitud y puede contener caracteres chinos, japoneses, letras, dígitos y guiones bajos (_). Un carácter chino o japonés cuenta como dos caracteres.
   Protocol	Seleccione JT/T 808.
   Custom Port Number	Valores válidos: de 1024 a 65535. Valor predeterminado: 7999.
   Authentication Type	Verificación propia Si selecciona esta opción, debe importar la información de verificación del dispositivo a IoT Platform. Esta información incluye el ID del fabricante, el modelo del terminal y el ID del terminal del dispositivo. IoT Platform verifica el dispositivo basándose en dicha información. Certificación de terceros Alibaba Cloud Function Compute: Si selecciona esta opción, debe configurar los parámetros Device-verified FC Service, Device-verified FC Function y Authorize. Puede seleccionar una función de Function Compute existente o crear una nueva para la verificación del dispositivo. Los parámetros de entrada y salida de la función que cree deben cumplir requisitos específicos. Puede especificar un nombre de función personalizado. Para obtener información sobre los requisitos de los parámetros de entrada y salida de la función de verificación del dispositivo, consulte Table 1 Device registration parameters, Table 2 Device verification parameters y Table 3 Device deregistration parameters. Haga clic en Create Service para ir a la consola de Function Compute y crear un servicio. Para obtener información sobre los servicios de Function Compute, consulte Manage services. Haga clic en Create Function para ir a la consola de Function Compute y crear una función. Para obtener información sobre las funciones de Function Compute, consulte Manage functions. Si el rol AliyunIOTAccessingFCRole no está disponible, haga clic en Create RAM Role para ir a la consola de RAM y crear el rol. Para obtener información sobre cómo crear un rol de RAM y otorgarle permisos, consulte Create a RAM role.
   Transmission Protocol	TCP Si utiliza el protocolo TCP (Transmission Control Protocol) para conectar un dispositivo, se recomienda no hacerlo a través de Internet. Para garantizar la seguridad, establezca la conexión mediante una línea dedicada. Importante Si utiliza TCP para conectar un dispositivo, no es necesario configurar certificados. Una vez completadas todas las configuraciones en el paso de información básica, haga clic en OK para crear la puerta de enlace. TLS Si conecta dispositivos a IoT Platform mediante TLS (Transport Layer Security), puede habilitar la verificación unidireccional del lado del servidor, el protocolo OCSP (Online Certificate Status Protocol) para dispositivos, conexiones seguras bidireccionales entre dispositivos y servidores, entre otras funciones. Habilite la verificación de dispositivos basada en certificados X.509. Valores válidos del parámetro Enable OCSP: Disabled OCSP Verification for Server Certificate OCSP Verification for Client Certificate Client and Server-side OCSP Verification Deshabilite la verificación de dispositivos basada en certificados X.509. Valores válidos del parámetro Enable OCSP: Disabled OCSP Verification for Server Certificate Nota El protocolo OCSP (Online Certificate Status Protocol) es un protocolo de Internet utilizado para consultar a una autoridad de certificación (CA) sobre el estado de revocación de un certificado. La verificación OCSP de un certificado de cliente se realiza cuando el cliente envía un mensaje. Si el certificado ha sido revocado, el servidor cierra activamente la conexión. La duración predeterminada de la caché para la función OCSP Stapling del lado del servidor es de 5 a 60 minutos. Una vez expirada la caché, OCSP Stapling no surte efecto en la primera solicitud de acceso hasta que se obtiene nuevamente la información de OCSP Stapling.

   Tabla 1. Parámetros de registro de dispositivos

   Tipo de parámetro	Nombre del parámetro	Tipo de datos	Descripción	Ejemplo
   Parámetros de solicitud	manufacturer	String	ID del fabricante del dispositivo. El ID debe tener entre 4 y 11 caracteres de longitud y puede contener letras, dígitos y guiones (-).	{ "manufacturer":"mf0001", "deviceModel":"dm0001", "deviceId":"di0001", "licensePlateColour":"1", "licensePlateNumber":"ZhejiangA****", "phone":"1**********", "action":"register" }
   	deviceModel	String	Modelo del dispositivo. El modelo del dispositivo debe tener entre 4 y 30 caracteres de longitud y puede contener letras, dígitos y guiones (-).
   	deviceId	String	ID del dispositivo. El ID debe tener entre 4 y 30 caracteres de longitud y puede contener letras, dígitos y guiones (-).
   	licensePlateColour	String	Color de la matrícula. El valor debe cumplir con los requisitos del protocolo JT/T 808. Para obtener más información, consulte JT/T 808-2019.
   	licensePlateNumber	String	Número de matrícula.
   	phone	String	Número de celular.
   	action	String	Establezca el valor en register, que especifica el registro del dispositivo.
   Parámetros de respuesta	result	String	Indica si el registro fue exitoso. Valores válidos: true false	Ejemplo de respuesta exitosa { "result":"true", "message":"", "authCode":"****" } Ejemplo de respuesta con errores { "result":"false", "message":"4" }
   	message	String	Mensaje de error devuelto si el registro falló. Valores válidos: 1: El vehículo ya está registrado. 2: No se encontró el vehículo. 3: El dispositivo ya está registrado. 4: No se encontró el dispositivo.
   	authCode	String	Código de autenticación devuelto si el registro fue exitoso.

   Tabla 2. Parámetros de verificación de dispositivos

   Tipo de parámetro	Nombre del parámetro	Tipo de datos	Descripción	Ejemplo
   Parámetros de solicitud	phone	String	Número de celular.	{ "phone":"1**********", "authCode":"****", "protocol":"TCP", "action":"auth", }
   	authCode	String	Código de verificación devuelto si el registro fue exitoso.
   	protocol	String	Protocolo de transmisión.
   	action	String	Establezca el valor en auth, que especifica la verificación del dispositivo.
   Parámetros de respuesta	result	String	Indica si la verificación fue exitosa. Valores válidos: true false	{ "result":"true", "message":"" "manufacturer":"mf0001" "deviceModel":"dm0001" "deviceId":"di0001" }
   	message	String	Mensaje de error devuelto si la verificación falló.
   	manufacturer	String	ID del fabricante del dispositivo devuelto si la verificación fue exitosa.
   	deviceModel	String	Modelo del dispositivo devuelto si la verificación fue exitosa.
   	deviceId	String	ID del dispositivo devuelto si la verificación fue exitosa.

   Tabla 3. Parámetros de cancelación de registro de dispositivos

   Tipo de parámetro	Nombre del parámetro	Tipo de datos	Descripción	Ejemplo
   Parámetros de solicitud	manufacturer	String	ID del fabricante del dispositivo.	{ "phone":"1**********", "manufacturer":"mf0001", "deviceModel":"dm0001", "deviceId":"di0001", "action":"unregister", }
   	deviceModel	String	Modelo del dispositivo.
   	deviceId	String	ID del dispositivo.
   	phone	String	Número de celular.
   	action	String	Establezca el valor en unregister, que especifica la cancelación de registro del dispositivo.
   Parámetros de respuesta	result	String	Indica si la cancelación de registro fue exitosa. Valores válidos: true false	{ "result":"true", "message":"" }
   	message	String	Mensaje de error devuelto si la cancelación de registro falló.

5. Complete el paso Certificate Configuration y haga clic en OK.

   Configurar certificados

   Importante

   • Si selecciona TCP como protocolo de transmisión, no es necesario configurar certificados.

   • Los certificados que se configuran en este paso son archivos PEM (Privacy Enhanced Mail).

   1. Debe configurar los parámetros Server Certificate y Private Key of Server Certificate.

   2. Si habilita la verificación de dispositivos basada en certificados X.509, debe configurar el parámetro Device Root Certificate.

   3. Si en el paso anterior estableció el parámetro Enable OCSP en OCSP Verification for Server Certificate o Client and Server-side OCSP Verification, debe establecer el parámetro Trusted Certificate en el certificado raíz del servidor en este paso.

6. Consulte la información de la puerta de enlace creada en la página de puertas de enlace, incluido el nombre, el ID, la URL de la puerta de enlace, el estado y el producto asociado.

   Importante

   Debe registrar la URL de la puerta de enlace. Cuando conecte un dispositivo a IoT Platform mediante JT/T 808, deberá reemplazar el endpoint de JT/T 808 con la URL de la puerta de enlace. Puede especificar la URL de la puerta de enlace como el endpoint de JT/T 808 o configurar un registro CNAME para resolver el endpoint de JT/T 808 hacia la URL de la puerta de enlace.

   

(Opcional) Modificar una puerta de enlace en la nube

Después de crear una puerta de enlace en la nube, búsquela en la lista de puertas de enlace y haga clic en Edit en la columna Actions para modificar el nombre de la puerta de enlace, la información del certificado o la función de autenticación de FC.

Resultado

Una vez creada la puerta de enlace en la nube, IoT Platform crea y asocia un producto con dicha puerta de enlace. El nombre del producto sigue el formato Cloud gateway+${Cloud gateway ID}. Para ver el nuevo producto, seleccione Devices > Products. El nuevo producto aparecerá en la página Products.

Haga clic en View en la columna Actions correspondiente al producto. En la página Product Details, podrá consultar la información del producto.

Siguientes pasos

• La primera vez que utilice la puerta de enlace en la nube cuyo parámetro Authentication Type esté configurado como Third-party Certification para conectar un dispositivo a IoT Platform, la plataforma combinará automáticamente los valores de los parámetros manufacturer, deviceModel y deviceId en el formato ${manufacturer}_${deviceModel}_${deviceId} para usarlos como DeviceName y crear así el dispositivo.

• Después de crear una puerta de enlace en la nube cuyo parámetro Authentication Type esté configurado como One-party Verification, debe importar la información de verificación de los dispositivos para agregarlos al producto de puerta de enlace correspondiente. Para obtener más información, consulte Add multiple devices.