AWS IoT Greengrass Version 1 2023 年 6 月 30 日进入延长寿命阶段。有关更多信息,请参阅 AWS IoT Greengrass V1 维护策略。在此日期之后,将 AWS IoT Greengrass V1 不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上面运行的设备 AWS IoT Greengrass V1 不会中断,将继续运行并连接到云端。我们强烈建议您迁移到 AWS IoT Greengrass Version 2,这样可以添加重要的新功能并支持其他平台。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
如何 AWS IoT Greengrass 与 IAM 配合使用
在使用 IAM 管理访问权限之前 AWS IoT Greengrass,您应该了解可与之配合使用的 IAM 功能 AWS IoT Greengrass。
IAM 特征 |
Greengrass 支持吗? |
---|---|
是 | |
否 | |
否 | |
否 | |
是 | |
否 | |
是 |
有关其他 AWS 服务如何与 IAM 配合使用的高级视图,请参阅 IAM 用户指南中的与 IAM 配合使用的AWS 服务。
基于身份的策略 AWS IoT Greengrass
借助 IAM 基于身份的策略,您可以指定允许或拒绝的操作和资源,以及允许或拒绝操作的条件。 AWS IoT Greengrass 支持特定的操作、资源和条件键。要了解您在策略中使用的所有元素,请参阅 IAM 用户指南中的 IAM JSON 策略元素参考。
操作
管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。
JSON 策略的 Action
元素描述可用于在策略中允许或拒绝访问的操作。策略操作通常与关联的 AWS API 操作同名。有一些例外情况,例如没有匹配 API 操作的仅限权限 操作。还有一些操作需要在策略中执行多个操作。这些附加操作称为相关操作。
在策略中包含操作以授予执行关联操作的权限。
策略操作在操作前 AWS IoT Greengrass 使用greengrass:
前缀。例如,要允许某人使用 ListGroups
API 操作列出其中的群组 AWS 账户,您可以将该greengrass:ListGroups
操作包含在他们的策略中。策略语句必须包括 Action
或 NotAction
元素。 AWS IoT Greengrass 定义了自己的一组操作,这些操作描述了可使用该服务执行的任务。
要在单个语句中指定多项操作,请在方括号 ([
]
) 中列出这些操作,并用逗号将它们分隔开,如下所示:
"Action": [
"greengrass:action1
",
"greengrass:action2
",
"greengrass:action3
"
]
您可以使用通配符 (*
) 指定多个操作。例如,要指定以单词 List
开头的所有操作,包括以下操作:
"Action": "greengrass:List*"
注意
我们建议您避免使用通配符来指定服务的所有可用操作。最佳做法是,您应在策略中授予最低特权和范围狭窄的权限。有关更多信息,请参阅 授予可能的最低权限。
有关 AWS IoT Greengrass 操作的完整列表,请参阅 IAM 用户指南 AWS IoT Greengrass中的定义操作。
资源
管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。
Resource
JSON 策略元素指定要向其应用操作的一个或多个对象。语句必须包含 Resource
或 NotResource
元素。作为最佳实践,请使用其 Amazon 资源名称(ARN)指定资源。对于支持特定资源类型(称为资源级权限)的操作,您可以执行此操作。
对于不支持资源级权限的操作(如列出操作),请使用通配符(*)指示语句应用于所有资源。
"Resource": "*"
下表 ARNs 包含可在策略声明Resource
元素中使用的 AWS IoT Greengrass 资源。有关 AWS IoT Greengrass 操作支持的资源级权限的映射,请参阅 IAM 用户指南 AWS IoT Greengrass中由定义的操作。
资源 | ARN |
---|---|
Group |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}
|
GroupVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}/versions/${VersionId}
|
CertificateAuthority |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}/certificateauthorities/${CertificateAuthorityId}
|
Deployment |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}/deployments/${DeploymentId}
|
BulkDeployment |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/bulk/deployments/${BulkDeploymentId}
|
ConnectorDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/connectors/${ConnectorDefinitionId}
|
ConnectorDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/connectors/${ConnectorDefinitionId}/versions/${VersionId}
|
CoreDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/cores/${CoreDefinitionId}
|
CoreDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/cores/${CoreDefinitionId}/versions/${VersionId}
|
DeviceDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/devices/${DeviceDefinitionId}
|
DeviceDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/devices/${DeviceDefinitionId}/versions/${VersionId}
|
FunctionDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/functions/${FunctionDefinitionId}
|
FunctionDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/functions/${FunctionDefinitionId}/versions/${VersionId}
|
LoggerDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/loggers/${LoggerDefinitionId}
|
LoggerDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/loggers/${LoggerDefinitionId}/versions/${VersionId}
|
ResourceDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/resources/${ResourceDefinitionId}
|
ResourceDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/resources/${ResourceDefinitionId}/versions/${VersionId}
|
SubscriptionDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/subscriptions/${SubscriptionDefinitionId}
|
SubscriptionDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/subscriptions/${SubscriptionDefinitionId}/versions/${VersionId}
|
ConnectivityInfo |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
|
以下示例Resource
元素指定了位于美国西部(俄勒冈)地区的群组的 ARN: AWS 账户 123456789012
"Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
或者,要指定属于特定群组的所有群组 AWS 区域,请使用通配符代替群组 ID: AWS 账户
"Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/*"
某些 AWS IoT Greengrass 操作(例如,某些列表操作)无法对特定资源执行。在这种情况下,您必须单独使用通配符。
"Resource": "*"
要在语句 ARNs 中指定多个资源,请将它们列在方括号 ([
]
) 之间,并用逗号分隔,如下所示:
"Resource": [
"resource-arn1
",
"resource-arn2
",
"resource-arn3
"
]
有关 ARN 格式的更多信息,请参阅中的 A mazon 资源名称 (ARNs) 和 AWS 服务命名空间。Amazon Web Services 一般参考
条件键
管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。
在 Condition
元素(或 Condition
块)中,可以指定语句生效的条件。Condition
元素是可选的。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。
如果您在一个语句中指定多个 Condition
元素,或在单个 Condition
元素中指定多个键,则 AWS 使用逻辑 AND
运算评估它们。如果您为单个条件键指定多个值,则使用逻辑OR
运算来 AWS 评估条件。在授予语句的权限之前必须满足所有的条件。
在指定条件时,您也可以使用占位符变量。例如,只有在使用 IAM 用户名标记 IAM 用户时,您才能为其授予访问资源的权限。有关更多信息,请参阅《IAM 用户指南》中的 IAM 策略元素:变量和标签。
AWS 支持全局条件密钥和特定于服务的条件密钥。要查看所有 AWS 全局条件键,请参阅 IAM 用户指南中的AWS 全局条件上下文密钥。
AWS IoT Greengrass 支持以下全局条件键。
键 | 描述 |
---|---|
aws:CurrentTime |
检查当前日期和时间的日期/时间条件以筛选访问。 |
aws:EpochTime |
检查当前日期和时间(纪元或 Unix 时间)的日期/时间条件以筛选访问。 |
aws:MultiFactorAuthAge |
检查使用 Multi-Factor Authentication (MFA) 颁发请求中的 MFA 验证的安全凭证之前经过的时间(以秒为单位)以筛选访问。 |
aws:MultiFactorAuthPresent |
检查是否使用 Multi-Factor Authentication (MFA) 验证发出当前请求的临时安全凭证以筛选访问。 |
aws:RequestTag/${TagKey} |
根据每个必需标签的允许值集筛选创建请求。 |
aws:ResourceTag/${TagKey} |
根据与资源关联的标签值筛选操作。 |
aws:SecureTransport |
检查是否使用 SSL 发送请求以筛选访问。 |
aws:TagKeys |
根据在请求中是否具有必需标签以筛选创建请求。 |
aws:UserAgent |
按请求者的客户端应用程序筛选访问。 |
有关更多信息,请参阅《IAM 用户指南》中的 AWS 全局条件上下文键。
示例
要查看 AWS IoT Greengrass 基于身份的策略的示例,请参阅。适用于 AWS IoT Greengrass的基于身份的策略示例
基于资源的政策 AWS IoT Greengrass
AWS IoT Greengrass 不支持基于资源的策略。
访问控制列表 (ACLs)
AWS IoT Greengrass 不支持ACLs。
基于 AWS IoT Greengrass 标签的授权
AWS IoT Greengrass 不支持基于标签的授权。
的 IAM 角色适用于 AWS IoT Greengrass
I AM 角色是您内部具有特定权限 AWS 账户 的实体。
将临时凭证与 AWS IoT Greengrass
临时凭证可用于进行联合身份登录,代入 IAM 角色或代入跨账户角色。您可以通过调用AssumeRole或之类的 AWS STS API 操作来获取临时安全证书GetFederationToken。
在 Greengrass 核心上,组角色的临时凭证可供用户定义的 Lambda 函数和连接器使用。如果您的 Lambda 函数使用 AWS 软件开发工具包,则无需添加逻辑即可获取证书,因为 AWS 软件开发工具包会为您执行此操作。
服务相关角色
AWS IoT Greengrass 不支持服务相关角色。
服务角色
此功能允许服务代表您担任服务角色。此角色允许服务访问其他服务中的资源以代表您完成操作。服务角色显示在 IAM 账户中,并归该账户所有。这意味着,IAM 管理员可以更改该角色的权限。但是,这样做可能会中断服务的功能。
AWS IoT Greengrass 使用服务角色代表您访问您的部分 AWS 资源。有关更多信息,请参阅 Greengrass 服务角色。
在 AWS IoT Greengrass 控制台中选择 IAM 角色
在 AWS IoT Greengrass 控制台中,您可能需要从账户中的 IAM 角色列表中选择一个 Greengrass 服务角色或 Greengrass 群组角色。
-
Greengrass 服务角色 AWS IoT Greengrass 允许您代表您在其他服务中访问 AWS 您的资源。通常,您不需要选择服务角色,因为控制台可以为您创建和配置服务角色。有关更多信息,请参阅 Greengrass 服务角色。
-
Greengrass 群组角色用于允许群组中的 Greengrass Lambda 函数和连接器访问您的资源。 AWS 它还可以授予将流导出到 AWS 服务和写入 CloudWatch 日志的 AWS IoT Greengrass 权限。有关更多信息,请参阅 Greengrass 组角色。