Guía de integración de AWS IoT Core (broker MQTT)

Tulip Interface Integración con AWS IoT Core: Guía de la consola de AWS

# Tulip Interface Integración con AWS IoT Core - Guía de la consola de AWS

Descripción general

Esta guía muestra cómo conectar tu dispositivo « Tulip Interface » a AWS IoT Core utilizando únicamente la consola de AWS, ¡sin necesidad de usar la línea de comandos!

Requisitos previos

Acceso a la consola de AWS con permisos de IoT
Acceso a Tulip Interface con capacidad de conexión MQTT
Navegador web

Paso 1: Crear un dispositivo IoT

1.1 Accede a la consola de AWS IoT

Ve a la consola de AWS IoT
En la barra lateral izquierda, haz clic en «Gestionar» → «Dispositivos»

1.2 Crear un nuevo dispositivo

Haz clic en «Crear dispositivos»
Selecciona «Crear un dispositivo individual»
Haz clic en «Siguiente»
Introduce el nombre del elemento: tulip-interface-client
Deja los demás campos con los valores predeterminados
Haz clic en «Siguiente»

Paso 2: Crear certificado de dispositivo

2.1 Configuración del certificado

Seleccione «Generar automáticamente un nuevo certificado»
Haz clic en «Siguiente»

2.2 Crear política de IoT

Haga clic en «Crear política»
En la nueva pestaña que se abre:
Nombre de la política: TulipMQTTPolicy
Documento de la política: Haga clic en la pestaña «JSON» y pegue lo siguiente: json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:*" ], "Resource": "*" } ] }
Haga clic en «Crear»
Vuelve a la pestaña anterior

2.3 Asociar una política

Actualice la lista de políticas
Selecciona «TulipMQTTPolicy»
Haz clic en «Crear cosa»

Paso 3: Descargar los archivos de certificados

3.1 Descargar los archivos necesarios

IMPORTANTE: Descarga estos archivos inmediatamente (no podrás descargarlos más tarde):

Certificado del dispositivo → Guardar como certificate.pem.crt
Archivo de clave privada → Guárdalo como private.pem.key
Amazon Root CA 1 → Guárdalo como AmazonRootCA1.pem
Haz clic en «Hecho»

3.2 Crear el archivo de la cadena de certificados

Abre certificate.pem.crt en un editor de texto
Abre AmazonRootCA1.pem en un editor de texto
Crea un nuevo archivo llamado cert_chain.pem
Copia todo el contenido de certificate.pem.crt en cert_chain.pem
Añade una nueva línea al final
Copia todo el contenido de AmazonRootCA1.pem y añádelo al final de cert_chain.pem
Guarda cert_chain.pem

Paso 4: Convertir el formato de la clave privada

4.1 Herramienta de conversión en línea

Como queremos evitar la línea de comandos, utiliza una herramienta en línea:

Accede a SSL Converter o a una herramienta similar
Selecciona «Convertir desde: Clave privada RSA»
Selecciona «Convertir a: PKCS#8»
Sube tu archivo private.pem.key
Descarga el archivo convertido como private_pkcs8.pem

Nota de seguridad: Para entornos de producción, utiliza herramientas sin conexión o la línea de comandos para mayor seguridad.

Paso 5: Obtener el punto final de IoT

5.1 Busca tu punto de conexión

En la consola de AWS IoT, ve a «Configuración» (barra lateral izquierda)
En «Punto final de datos del dispositivo», copie la URL del punto final
Tiene el siguiente formato: a1234567890123-ats.iot.us-west-1.amazonaws.com
Guarda esta URL; la necesitarás para la configuración de Tulip

Paso 6: Configurar el conector MQTT de Tulip Interface

6.1 Ajustes de conexión MQTT

En tu conector MQTT de « Tulip Interface », configura lo siguiente:

Host del broker MQTT: [Tu punto de conexión del paso 5]
Puerto: 8883
Protocolo: MQTT sobre TLS o MQTTS
ID de cliente: tulip-interface-client

6.2 Configuración del certificado

Sube estos archivos a Tulip Interface:

Archivo de certificado: Sube cert_chain.pem
Archivo de clave privada: Subir private_pkcs8.pem
Archivo de certificado de la CA: Sube AmazonRootCA1.pem

6.3 Configuración del tema

Tema de publicación: tulip/data
Tema de suscripción: tulip/commands (opcional)

Paso 7: Habilitar el registro en CloudWatch (opcional)

7.1 Crear un rol de IAM

Accede a la consola de IAM
Haz clic en «Roles » → «Crear rol»
Selecciona el servicio de AWS → IoT
Haz clic en «Siguiente»
Busca y selecciona «CloudWatchLogsFullAccess»
Haz clic en «Siguiente»
Nombre del rol: IoTLogsRole
Haz clic en «Crear rol»

