Amazon IoT Greengrass 如何与 IAM 协同工作 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

您正在查看Amazon IoT Greengrass Version 1。Amazon IoT Greengrass Version 2是最新的主要版本Amazon IoT Greengrass。有关使用的更多信息Amazon IoT Greengrass V2,请参阅Amazon IoT Greengrass Version 2开发人员指南

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

Amazon IoT Greengrass 如何与 IAM 协同工作

在您使用 IAM 管理对Amazon IoT Greengrass,您应该了解可与一起使用的 IAM 功能Amazon IoT Greengrass。

有关如何进行操作。Amazon服务与 IAM 配合使用,请参阅Amazon与 IAM 结合使用的服务中的IAM 用户指南

适用于 Amazon IoT Greengrass 的基于身份的策略

使用 IAM 基于身份的策略,您可以指定允许或拒绝的操作和资源和在什么条件下允许或拒绝操作。Amazon IoT Greengrass支持特定的操作、资源和条件键。要了解在策略中使用的所有元素,请参阅IAM JSON 策略元素参考中的IAM 用户指南

Actions

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,这委托人可以执行操作什么是resources,并根据什么条件

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。策略操作通常与关联的 Amazon API 操作同名。有一些例外情况,例如没有匹配 API 操作的仅限权限 操作。还有一些操作要求在策略中执行多个操作。这些附加操作称为相关操作

在策略中包含操作以授予执行相关操作的权限。

Amazon IoT Greengrass 的策略操作在操作前使用 greengrass: 前缀。例如,要允许某人使用ListGroupsAPI 操作来列出其 Amazon Web Services 账户 ,您可以包含greengrass:ListGroups行动在他们的政策。策略语句必须包括 ActionNotAction 元素。Amazon IoT Greengrass 定义了自己的一组操作,这些操作描述了可使用该服务执行的任务。

要在单个语句中指定多项操作,请在方括号中列出这些操作([ ]),并用逗号分隔它们,如下所示:

"Action": [ "greengrass:action1", "greengrass:action2", "greengrass:action3" ]

您可以使用通配符 (*) 指定多个操作。例如,要指定以单词 List 开头的所有操作,包括以下操作:

"Action": "greengrass:List*"
注意

我们建议您避免使用通配符来指定服务的所有可用操作。最佳做法是,您应在策略中授予最低特权和范围狭窄的权限。有关更多信息,请参阅 授予可能的最低权限

有关完整列表Amazon IoT Greengrass操作,请参阅定义的操作Amazon IoT Greengrass中的IAM 用户指南

Resources

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,这委托人可以执行操作什么是resources,并根据什么条件

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。语句必须包含 ResourceNotResource 元素。作为最佳实践,请使用其 Amazon 资源名称 (ARN)指定资源。对于支持特定资源类型(称为资源级权限)的操作,您可以执行此操作。

对于不支持资源级权限的操作(如列出操作),请使用通配符 (*) 指示语句应用于所有资源。

"Resource": "*"

下表包含可在策略语句的 Resource 元素中使用的 Amazon IoT Greengrass 资源 ARN。有关映射受支持的资源级权限Amazon IoT Greengrass操作,请参阅定义的操作Amazon IoT Greengrass中的IAM 用户指南

资源 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 Amazon Web Services 账户 123456789012

"Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

或者,要指定属于 Amazon Web Services 账户 在特定的 Amazon Web Services 区域 ,请使用通配符代替组 ID:

"Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/*"

某些 Amazon IoT Greengrass 操作(例如,某些列表操作)不能在特定资源上执行。在这种情况下,您必须单独使用通配符。

"Resource": "*"

要在语句中指定多个资源 ARN,请在方括号中列出这些资源 ARN([ ]),并用逗号分隔它们,如下所示:

"Resource": [ "resource-arn1", "resource-arn2", "resource-arn3" ]

