配置 Amazon IoT 实例集预置插件 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

配置 Amazon IoT 实例集预置插件

Amazon IoT 实例集预置插件提供以下配置参数,当您通过实例集预置安装 Amazon IoT Greengrass Core 软件时,您可以自定义这些参数。

rootPath

用作 Amazon IoT Greengrass Core 软件根目录的文件夹的路径。

awsRegion

实例集预置插件在预置 Amazon 资源时使用的 Amazon Web Services 区域。

iotDataEndpoint

您的 Amazon Web Services 账户的 Amazon IoT 数据端点。

iotCredentialEndpoint

您的 Amazon Web Services 账户的 Amazon IoT 凭证端点。

iotRoleAlias

指向令牌交换 IAM 角色的 Amazon IoT 角色别名。Amazon IoT 凭证提供商担任此角色,以允许 Greengrass 核心设备与 Amazon 服务进行交互。有关更多信息,请参阅 授权核心设备与 Amazon 服务交互

provisioningTemplate

用于预置 Amazon 资源的 Amazon IoT 实例集预置模板。此模板必须指定以下各项:

  • Amazon IoT 事物资源。您可以指定一系列现有事物组,在每台设备联机时为设备部署组件。

  • Amazon IoT 策略资源。此资源可以定义下列属性之一:

    • 现有 Amazon IoT 策略的名称。如果您选择此选项,则根据此模板创建的核心设备使用相同的 Amazon IoT 策略,并且您可以以实例集的形式管理它们的权限。

    • Amazon IoT 策略文档。如果您选择此选项,则根据此模板创建的每台核心设备都使用唯一 Amazon IoT 策略,并且您可以管理每台核心设备的权限。

  • Amazon IoT 证书资源。此证书资源必须使用 AWS::IoT::Certificate::Id 参数将证书附加到核心设备。有关更多信息,请参阅《Amazon IoT 开发人员指南》中的即时预置

有关更多信息,请参阅《Amazon IoT Core 开发人员指南》中的预置模板

claimCertificatePath

您在 provisioningTemplate 中指定的预置模板的预置声明证书的路径。有关更多信息,请参阅《Amazon IoT Core API 参考》中的 CreateProvisioningClaim

claimCertificatePrivateKeyPath

您在 provisioningTemplate 中指定的预置模板的预置声明证书私钥的路径。有关更多信息,请参阅《Amazon IoT Core API 参考》中的 CreateProvisioningClaim

重要

预置声明私钥应始终得到保护,包括在 Greengrass 核心设备上时。我们建议您使用 Amazon CloudWatch 指标和日志来监控滥用迹象,例如未经授权就使用声明证书来预置设备。如果您检测到滥用,请禁用预置声明证书,以使其不能用于设备预置。有关更多信息,请参阅 Amazon IoT Core 开发人员指南 中的 监控Amazon IoT

为帮助您更好地管理设备数量以及 Amazon Web Services 账户中自行注册的设备,您可以在创建实例集预置模板时指定预置前钩子。预置前钩子是一种 Amazon Lambda 函数,用于验证设备在注册期间提供的模板参数。例如,您可以创建一个预置前钩子,根据数据库检查设备 ID,以验证设备是否有权进行预置。有关更多信息,请参阅《Amazon IoT Core 开发人员指南》中的预置前钩子

rootCaPath

Amazon 根证书颁发机构(CA)证书的路径。

templateParameters

(可选)要提供给实例集预置模板的参数映射。有关更多信息,请参阅《Amazon IoT Core 开发人员指南》中的预置模板的参数部分

deviceId

(可选)当实例集预置插件创建与 Amazon IoT 的 MQTT 连接时,用作客户端 ID 的设备标识符。

默认:随机的 UUID。

mqttPort

(可选)用于 MQTT 连接的端口。

默认:8883

proxyUrl

(可选)代理服务器的 URL,格式为 scheme://userinfo@host:port。要使用 HTTPS 代理,您必须使用 1.1.0 版本或更高版本的实例集预置插件。

  • scheme – 方案,必须是 httphttps

    重要

    Greengrass 核心设备必须运行 Greengrass Nucleus v2.5.0 或更高版本才能使用 HTTPS 代理。

    如果您配置 HTTPS 代理,则必须将代理服务器 CA 证书添加到核心设备的 Amazon 根 CA 证书中。有关更多信息,请参阅 使核心设备能够信任代HTTPS理

  • userinfo –(可选)用户名和密码信息。如果您在 url 中指定此信息,则 Greengrass 核心设备将忽略 usernamepassword 字段。

  • host – 代理服务器的主机名或 IP 地址。

  • port –(可选)端口号。如果您未指定端口,则 Greengrass 核心设备将使用以下默认值:

    • http – 80

    • https – 443

proxyUserName

(可选)代理服务器进行身份验证时使用的用户名。

proxyPassword

(可选)代理服务器进行身份验证时使用的用户名。

csrPath

(可选)证书签名请求(CSR)文件的路径,用于通过 CSR 创建设备证书。有关更多信息,请参阅《Amazon IoT Core 开发人员指南》中的通过声明进行预置

csrPrivateKeyPath

(可选,如果声明了 csrPath,则必须提供)用于生成 CSR 的私钥的路径。私钥必须已用于生成 CSR。有关更多信息,请参阅《Amazon IoT Core 开发人员指南》中的通过声明进行预置