使用实例集预调配来预调配没有设备证书的设备

调用 CreateProvisioningTemplate 以创建预调配模板。此 API 返回模板 ARN。有关更多信息，请参阅 设备预调配 MQTT API。

您也可以在AWS IoT控制台中创建队列配置模板。

1. 从导航窗格中，选择连接多个设备下拉菜单。然后，选择连接多个设备。

2. 选择创建预调配模板。

3. 选择最符合您安装流程的配置场景。然后选择下一步。

4. 完成模板工作流程。

创建用作预调配申请证书的证书以及关联的私有密钥。

将这些证书注册到限制证书使用的 IoT 策略AWS IoT并关联该策略。以下示例物联网策略限制使用与此策略关联的证书来预调配设备。

在配置设备时，授予AWS IoT服务权限以创建或更新您账户中的物联网资源和证书。为此，请将AWSIoTThingsRegistration托管策略附加到信任AWS IoT服务委托人的 IAM 角色（称为配置角色）。

制造在其中安全地嵌入了预调配申请证书的设备。

设备AWS IoT Device SDK、Mobile SDK 和 AWS IoT Device Client使用连接设备上安装的AWS IoT配置声明证书并进行身份验证。

设备通过使用以下选项之一获取永久证书和私有密钥。设备将使用证书和密钥进行 future 的所有身份验证AWS IoT。

1. 调用CreateKeysAndCertificate以使用证书颁发机构创建新的AWS证书和私钥。

   Or

2. 调用 CreateCertificateFromCsr 以通过证书签名请求生成证书，这可确保其私有密钥安全。

从设备中，调用 RegisterThing 以向 AWS IoT 注册设备并创建云资源。

实例集预调配服务使用预调配模板来定义和创建云资源，如 IoT 事物。该模板可以指定事物的属性和所属的组。在将新事物添加到事物组之前，事物组必须先存在。

在设备上保存永久证书后，设备必须断开与它使用预调配申请证书发起的会话的连接，并使用此永久证书重新连接。

调CreateProvisioningTemplate用创建配置模板并返回其templateArn和templateName。

创建由信任用户用于启动预调配过程的 IAM 角色。预调配模板仅允许该用户预调配设备。例如：

{
    "Effect": "Allow",
    "Action": [
        "iot:CreateProvisioningClaim"
    ],
    "Resource": [
        "arn:aws:iot:aws-region:aws-account-id:provisioningtemplate/templateName"
    ]
}

在配置设备时，向AWS IoT服务授予创建或更新物联网资源的权限，例如您账户中的东西和证书。为此，您可以将AWSIoTThingsRegistration托管策略附加到信任AWS IoT服务委托人的 IAM 角色（称为配置角色）。

提供识别可信用户的方式，例如为他们提供一个账户，该账户可以对他们进行身份验证，并授权他们与注册其设备所需AWS的 API 操作进行交互。

可信用户登录您的预调配移动应用程序或 Web 服务。

移动应用程序或 Web 应用程序使用 IAM 角色并调用 CreateProvisioningClaim，以从 AWS IoT 获取临时预调配申请证书。

移动应用程序或 Web 应用程序将临时预调配申请证书以及任何必需的配置信息（如 Wi-Fi 凭证）提供给设备。

设备使用临时预调配申请证书，通过 AWS IoT Device SDK、Mobile SDK 和 AWS IoT Device Client 连接到 AWS IoT。

设备在使用临时配置声明证书连接后的五分钟内使用其中一个选项获得永久证书和私钥。AWS IoT设备将使用这些选项返回的证书和密钥进行未来的所有身份验证AWS IoT。

1. 调用CreateKeysAndCertificate以使用证书颁发机构创建新的AWS证书和私钥。

   Or

2. 调用 CreateCertificateFromCsr 以通过证书签名请求生成证书，这可确保其私有密钥安全。

设备调RegisterThing用注册设备AWS IoT并创建云资源。