有关 ARN 格式的详细信息,请参阅Amazon 资源名称 (ARN) 和Amazon服务命名空间中的Amazon Web Services 一般参考

条件键

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,这委托人可以执行操作什么是resources,并根据什么条件

Condition 元素(或 Condition )中,可以指定语句生效的条件。Condition 元素是可选的。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。

如果您在一个语句中指定多个 Condition 元素,或在单个 Condition 元素中指定多个键,则 Amazon 使用逻辑 AND 运算评估。如果您为单个条件键指定多个值,则 Amazon 使用逻辑 OR 运算来评估条件。在授予语句的权限之前必须满足所有的条件。

在指定条件时,您也可以使用占位符变量。例如,只有在使用 IAM 用户名标记 IAM 用户时,您才能为其授予访问资源的权限。有关更多信息,请参阅 。IAM 策略元素:变量和标签中的IAM 用户指南

Amazon 支持全局条件键和特定于服务的条件键。要查看所有 Amazon 全局条件键,请参阅 IAM 用户指南中的 Amazon 全局条件上下文键。

Amazon 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 按请求者的客户端应用程序筛选访问。

有关更多信息,请参阅 。Amazon全局条件上下文键中的IAM 用户指南

Examples

要查看 Amazon IoT Greengrass 基于身份的策略的示例,请参阅适用于 Amazon IoT Greengrass 的基于身份的策略示例

Amazon IoT Greengrass 的基于资源的策略

Amazon IoT Greengrass 不支持基于资源的策略

访问控制列表 (ACL)

Amazon IoT Greengrass 不支持 ACL

基于 Amazon IoT Greengrass 标签的授权

您可以将标签附加到支持的 Amazon IoT Greengrass 资源,或将请求中的标签传递到 Amazon IoT Greengrass。要基于标签控制访问,您需要在条件元素策略中使用aws:ResourceTag/${TagKey}aws:RequestTag/${TagKey},或者aws:TagKeys条件键。有关更多信息,请参阅 给您的 Amazon IoT Greengrass 资源加标签

适用于的 IAM 角色Amazon IoT Greengrass

一个IAM 角色是您的 Amazon Web Services 账户 具有特定权限的。

将临时凭证用于 Amazon IoT Greengrass

临时凭证可用于进行联合身份登录,代入 IAM 角色或代入跨账户角色。您可以通过调用 Amazon STS API 操作(如 AssumeRoleGetFederationToken)获得临时安全凭证。

在 Greengrass 核心上,组角色可供用户定义的 Lambda 函数和连接器使用。如果您的 Lambda 函数使用Amazon开发工具包,您无需添加逻辑即可获取凭证,因为Amazon开发工具包为您执行此操作。

服务相关角色

Amazon IoT Greengrass 不支持服务相关角色

服务角色

此功能允许服务代表您担任服务角色。此角色允许服务访问其他服务中的资源以代表您完成操作。服务角色显示在您的 IAM 账户中,并归该账户所有。这意味着 IAM 管理员可以更改此角色的权限。但是,这样做可能会中断服务的功能。

Amazon IoT Greengrass 使用服务角色代表您访问某些 Amazon 资源。有关更多信息,请参阅 Greengrass 服务角色

在Amazon IoT Greengrass console

在Amazon IoT Greengrass控制台中,您可能需要从账户中的 IAM 角色列表中选择 Greengrass 服务角色或 Greengrass 组角色。

  • Greengrass 服务角色允许 Amazon IoT Greengrass 代表您访问您在其他服务中的 Amazon 资源。通常,您不需要选择服务角色,因为控制台可以为您创建和配置服务角色。有关更多信息,请参阅 Greengrass 服务角色

  • Greengrass 组角色用于允许组中的 Greengrass Lambda 函数和连接器访问您的Amazon资源的费用。它也可以给Amazon IoT Greengrass权限将流导出到Amazon服务并写入 CloudWatch Logs 日志。有关更多信息,请参阅 Greengrass 组角色