View a markdown version of this page

Demostración de la autenticación mutua de coreHTTP - FreeRTOS
IntroducciónFuncionalidadOrganización del código fuenteConectándose al AWS IoT Servidor HTTPEnvío de una solicitud HTTP y recepción de la respuesta

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Demostración de la autenticación mutua de coreHTTP

importante

Esta demostración está alojada en el Amazon-FreeRTOS repositorio, que está en desuso. Recomendamos empezar por aquí al crear un nuevo proyecto. Si ya tiene un proyecto de Freertos existente basado en el Amazon-FreeRTOS repositorio ahora obsoleto, consulte la. Amazon-FreeRTOS Guía de migración del repositorio de Github

Introducción

El proyecto de demostración coreHTTP (Autenticación mutua) muestra cómo establecer una conexión con un servidor HTTP mediante TLS con autenticación mutua entre el cliente y el servidor. Esta demostración utiliza una implementación de interfaz de TLS-based transporte integrada para establecer una conexión TLS autenticada por el servidor y el cliente, y muestra un flujo de trabajo de solicitud y respuesta en HTTP.

nota

Para configurar y ejecutar las demostraciones de FreeRTOS, siga los pasos que se indican en Introducción a FreeRTOS.

Funcionalidad

Esta demostración crea una tarea de aplicación única con ejemplos que muestran cómo realizar lo siguiente:

  • Conéctese al servidor HTTP del AWS IoT punto final.

  • Enviar una solicitud POST.

  • Recibir la respuesta.

  • Desconectarse del servidor.

Tras completar estos pasos, la demostración genera una salida similar a la de la siguiente captura de pantalla.

El resultado del registro muestra la inicialización de la AWS IoT demostración, el establecimiento de la sesión de TLS, las solicitudes HTTP POST y las métricas de memoria que indican que la demostración se ha completado correctamente.

La AWS IoT consola genera un resultado similar al de la siguiente captura de pantalla.

AWS IoT consola que muestra el mensaje «Hola desde la AWS IoT consola» publicado sobre un tema el 20 de noviembre de 2020 a las 19:09:09 UTC.

Organización del código fuente

El archivo fuente de la demostración lleva un nombre http_demo_mutual_auth.c y se encuentra en el freertos/demos/coreHTTP/ directorio y en el GitHubsitio web.

Conectándose al AWS IoT Servidor HTTP

La ToServerWithBackoffRetries función de conexión intenta establecer una conexión TLS mutuamente autenticada con el servidor AWS IoT HTTP. Si la conexión falla, se vuelve a intentar cuando se agota el tiempo de espera. El valor de tiempo de espera aumenta exponencialmente hasta que se alcanza el número máximo de intentos o se alcanza el valor de tiempo de espera máximo. La función RetryUtils_BackoffAndSleep proporciona valores de tiempo de espera que aumentan exponencialmente y devuelve RetryUtilsRetriesExhausted cuando se alcanza el número máximo de intentos. La función connectToServerWithBackoffRetries devuelve un estado de error si no se puede establecer la conexión TLS con el agente tras el número de intentos configurado.

Envío de una solicitud HTTP y recepción de la respuesta

La SendHttpRequest función prv muestra cómo enviar una solicitud POST al AWS IoT servidor HTTP. Para obtener más información sobre cómo realizar una solicitud a la API REST AWS IoT, consulte Protocolos de comunicación del dispositivo: HTTPS. La respuesta se recibe con la misma llamada a la API coreHTTP, HTTPClient_Send.