Erste Schritte

Um ein zu erstellen AWS IoT policy

1. Um eine IAM-Richtlinie zu erstellen, müssen Sie Ihre AWS Region und AWS Kontonummer kennen.

   Um Ihre AWS Kontonummer zu finden, öffnen Sie die AWS Management Console, suchen und erweitern Sie das Menü unter Ihrem Kontonamen in der oberen rechten Ecke und wählen Sie Mein Konto aus. Ihre Konto-ID wird unter Kontoeinstellungen angezeigt.

   Um die AWS Region für Ihr AWS Konto zu finden, verwenden Sie die. AWS Command Line Interface Folgen Sie den Anweisungen im AWS Command Line Interface Benutzerhandbuch AWS CLI, um das zu installieren. Öffnen Sie nach der AWS CLI Installation von ein Befehlszeilenfenster und geben Sie den folgenden Befehl ein:

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

   Die Ausgabe sollte in etwa wie folgt aussehen:

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

   In diesem Beispiel ist die Region us-west-2.

   Anmerkung

   Wir empfehlen die Verwendung von ATS-Endpunkten, wie im Beispiel gezeigt.

2. Navigieren Sie zur AWS IoT -Konsole.

3. Wählen Sie im Navigationsbereich erst Sicher, dann Richtlinien und anschließend Erstellen aus.

4. Geben Sie einen Namen zur Identifizierung Ihrer Richtlinie ein.

5. Wählen Sie im Abschnitt Anweisungen hinzufügen die Option Erweiterter Modus aus. Kopieren Sie die folgende JSON und fügen Sie sie in das Fenster des Richtlinien-Editors ein. Ersetzen Sie aws-region und aws-account durch Ihre AWS Region und Konto-ID.

   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:*"
           }
       ]
   }
   

   Durch diese Richtlinie werden die folgenden Berechtigungen gewährt:

   iot:Connect

   Erteilt Ihrem Gerät die Erlaubnis, mit einer beliebigen Client-ID eine Verbindung zum AWS IoT Message Broker herzustellen.

   iot:Publish

   Erteilt Ihrem Gerät die Berechtigung für die Veröffentlichung einer MQTT-Nachricht zu jedem MQTT-Thema.

   iot:Subscribe

   Erteilt Ihrem Gerät die Berechtigung für die Abonnierung eines MQTT-Themenfilters.

   iot:Receive

   Erteilt Ihrem Gerät die Berechtigung zum Erhalt von Mitteilungen aus dem AWS IoT -Message Broker zu jedem MQTT-Thema.

6. Wählen Sie Erstellen aus.

So erstellen Sie ein IoT-Objekt, einen privaten Schlüssel und ein Zertifikat für Ihr Gerät:

1. Navigieren Sie zur AWS IoT -Konsole.

2. Wählen Sie im Navigationsbereich Verwalten und dann Objekte aus.

3. Wenn keine IoT-Objekte in Ihrem Konto registriert sind, wird die Seite Sie haben noch keine Objekte angezeigt. Wenn Sie diese Seite sehen, wählen Sie Ein Objekt registrieren aus. Wählen Sie andernfalls Erstellen.

4. Wählen Sie auf der Seite „ AWS IoT Dinge erstellen“ die Option Eine einzelne Sache erstellen aus.

5. Geben Sie auf der Seite Fügen Sie Ihr Gerät zur Objektregistrierung hinzu einen Namen für Ihr Objekt ein und klicken Sie dann auf Weiter.

6. Wählen Sie auf der Seite Zertifikat für Ihr Ding hinzufügen unter One-click Zertifikatserstellung die Option Zertifikat erstellen aus.

7. Laden Sie Ihren privaten Schlüssel und das Zertifikat herunter, indem Sie die Links zum Herunterladen für jeden Vorgang auswählen.

8. Wählen Sie Aktivieren aus, um Ihr Zertifikat zu aktivieren. Die Zertifikate müssen aktiviert werden, bevor Sie sie verwenden können.

