本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
事物策略变量
事物策略变量允许您编写基于事物名称、事物类型和事物属性值等事物属性授予或拒绝权限的 Amazon IoT Core 策略。您可以使用事物策略变量来应用相同的策略来控制许多 Amazon IoT Core 设备。有关设备预调配的更多信息,请参阅设备预调配。事物名称是从事物连接到时发送的 MQTT Connect
消息中的客户端 ID 中获取的 Amazon IoT Core。
在 Amazon IoT Core 策略中使用事物策略变量时,请记住以下事项。
-
使用 AttachThingPrincipalAPI 将证书或委托人(经过身份验证的 Amazon Cognito 身份)附加到事物。
-
当您将事物名称替换为事物策略变量时,MQTT 连接消息或 TLS 连接中
clientId
的值必须与事物名称完全匹配。
可用的事物策略变量如下:
-
iot:Connection.Thing.ThingName
这将解析为正在评估策略的 Amazon IoT Core 注册表中事物的名称。 Amazon IoT Core 使用设备在进行身份验证时出示的证书来确定使用哪个东西来验证连接。只有当设备通过协议通过 MQTT 或 MQTT 进行连接时,此策略变量才可用。 WebSocket
-
iot:Connection.Thing.ThingTypeName
它解析为与要评估策略的事物关联的事物类型。MQTT/ WebSocket 连接的客户端 ID 必须与事物名称相同。仅当通过协议通过 MQTT 或 MQTT 进行连接时,此策略变量才可用。 WebSocket
-
iot:Connection.Thing.Attributes[
attributeName
]它解析为与要评估策略的事物关联的指定属性的值。事物最多可以具有 50 个属性。每个属性都作为策略变量提供:
iot:Connection.Thing.Attributes[
,其中attributeName
]attributeName
是属性的名称。MQTT/ WebSocket 连接的客户端 ID 必须与事物名称相同。此策略变量仅在通过 MQTT 或 MQTT 通过协议进行连接时可用。 WebSocket -
iot:Connection.Thing.IsAttached
iot:Connection.Thing.IsAttached: ["true"]
强制规定只有同时在委托人中注册 Amazon IoT 并关联到委托人的设备才能访问策略内的权限。 Amazon IoT Core 如果设备提供的证书未附加到注册表中的物联网事物,则可以使用此变量来阻止其连接 Amazon IoT Core 。此变量具有值true
,false
表示连接对象已使用 API 附加到注册表中的证书或 Amazon Cognito 身份。AttachThingPrincipal事物名称被视为客户端 ID。