Demo zur gegenseitigen CoreHTTP-Authentifizierung - FreeRTOS
EinführungFunktionalitätOrganisation des QuellcodesVerbindung zum AWS IoT HTTP-Server herstellenSenden einer HTTP-Anfrage und Empfangen der Antwort

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Demo zur gegenseitigen CoreHTTP-Authentifizierung

Wichtig

Dies ist eine archivierte Version des FreeRTOS-Benutzerhandbuchs zur Verwendung mit der FreeRTOS-Version 202210.00. Die neueste Version dieses Dokuments finden Sie im FreeRTOS-Benutzerhandbuch.

Einführung

Das CoreHTTP-Demoprojekt (Mutual Authentication) zeigt Ihnen, wie Sie mithilfe von TLS eine Verbindung zu einem HTTP-Server mit gegenseitiger Authentifizierung zwischen dem Client und dem Server herstellen. Diese Demo verwendet eine MbedTLS-basierte Transportschnittstellenimplementierung, um eine server- und clientauthentifizierte TLS-Verbindung herzustellen, und demonstriert einen Anforderungsantwort-Workflow in HTTP.

Anmerkung

Folgen Sie den Schritten unter, um die FreeRTOS-Demos einzurichten und auszuführen. Erste Schritte mit FreeRTOS

Funktionalität

In dieser Demo wird eine einzelne Anwendungsaufgabe mit Beispielen erstellt, die zeigen, wie Sie Folgendes ausführen können:

  • Connect zum HTTP-Server auf dem AWS IoT Endpunkt her.

  • Senden Sie eine POST-Anfrage.

  • Empfangen Sie die Antwort.

  • Trennen Sie die Verbindung zum Server.

Nachdem Sie diese Schritte abgeschlossen haben, generiert die Demo eine Ausgabe, die der folgenden Abbildung ähnelt.

Console output showing SDK initialization, network setup, and successful demo completion.

Die AWS IoT Konsole generiert eine Ausgabe, die dem folgenden Screenshot ähnelt.

AWS IoT console interface showing a publish message field and output display area.

Organisation des Quellcodes

Die Demo-Quelldatei ist benannt http_demo_mutual_auth.c und befindet sich im freertos/demos/coreHTTP/ Verzeichnis und auf der GitHubWebsite.

Verbindung zum AWS IoT HTTP-Server herstellen

Die connectToServerWithBackoffRetriesFunktion versucht, eine gegenseitig authentifizierte TLS-Verbindung zum AWS IoT HTTP-Server herzustellen. Wenn die Verbindung fehlschlägt, versucht sie es nach einem Timeout erneut. Der Timeout-Wert steigt exponentiell an, bis die maximale Anzahl von Versuchen oder der maximale Timeout-Wert erreicht ist. Die RetryUtils_BackoffAndSleep Funktion liefert exponentiell steigende Timeout-Werte und kehrt zurück, RetryUtilsRetriesExhausted wenn die maximale Anzahl von Versuchen erreicht wurde. Die connectToServerWithBackoffRetries Funktion gibt einen Fehlerstatus zurück, wenn die TLS-Verbindung zum Broker nach der konfigurierten Anzahl von Versuchen nicht hergestellt werden kann.

Senden einer HTTP-Anfrage und Empfangen der Antwort

Die prvSendHttpRequest-Funktion demonstriert, wie eine POST-Anfrage an den AWS IoT HTTP-Server gesendet wird. Weitere Informationen zum Stellen einer Anfrage an die REST-API finden Sie unter Gerätekommunikationsprotokolle — HTTPS. AWS IoT Die Antwort wird mit demselben CoreHTTP-API-Aufruf empfangen,HTTPClient_Send.