初始步骤

报名参加 AWS 账户

1. 打开https://portal.aws.amazon.com/billing/注册。

2. 按照屏幕上的说明操作。

   在注册时，将接到电话或收到短信，要求使用电话键盘输入一个验证码。

   当您注册时AWS 账户，就会创建AWS 账户根用户一个。根用户有权访问该账户中的所有 AWS 服务 和资源。作为最佳安全实践，请为用户分配管理访问权限，并且只使用根用户来执行需要根用户访问权限的任务。

保护你的 AWS 账户根用户

1. 选择 Root 用户并输入您的AWS 账户电子邮件地址，以账户所有者的身份登录。AWS 管理控制台在下一页上，输入您的密码。

   要获取使用根用户登录方面的帮助，请参阅《AWS 登录 用户指南》中的 Signing in as the root user。

2. 为您的根用户启用多重身份验证（MFA）。

   有关说明，请参阅 I A M 用户指南中的为AWS 账户根用户启用虚拟 MFA 设备（控制台）。

创建具有管理访问权限的用户

1. 启用 IAM Identity Center。

   有关说明，请参阅《AWS IAM Identity Center 用户指南》中的 Enabling。AWS IAM Identity Center

2. 在 IAM Identity Center 中，为用户授予管理访问权限。

   有关使用IAM Identity Center 目录作为身份源的教程，请参阅《用户指南》IAM Identity Center 目录中的使用默认设置配置AWS IAM Identity Center用户访问权限。

以具有管理访问权限的用户身份登录

• 要使用您的 IAM Identity Center 用户身份登录，请使用您在创建 IAM Identity Center 用户时发送到您的电子邮件地址的登录 URL。

  有关使用 IAM Identity Center 用户登录的帮助，请参阅AWS 登录用户指南中的登录AWS访问门户。

将访问权限分配给其他用户

1. 在 IAM Identity Center 中，创建一个权限集，该权限集遵循应用最低权限的最佳做法。

   有关说明，请参阅《AWS IAM Identity Center 用户指南》中的 Create a permission set。

2. 将用户分配到一个组，然后为该组分配单点登录访问权限。

   有关说明，请参阅《AWS IAM Identity Center 用户指南》中的 Add groups。

创建AWS IoT策略

1. 要创建 IAM 策略，您必须知道您的AWS地区和AWS账号。

   要查找您的AWS账号，请打开AWS管理控制台，找到并展开右上角账户名称下方的菜单，然后选择我的账户。您的账户 ID 显示在 Account Settings (账户设置) 下。

   要查找您AWS账户所在AWS的地区，请使用AWS Command Line Interface。要安装AWS CLI，请按照《AWS Command Line Interface用户指南》中的说明进行操作。安装后AWS CLI，打开命令提示符窗口并输入以下命令：

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

   输出应该如下所示：

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

   在此示例中，区域为 us-west-2。

   注意

   我们建议使用 ATS 端点，如示例所示。

2. 浏览至 AWS IoT 控制台。

3. 在导航窗格中依次选择安全、策略和创建。

4. 输入用于标识您的策略的名称。

5. 在添加语句部分中，选择高级模式。将以下 JSON 复制并粘贴到策略编辑器窗口中。aws-account用您的AWS地区aws-region和账户 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:*"
           }
       ]
   }
   

   此策略授予以下权限：

   iot:Connect

   向您的设备授予使用任何客户端 ID 连接AWS IoT消息代理的权限。

   iot:Publish

   授予设备在任何 MQTT 主题上发布 MQTT 消息的权限。

   iot:Subscribe

   授予设备订阅到任何 MQTT 主题筛选条件的权限。

   iot:Receive

   授予设备从 AWS IoT 消息代理接收有关任何 MQTT 主题的消息的权限。

6. 选择创建。

为设备创建 IoT 事物、私有密钥和证书

1. 浏览至 AWS IoT 控制台。

2. 在导航窗格中，选择管理，然后选择事物。

3. 如果您的账户中未注册任何 IoT 事物，此时将显示您还没有任何事物页面。如果您看到此页面，请选择注册事物。否则，选择创建。

4. 在创建AWS IoT事物页面上，选择创建单个事物。

5. 在将设备添加到事物注册表页面上，输入您事物的名称，然后选择下一步。

6. 在添加事物的证书页面上的一键式创建证书下，选择创建证书。

7. 选择各项的下载链接来下载私有密钥和证书。

8. 选择激活来激活您的证书。必须先激活证书，然后才能使用它们 。

9. 选择 Att ach a policy，将策略附加到您的证书，该策略允许您的设备访问AWS IoT操作。

10. 选择您刚刚创建的策略，然后选择注册事物。

配置您的AWS IoT终端节点

您必须向FreeRTOS提供终端节点，以便在AWS IoT您的主板上运行的应用程序可以向正确的端点发送请求。

1. 浏览至 AWS IoT 控制台。

2. 在左侧导航窗格中，选择设置。

   您的AWS IoT终端节点显示在设备数据端点中。它应该类似于 1234567890123-ats.iot.us-east-1.amazonaws.com。记下此终端节点。

3. 在导航窗格中，选择管理，然后选择事物。

   您的设备应该有一个AWS IoT事物名称。记下此名称。

4. 打开 demos/include/aws_clientcredential.h。

5. 为以下常量指定值：

   • #define clientcredentialMQTT_BROKER_ENDPOINT "YourAWS IoTendpoint";

   • #define clientcredentialIOT_THING_NAME "TheAWS IoTthing name of your board"

配置 Wi-Fi

如果您的主板通过 Wi-Fi 连接到 Internet，则必须向 FreeRTOS 提供 Wi-Fi 凭证才能连接到网络。如果主板不支持 Wi-Fi，您可以跳过这些步骤。

1. demos/include/aws_clientcredential.h.

2. 为以下 #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

     有效安全类型为：

     • eWiFiSecurityOpen（开放，不安全）

     • eWiFiSecurityWEP（WEP 安全性）

     • eWiFiSecurityWPA（WPA 安全性）

     • eWiFiSecurityWPA2（WPA2 安全）

格式化您的AWS IoT凭证

FreeRTOS 必须AWS IoT将证书和私钥与您注册的内容及其权限策略相关联，才能代表您的设备成功AWS IoT与之通信。

FreeRTOS 是 C 语言项目，证书和私有密钥必须经过专门格式化才能添加到项目中。

1. 在浏览器窗口中，打开 tools/certificate_configuration/CertificateConfigurator.html。

2. 在 Certificate PEM file (证书 PEM 文件) 下，选择您从 AWS IoT 控制台下载的 ID-certificate.pem.crt。

3. 在 Private Key PEM file (私有密钥 PEM 文件) 下，选择您从 AWS IoT 控制台下载的 ID-private.pem.key。

4. 选择 Generate and save aws_clientcredential_keys.h (生成并保存 aws_clientcredential_keys.h)，然后将文件保存到 demos/include 中。这将覆盖目录中的现有文件。

   注意

   仅出于演示目的对证书和私有密钥进行了硬编码。生产级应用程序应将这些文件存储在安全位置。