Primeros pasos

Para crear un AWS IoT policy

1. Para crear una política de IAM, debe conocer su AWS región y su número de AWS cuenta.

   Para encontrar su número de AWS cuenta, abra la consola AWS de administración, busque y amplíe el menú situado debajo del nombre de su cuenta, en la esquina superior derecha, y seleccione Mi cuenta. El ID de su cuenta se muestra en Account Settings (Configuración de cuenta).

   Para encontrar la AWS región de su AWS cuenta, utilice la. AWS Command Line Interface Para instalar el AWS CLI, siga las instrucciones de la Guía del AWS Command Line Interface usuario. Tras instalar el AWS CLI, abra una ventana de línea de comandos e introduzca el siguiente comando:

   aws iot describe-endpoint --endpoint-type=iot:Data-ATS

   La salida debe tener el siguiente aspecto:

   {
       "endpointAddress": "xxxxxxxxxxxxxx-ats.iot.us-west-2.amazonaws.com"
   }

   En este ejemplo, la región es us-west-2.

   nota

   Recomendamos utilizar los puntos de conexión de ATS, tal y como se muestra en el ejemplo.

2. Vaya a la consola de AWS IoT.

3. En el panel de navegación, elija Secure (Seguridad), elija Policies (Políticas) y, a continuación, elija Create (Crear).

4. Especifique un nombre que identifique la política.

5. En la sección Añadir declaraciones, elija Modo avanzado. Copie y pegue la siguiente política JSON en la ventana del editor de políticas. Sustituya aws-region y aws-account por su AWS región e ID de cuenta.

   JSON

   {
       "Version":"2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iot:Connect",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Publish",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Subscribe",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Receive",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           }
       ]
   }
   

   Esta política le concede los siguientes permisos:

   iot:Connect

   Concede a su dispositivo el permiso para conectarse al agente de AWS IoT mensajes con cualquier ID de cliente.

   iot:Publish

   Concede a su dispositivo permiso para publicar un mensaje de MQTT en cualquier tema de MQTT.

   iot:Subscribe

   Concede a su dispositivo permiso para suscribirse a cualquier filtro de temas de MQTT.

   iot:Receive

   Concede a su dispositivo permiso para recibir mensajes del agente de mensajes de AWS IoT acerca de cualquier tema de MQTT.

6. Seleccione Crear.

Creación de un objeto de IoT, clave privada y certificado para su dispositivo

1. Vaya a la consola de AWS IoT.

2. En el panel de navegación, elija Manage (Administrar) y, a continuación, Things (Cosas).

3. Si no tiene ningún objeto de IoT registrado en su cuenta, se muestra la página Aún no tiene ningún objeto. Si ve esta página, elija Registrar un objeto. De lo contrario, seleccione Crear.

4. En la página Crear AWS IoT cosas, selecciona Crear una sola cosa.

5. En la página Añadir su dispositivo al registro de objetos, escriba un nombre para su objeto y, a continuación, haga clic en Siguiente.

6. En la página Añadir un certificado para tu cosa, en Creación de One-click certificados, selecciona Crear certificado.

7. Descargue su clave privada y certificado eligiendo los enlaces Descargar para cada uno de ellos.

8. Elija Activar para activar su certificado. Los certificados deben activarse para poder usarlos.

9. Selecciona Adjuntar una política para adjuntar una política a tu certificado que permita a tu dispositivo acceder a AWS IoT las operaciones.

10. Elija la política que acaba de crear y elija Registrar objeto.

Para configurar su AWS IoT punto de conexión

Debes proporcionar Freertos a tu AWS IoT terminal para que la aplicación que se ejecuta en tu placa pueda enviar solicitudes al punto final correcto.

1. Vaya a la consola de AWS IoT.

2. En el panel de navegación izquierdo, elija Configuración.

   Tu AWS IoT terminal se muestra en el punto final de datos del dispositivo. Debe tener un aspecto similar al siguiente: 1234567890123-ats.iot.us-east-1.amazonaws.com. Tome nota de este punto de enlace.

3. En el panel de navegación, elija Manage (Administrar) y, a continuación, Things (Cosas).

   El dispositivo debe tener un nombre AWS IoT para el dispositivo. Anote este nombre.

4. Abra demos/include/aws_clientcredential.h.

5. Especifique valores para las siguientes constantes:

   • #define clientcredentialMQTT_BROKER_ENDPOINT "Your AWS IoT endpoint";

   • #define clientcredentialIOT_THING_NAME "The AWS IoT thing name of your board"

Para configurar su Wi-Fi

Si su placa se conecta a Internet a través de una Wi-Fi conexión, debe proporcionar a FreeRTOS Wi-Fi las credenciales para conectarse a la red. Si tu placa no es compatible Wi-Fi, puedes saltarte estos pasos.

1. demos/include/aws_clientcredential.h.

2. Especifique valores para las siguientes constantes de #define:

   • #define clientcredentialWIFI_SSID "The SSID for your Wi-Fi network"

   • #define clientcredentialWIFI_PASSWORD "The password for your Wi-Fi network"

   • #define clientcredentialWIFI_SECURITY The security type of your Wi-Fi network

     Los tipos de seguridad válidos son:

     • eWiFiSecurityOpen (abierta, sin seguridad)

     • eWiFiSecurityWEP (seguridad WEP)

     • eWiFiSecurityWPA (seguridad WPA)

     • eWiFiSecurityWPA2 (seguridad WPA2)

Para formatear tu AWS IoT credentials

FreeRTOS debe tener el AWS IoT certificado y las claves privadas asociadas a tu objeto registrado y a sus políticas de permisos para poder comunicarse correctamente AWS IoT en nombre de tu dispositivo.

FreeRTOS es un proyecto en lenguaje C, y el certificado y la clave privada deben tener un formato específico para que se puedan añadir al proyecto.

1. En una ventana del navegador, abra tools/certificate_configuration/CertificateConfigurator.html.

2. En Archivo PEM del certificado, elija el archivo ID-certificate.pem.crt que ha descargado desde la consola de AWS IoT .

3. En Archivo PEM de clave privada, elija el archivo ID-private.pem.key que ha descargado desde la consola de AWS IoT .

4. Elija Generate and save aws_clientcredential_keys.h (Generar y guardar aws_clientcredential_keys.h) y después guarde el archivo en demos/include. Esto sobrescribe el archivo existente en el directorio.

   nota

   El certificado y la clave privada están codificados únicamente con fines de demostración. Production-level las aplicaciones deben almacenar estos archivos en un lugar seguro.