7.2 Habilitar el registro de IoT

Vuelve a la consola de AWS IoT
Vaya a «Configuración» (barra lateral izquierda)
En «Registros», haz clic en «Editar»
Nivel de detalle: Información
Establecer rol: Selecciona IoTLogsRole
Haz clic en «Actualizar»

Paso 8: Probar la conexión

8.1 Supervisar en la consola de AWS

Vaya a Prueba → Cliente de prueba MQTT
Haz clic en «Suscribirse a un tema»
Filtro de temas: tulip/data
Haz clic en «Suscribirse»

8.2 Prueba desde Tulip

Envía un mensaje de prueba desde Tulip Interface
Deberías ver aparecer el mensaje en el cliente de prueba de AWS MQTT

8.3 Comprueba los registros de CloudWatch (si están habilitados)

Ve a la consola de CloudWatch
Haz clic en «Logs» → «Grupos de registros»
Busca «AWSIotLogsV2»
Haz clic en el grupo de registros para ver los registros de conexión

Solución de problemas

Problemas habituales y soluciones en la consola

1. El certificado no funciona

Problema: La conexión falla debido aerrores de certificado. Solución: - Asegúrate de que estás utilizando cert_chain.pem (no un certificado individual). - Comprueba que la clave privada esté en formato PKCS#8 (private_pkcs8.pem).

2. Problemas con las políticas

Problema: Fallos de autorización enlos registros. Solución: 1. Ve a «Secure» → «Policies». 2. Haz clic en «TulipMQTTPolicy». 3. Comprueba que la política JSON permita «iot:*» en los recursos «*».

3. Punto final incorrecto

Problema: No se puede conectar albroker. Solución: 1. Ve a «Configuración» en la consola de IoT. 2. Copia la URL exacta del punto final (incluido el sufijo «-ats» ). 3. Utiliza el puerto 8883

4. Certificado no adjunto

Problema:Errores de autenticación.Solución: 1. Ve a Seguridad → Certificados. 2. Haz clic en tu certificado. 3. Comprueba las pestañas «Things » y «Políticas ». 4. Asegúrate de que el «thing» tulip-interface-client y TulipMQTTPolicy estén asociados.

Resumen de archivos

Deberías disponer de estos archivos para la configuración de Tulip:

📁 Archivos descargados├── certificate.pem.crt      # Certificado original del dispositivo├── private.pem.key          # Clave privada original├── AmazonRootCA1.pem        # CA raíz de Amazon├── cert_chain.pem           # Certificado + CA raíz ← Utiliza este└── private_pkcs8.pem        # Clave privada convertida ← Utiliza esta

Ficha de referencia rápida

Resumen de la configuración de Tulip MQTT

Parámetro	Valor
Host	`[tu-punto-final]-ats.iot.[región].amazonaws.com`
Puerto	`8883`
ID de cliente	`tulip-interface-client`
Tema	`tulip/data`
Certificado	`cert_chain.pem`
Clave privada	`private_pkcs8.pem`
Certificado de CA	`AmazonRootCA1.pem`

Enlaces rápidos de la consola de AWS

Consola de IoT: gestión principal de IoT
Cliente de prueba MQTT: mensajes de prueba
CloudWatch Logs: ver registros de conexión
Consola de IAM: gestión de roles y políticas

Indicadores de éxito

✅ Conexión correcta

Tulip Interface Muestra el estado «Conectado»
Aparecen mensajes en el cliente de prueba de AWS MQTT al suscribirse a tulip/data
Los registros de CloudWatch muestran eventos «Publish-In » correctos

❌ Error de conexión

Comprueba que los archivos de certificado tengan el formato correcto
Comprueba que la URL del punto final coincida exactamente con la de la consola de AWS
Asegúrate de que se utiliza el puerto 8883
Confirma que el ID de cliente coincide exactamente con el nombre del dispositivo

Prácticas recomendadas de seguridad

Almacenamiento de certificados: almacena los archivos de certificado de forma segura en Tulip
Ajuste de políticas: tras las pruebas, crea políticas más restrictivas
Supervisión: active el registro en CloudWatch para la supervisión en producción
Rotación periódica: planifica la rotación de certificados (los certificados caducan en 2049)

Recursos de soporte

Documentación de AWS IoT: docs.aws.amazon.com/iot
Soporte técnico de Tulip: Ponte en contacto con el soporte técnico de Tulip para resolver problemas relacionados con el conector MQTT
Soporte de AWS: Utiliza el soporte de AWS para problemas relacionados con IoT Core

Nota: Esta guía utiliza exclusivamente la consola de AWS. Para la automatización o la creación de scripts, consulta la guía basada en la CLI.