HTTPS 演示应用程序 - FreeRTOS
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

HTTPS 演示应用程序

概览

有关使用 FreeRTOS HTTPS 客户端库的示例,请参阅 iot_demo_https_s3_download_async.ciot_demo_https_s3_download_sync.c 中定义的 HTTPS 客户端演示应用程序。

HTTPS 客户端演示说明了如何使用预签名 URL 从 Amazon S3 下载文件。该文件是使用 HTTP Partial Content 标头以增量方式下载的。响应正文缓冲区大小的字节范围是在每个增量请求中指定的。HTTPS 客户端库是一个通用库,可用于从其他 Web 服务器中下载文件。请注意,并非所有 HTTP 服务器都支持具有字节范围的 Partial Content 下载。

要使用 HTTPS 客户端演示,您还必须为 freertos/demos/include/aws_clientcredential_keys.h 文件中的以下常量设置值:

keyCLIENT_CERTIFICATE_PEM

TLS 连接所需的证书 PEM。

keyCLIENT_PRIVATE_KEY_PEM

TLS 连接所需的私有密钥 PEM。

配置参数

这些配置参数适用于 HTTPS 客户端演示,并需要定义这些参数。

IOT_DEMO_HTTPS_PRESIGNED_GET_URL

特定对象的 Amazon S3 GET 请求的预签名 URL。它必须采用以下格式:

https://awsexamplebucket1.ŝ3.amazonaws.com/object-key.txt?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Expires=1560555644&Signature=SomeHash12345UrlABcdEFgfIjK%3D

有关使用同一文件夹中的 Python 脚本生成预签名 URL 的说明,请参阅 freertos/demos/https/README.md

这些配置参数适用于 HTTPS 客户端演示,不需要定义这些参数,它们用于提供更多自定义选项。

IOT_DEMO_HTTPS_PORT

要连接到的 HTTPS 服务器 TCP 端口。默认值为 443。

IOT_DEMO_HTTPS_TRUSTED_ROOT

要连接到 HTTPS 服务器的受信任的根 CA。HTTPS 服务器是在 IOT_DEMO_HTTPS_PRESIGNED_GET_URL 中按主机名定义的。默认值为 Baltimore Cybertrust 根证书颁发机构。

有关其他配置,请参阅 HTTPS 客户端 API 参考演示配置

使用说明

有关更多信息和输出示例,请参阅 HTTPS 客户端 API 参考演示使用说明