9. Wählen Sie Richtlinie anhängen, um Ihrem Zertifikat eine Richtlinie anzuhängen, die Ihrem Gerät Zugriff auf AWS IoT Vorgänge gewährt.

10. Wählen Sie die soeben erstellte Richtlinie und dann Objekt registrieren aus.

Um deine zu konfigurieren AWS IoT Endpunkt

Sie müssen FreeRTOS Ihren AWS IoT Endpunkt angeben, damit die auf Ihrem Board laufende Anwendung Anfragen an den richtigen Endpunkt senden kann.

1. Navigieren Sie zur AWS IoT -Konsole.

2. Wählen Sie im linken Navigationsbereich die Option Einstellungen aus.

   Ihr AWS IoT Endpunkt wird unter Gerätedatenendpunkt angezeigt. Sie sollte wie folgt aussehen: 1234567890123-ats.iot.us-east-1.amazonaws.com. Notieren Sie sich diesen Endpunkt.

3. Wählen Sie im Navigationsbereich Verwalten und dann Objekte aus.

   Ihr Gerät sollte einen AWS IoT Namen haben. Notieren Sie sich diesen Namen.

4. Öffnen Sie demos/include/aws_clientcredential.h.

5. Geben Sie für die folgenden -Konstanten Werte an:

   • #define clientcredentialMQTT_BROKER_ENDPOINT "Your AWS IoT endpoint";

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

Um deine zu konfigurieren Wi-Fi

Wenn Ihr Board über eine Wi-Fi Verbindung mit dem Internet verbunden ist, müssen Sie FreeRTOS Wi-Fi Anmeldeinformationen zur Verfügung stellen, um eine Verbindung zum Netzwerk herzustellen. Wenn Ihr Board dies nicht unterstützt Wi-Fi, können Sie diese Schritte überspringen.

1. demos/include/aws_clientcredential.h.

2. Geben Sie für die folgenden #define-Konstanten Werte an:

   • #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

     Gültige Sicherheitstypen sind:

     • eWiFiSecurityOpen (Open, no security (Offen, keine Sicherheit)

     • eWiFiSecurityWEP (WEP-Sicherheit)

     • eWiFiSecurityWPA (WPA-Sicherheit)

     • eWiFiSecurityWPA2 (WPA2-Sicherheit)

Um deine zu formatieren AWS IoT Anmeldedaten

FreeRTOS muss über das AWS IoT Zertifikat und die privaten Schlüssel verfügen, die mit Ihrem registrierten Ding verknüpft sind, sowie über dessen Berechtigungsrichtlinien, um erfolgreich im Namen Ihres Geräts mit AWS IoT FreeRTOS kommunizieren zu können.

FreeRTOS ist ein Projekt in C-Sprache, und das Zertifikat und der private Schlüssel müssen speziell formatiert sein, um dem Projekt hinzugefügt zu werden.

1. Öffnen Sie tools/certificate_configuration/CertificateConfigurator.html im Browserfenster.

2. Wählen Sie unter Certificate PEM file (PEM-Datei für Zertifikat) die Option ID-certificate.pem.crt aus, die Sie von der AWS IoT -Konsole heruntergeladen haben.

3. Wählen Sie unter Private Key PEM file (PEM-Datei für privaten Schlüssel) die Option ID-private.pem.key aus, die Sie von der AWS IoT -Konsole heruntergeladen haben.

4. Wählen Sie Generate and save aws_clientcredential_keys.h (aws_clientcredential_keys.h generieren und speichern) aus und speichern Sie die Datei in demos/include. Diese Einstellung überschreibt die vorhandene Datei im Verzeichnis.

   Anmerkung

   Das Zertifikat und der private Schlüssel sind nur zu Demonstrationszwecken fest codiert. Production-level Anwendungen sollten diese Dateien an einem sicheren Ort speichern.