实例集预调配服务使用预调配模板来定义和创建云资源，如 IoT 事物。该模板可以指定事物的属性和所属的组。在将新事物添加到事物组之前，事物组必须先存在。

在设备上保存永久证书后，设备必须断开与它使用临时预调配申请证书发起的会话的连接，并使用此永久证书重新连接。

创建一个具有定义输入和输出的 Lambda 函数。Lambda 函数高度可自定义，需要 allowProvisioning 和 parameterOverrides 来创建预调配挂钩。有关创建 Lambda 函数的更多信息，请参阅在AWS命令行界AWS Lambda面中使用。

以下是 Lambda 函数输出的示例：

{
  "allowProvisioning": True,
  "parameterOverrides": {
    "incomingKey0": "incomingValue0",
    "incomingKey1": "incomingValue1"
  }
}

AWS IoT使用基于资源的策略来调用 Lambda，因此您必须授AWS IoT予调用 Lambda 函数的权限。

以下示例使用 add-permission 将物联网权限授予您的 Lambda。

aws lambda add-permission \
    --function-name myLambdaFunction \
    --statement-id iot-permission \
    --action lambda:InvokeFunction \
    --principal iot.amazonaws.com

使用create-provisioning-template或update-provisioning-template命令向模板添加预置挂钩。

create-provisioning-template以下 CLI 示例使用创建具有预置挂钩的配置模板：

aws iot create-provisioning-template \
    --template-name myTemplate \
    --provisioning-role-arn arn:aws:iam:us-east-1:1234564789012:role/myRole \
    --template-body file://template.json \
    --pre-provisioning-hook file://hooks.json

此命令的输出如下所示：

{
    "templateArn": "arn:aws:iot:us-east-1:1234564789012:provisioningtemplate/myTemplate",
    "defaultVersionId": 1,
    "templateName": myTemplate
}

您也可以从文件加载参数，而不是将其作为命令行参数值完全键入，以节省时间。有关更多信息，请参阅从文件加载 AWS CLI 参数。下面显示了扩展 JSON 格式的 template 参数：

{
    "Parameters" : {
        "DeviceLocation": {
            "Type": "String"
        }
    },
    "Mappings": {
        "LocationTable": {
            "Seattle": {
                "LocationUrl": "https://example.aws"
            }
        }
    },
    "Resources" : {
        "thing" : {
            "Type" : "AWS::IoT::Thing",
            "Properties" : {
                "AttributePayload" : {
                    "version" : "v1",
                    "serialNumber" : "serialNumber"
                },
                "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]},
                "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]},
                "ThingGroups" : ["widgets", "WA"],
                "BillingGroup": "BillingGroup"
            },
            "OverrideSettings" : {
                "AttributePayload" : "MERGE",
                "ThingTypeName" : "REPLACE",
                "ThingGroups" : "DO_NOTHING"
            }
        },
        "certificate" : {
            "Type" : "AWS::IoT::Certificate",
            "Properties" : {
                "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"},
                "Status" : "Active",
                "ThingPrincipalType" : "EXCLUSIVE_THING"
            }
        },
        "policy" : {
            "Type" : "AWS::IoT::Policy",
            "Properties" : {
                "PolicyDocument" : {
                    "Version": "2012-10-17",		 	 	 
                    "Statement": [{
                        "Effect": "Allow",
                        "Action":["iot:Publish"],
                        "Resource": ["arn:aws:iot:us-east-1:504350838278:topic/foo/bar"]
                    }]
                }
            }
        }
    },
    "DeviceConfiguration": {
        "FallbackUrl": "https://www.example.com/test-site",
        "LocationUrl": {
            "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]}
    }
}

下面显示了扩展 JSON 格式的 pre-provisioning-hook 参数：

{
     "targetArn" : "arn:aws:lambda:us-east-1:765219403047:function:pre_provisioning_test",
     "payloadVersion" : "2020-04-01"
}