用于 AWS Identity and Access Management 进行身份验证 - Amazon Location Service

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

用于 AWS Identity and Access Management 进行身份验证

AWS Identity and Access Management (IAM) AWS 服务 可帮助管理员安全地控制对 AWS 资源的访问权限。IAM 管理员控制谁可以通过身份验证(登录)和获得授权(具有权限)来使用 Amazon Location 资源。您可以使用 IAM AWS 服务 ,无需支付额外费用。

受众

您的使用方式 AWS Identity and Access Management (IAM) 因您的角色而异:

使用身份进行身份验证

身份验证是您 AWS 使用身份凭证登录的方式。您必须以 IAM 用户身份进行身份验证 AWS 账户根用户,或者通过担任 IAM 角色进行身份验证。

您可以使用来自身份源的证书 AWS IAM Identity Center (例如(IAM Identity Center)、单点登录身份验证或 Google/Facebook 证书,以联合身份登录。有关登录的更多信息,请参阅《AWS 登录 用户指南》中的如何登录到您 AWS 账户的。

对于编程访问, AWS 提供 SDK 和 CLI 来对请求进行加密签名。有关更多信息,请参阅 I AM 用户指南中的 API 请求AWS 签名版本 4

AWS 账户 root 用户

创建时 AWS 账户,首先会有一个名为 AWS 账户 root 用户的登录身份,该身份可以完全访问所有资源 AWS 服务 和资源。我们强烈建议您不要使用 root 用户执行日常任务。有关需要根用户证书的任务,请参阅 IAM 用户指南中的需要根用户证书的任务。

联合身份

作为最佳实践,要求人类用户使用与身份提供商的联合身份验证才能 AWS 服务 使用临时证书进行访问。

联合身份是指来自您的企业目录、Web 身份提供商的用户 AWS Directory Service ,或者 AWS 服务 使用来自身份源的凭据进行访问的用户。联邦身份扮演提供临时证书的角色。

对于集中访问管理,我们建议这样做 AWS IAM Identity Center。有关更多信息,请参阅《AWS IAM Identity Center 用户指南》中的什么是 IAM Identity Center?

IAM 用户和群组

I AM 用户是对个人或应用程序具有特定权限的身份。我们建议使用临时证书,而不是拥有长期证书的 IAM 用户。有关更多信息,请参阅 IAM 用户指南中的要求人类用户使用身份提供商的联合身份验证才能 AWS 使用临时证书进行访问

I AM 群组指定 IAM 用户的集合,便于管理大量用户的权限。有关更多信息,请参阅 IAM 用户指南中的 IAM 用户用例

IAM 角色

I AM 角色是具有特定权限的身份,可提供临时证书。您可以通过从用户切换到 IAM 角色(控制台)或调用 AWS CLI 或 AWS API 操作来代入角色。有关更多信息,请参阅《IAM 用户指南》中的担任角色的方法

IAM 角色对于联合用户访问、临时 IAM 用户权限、跨账户访问、跨服务访问以及在 Amazon 上运行的应用程序非常有用。 EC2有关更多信息,请参阅《IAM 用户指南》中的 IAM 中的跨账户资源访问

使用策略管理访问

您可以 AWS 通过创建策略并将其附加到 AWS 身份或资源来控制中的访问权限。策略定义了与身份或资源关联时的权限。 AWS 在委托人提出请求时评估这些政策。大多数策略都以 JSON 文档的 AWS 形式存储在中。有关 JSON 策略文档的更多信息,请参阅 IAM 用户指南中的 JSON 策略概述

管理员使用策略,通过定义哪些委托人可以在什么条件下对哪些资源执行操作来指定谁有权访问什么。

默认情况下,用户和角色没有权限。IAM 管理员创建 IAM 策略并将其添加到角色中,然后用户可以担任这些角色。无论使用何种方法执行操作,IAM 策略都会定义权限。

基于身份的策略

基于身份的策略是您附加到身份(用户、组或角色)的 JSON 权限策略文档。这些策略控制着身份可以执行哪些操作、在哪些资源上以及在什么条件下执行。要了解如何创建基于身份的策略,请参阅《IAM 用户指南》中的使用客户托管策略定义自定义 IAM 权限

基于身份的策略可以是内联策略(直接嵌入到单个身份中)或托管策略(附加到多个身份的独立策略)。要了解如何在托管策略和内联策略之间进行选择,请参阅 IAM 用户指南中的在托管策略和内联策略之间进行选择。

基于资源的策略

基于资源的策略是附加到资源的 JSON 策略文档。示例包括 IAM 角色信任策略和 Amazon S3 存储桶策略。在支持基于资源的策略的服务中,服务管理员可以使用它们来控制对特定资源的访问。您必须在基于资源的策略中指定主体

基于资源的策略是位于该服务中的内联策略。您不能在基于资源的策略中使用 IAM 中的 AWS 托管策略。

其他策略类型

AWS 支持其他策略类型,这些策略类型可以设置更常见的策略类型授予的最大权限:

  • 权限边界-设置基于身份的策略可以向 IAM 实体授予的最大权限。有关更多信息,请参阅《 IAM 用户指南》中的 IAM 实体的权限边界

  • 服务控制策略 (SCPs)-在中指定组织或组织单位的最大权限 AWS Organizations。有关更多信息,请参阅 AWS Organizations 用户指南中的服务控制策略

  • 资源控制策略 (RCPs)-设置账户中资源的最大可用权限。有关更多信息,请参阅《AWS Organizations 用户指南》中的资源控制策略 (RCPs)

  • 会话策略-为角色或联合用户创建临时会话时作为参数传递的高级策略。有关更多信息,请参阅 IAM 用户指南中的会话策略

多个策略类型

当多个类型的策略应用于一个请求时,生成的权限更加复杂和难以理解。要了解在涉及多种策略类型时如何 AWS 确定是否允许请求,请参阅 IAM 用户指南中的策略评估逻辑

Amazon Location Service 如何与 IAM 协同工作

在使用 IAM 管理对 Amazon Location 的访问权限之前,您应该了解哪些 IAM 功能可用于 Amazon Location。

可以与 Amazon Location Service 结合使用的 IAM 功能
IAM 功能 Amazon Location 支持

Amazon Location 基于身份的策略

基于资源的策略

策略操作

策略资源

策略条件键(特定于服务)

ACLs

ABAC(策略中的标签)

临时凭证

主体权限

服务角色

服务相关角色

要全面了解 Amazon Location 和其他 AWS 服务如何与大多数 IAM 功能配合使用,请参阅 IAM 用户指南中与 IAM 配合使用的AWS 服务

Amazon Location 基于身份的策略

支持基于身份的策略:

基于身份的策略是可附加到身份(如 IAM 用户、用户组或角色)的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略,请参阅《IAM 用户指南》中的使用客户管理型策略定义自定义 IAM 权限

通过使用 IAM 基于身份的策略,您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素,请参阅《IAM 用户指南》中的 IAM JSON 策略元素引用

Amazon Location 基于身份的策略示例

要查看 Amazon Location 基于身份的策略的示例,请参阅 Amazon Location Service 基于身份的策略示例

Amazon Location 内基于资源的策略

支持基于资源的策略:

基于资源的策略是附加到资源的 JSON 策略文档。基于资源的策略的示例包括 IAM 角色信任策略和 Amazon S3 存储桶策略。在支持基于资源的策略的服务中,服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源,策略定义指定主体可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中指定主体。委托人可以包括账户、用户、角色、联合用户或 AWS 服务。

要启用跨账户访问,您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的主体。有关更多信息,请参阅《IAM 用户指南》中的 IAM 中的跨账户资源访问

Amazon Location 的策略操作

支持策略操作:

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。

有关 Amazon Location 操作的列表,请参阅《服务授权参考》中的 Amazon Location Service 定义的操作

Amazon Location 中的策略操作在操作前面使用以下前缀:

geo

要在单个语句中指定多项操作,请使用逗号将它们隔开。

"Action": [ "geo:action1", "geo:action2" ]

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

"Action": "geo:Get*"

要查看 Amazon Location 基于身份的策略的示例,请参阅 Amazon Location Service 基于身份的策略示例

Amazon Location 的策略资源

支持策略资源:

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践,请使用其 Amazon 资源名称(ARN)指定资源。对于不支持资源级权限的操作,请使用通配符 (*) 表示该语句适用于所有资源。

"Resource": "*"

要查看亚马逊定位资源类型及其列表 ARNs,请参阅服务授权参考中的 Amazon Location Service 定义的资源。要了解您可以使用哪些操作指定每个资源的 ARN,请参阅 Amazon Location Service 定义的操作

要查看 Amazon Location 基于身份的策略的示例,请参阅 Amazon Location Service 基于身份的策略示例

Amazon Location 的策略条件键

支持特定于服务的策略条件键:

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

Condition元素指定语句何时根据定义的标准执行。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。要查看所有 AWS 全局条件键,请参阅 IAM 用户指南中的AWS 全局条件上下文密钥

要查看 Amazon Location 条件键的列表,请参阅《服务授权参考》中的 Amazon Location Service 的条件键。要了解您可以对哪些操作和资源使用条件键,请参阅 Amazon Location Service 定义的操作

Amazon Location 支持条件键,允许您在政策声明中允许或拒绝访问特定地理围栏或设备。以下条件键可用于:

  • geo:GeofenceIds 用于地理围栏操作。类型是 ArrayOfString

  • geo:DeviceIds 用于跟踪器操作。类型是 ArrayOfString

以下操作可在您的 IAM policy 里与 geo:GeofenceIds 操作配合使用:

  • BatchDeleteGeofences

  • BatchPutGeofences

  • GetGeofence

  • PutGeofence

以下操作可在您的 IAM policy 里与 geo:DeviceIds 操作配合使用:

  • BatchDeleteDevicePositionHistory

  • BatchGetDevicePosition

  • BatchUpdateDevicePosition

  • GetDevicePosition

  • GetDevicePositionHistory

注意

您不能将这些条件键与 BatchEvaluateGeofencesListGeofencesListDevicePosition 操作配合使用。

要查看 Amazon Location 基于身份的策略的示例,请参阅 Amazon Location Service 基于身份的策略示例

ACLs 在 Amazon 位置

支持 ACLs:

访问控制列表 (ACLs) 控制哪些委托人(账户成员、用户或角色)有权访问资源。 ACLs 与基于资源的策略类似,尽管它们不使用 JSON 策略文档格式。

使用 Amazon Location 的 ABAC

支持 ABAC(策略中的标签):

基于属性的访问控制 (ABAC) 是一种授权策略,它根据称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和 AWS 资源,然后设计 ABAC 策略以允许在委托人的标签与资源上的标签匹配时进行操作。

要基于标签控制访问,您需要使用 aws:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 条件键在策略的条件元素中提供标签信息。

如果某个服务对于每种资源类型都支持所有这三个条件键,则对于该服务,该值为。如果某个服务仅对于部分资源类型支持所有这三个条件键,则该值为部分

有关 ABAC 的更多信息,请参阅《IAM 用户指南》中的使用 ABAC 授权定义权限。要查看设置 ABAC 步骤的教程,请参阅《IAM 用户指南》中的使用基于属性的访问权限控制(ABAC)

有关标记 Amazon Location 资源的更多信息,请参阅 如何使用标签

要查看基于身份的策略(用于根据资源上的标签来限制对该资源的访问)的示例,请参阅基于标签控制对资源的访问

将临时凭证用于 Amazon Location

支持临时凭证:

临时证书提供对 AWS 资源的短期访问权限,并且是在您使用联合身份或切换角色时自动创建的。 AWS 建议您动态生成临时证书,而不是使用长期访问密钥。有关更多信息,请参阅 IAM 用户指南中的 IAM 中的临时安全证书以及AWS 服务 与 IAM 配合使用的临时安全证书。

Amazon Location 的跨服务主体权限

支持转发访问会话(FAS):

转发访问会话 (FAS) 使用调用主体的权限 AWS 服务,再加上 AWS 服务 向下游服务发出请求的请求。有关发出 FAS 请求时的策略详情,请参阅转发访问会话

Amazon Location 的服务角色

支持服务角色:

服务角色是由一项服务担任、代表您执行操作的 IAM 角色。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息,请参阅《IAM 用户指南》中的创建向 AWS 服务委派权限的角色

警告

更改服务角色的权限可能会破坏 Amazon Location 的功能。仅当 Amazon Location 提供相关指导时才编辑服务角色。

Amazon Location 的服务相关角色

支持服务相关角色:

服务相关角色是一种与服务相关联的 AWS 服务服务角色。服务可以代入代表您执行操作的角色。服务相关角色出现在您的中 AWS 账户 ,并且归服务所有。IAM 管理员可以查看但不能编辑服务相关角色的权限。

有关创建或管理服务相关角色的详细信息,请参阅能够与 IAM 搭配使用的AWS 服务。在表中查找服务相关角色列中包含 Yes 的表。选择链接以查看该服务的服务相关角色文档。

Amazon Location Service 如何处理未经身份验证的用户

使用 Amazon Location Service 的许多场景,包括在网络上或移动应用程序中显示地图,都需要允许尚未使用 IAM 登录的用户进行访问。对于这些未经身份验证的场景,您有两种选择。

  • 使用 API 密钥 – 要向未经身份验证的用户授予访问权限,您可以创建 API 密钥来授予对您的 Amazon Location Service 资源的只读访问权限。在您不想对每个用户进行身份验证的情况下,这很有用。例如,Web 应用程序。有关 API 密钥的更多信息,请参阅 使用 API 密钥进行身份验证

  • 使用 Amazon Cognito – API 密钥的替代方法是使用 Amazon Cognito 授予匿名访问权限。Amazon Cognito 允许您使用 IAM policy 创建更丰富的授权,以定义未经身份验证的用户可以执行的操作。有关使用 Amazon Cognito 的更多信息,请参阅 在网络中使用 Amazon Cognito 身份池

有关向未经身份验证的用户提供访问权限的概述,请参阅 使用亚马逊 Location Service 进行身份验证

Amazon Location Service 基于身份的策略示例

默认情况下,用户和角色没有创建或修改 Amazon Location 资源的权限。要授予用户对所需资源执行操作的权限,IAM 管理员可以创建 IAM 策略。

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略,请参阅《IAM 用户指南》中的创建 IAM 策略(控制台)

有关 Amazon Location 定义的操作和资源类型(包括每种资源类型的格式)的详细信息,请参阅《服务授权参考》中的 Amazon Location Service 的操作、资源和条件密钥。 ARNs

策略最佳实践

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 Amazon Location 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时,请遵循以下指南和建议:

  • 开始使用 AWS 托管策略并转向最低权限权限 — 要开始向用户和工作负载授予权限,请使用为许多常见用例授予权限的AWS 托管策略。它们在你的版本中可用 AWS 账户。我们建议您通过定义针对您的用例的 AWS 客户托管策略来进一步减少权限。有关更多信息,请参阅《IAM 用户指南》中的 AWS 托管式策略工作职能的AWS 托管式策略

  • 应用最低权限:在使用 IAM 策略设置权限时,请仅授予执行任务所需的权限。为此,您可以定义在特定条件下可以对特定资源执行的操作,也称为最低权限许可。有关使用 IAM 应用权限的更多信息,请参阅《IAM 用户指南》中的 IAM 中的策略和权限

  • 使用 IAM 策略中的条件进一步限制访问权限:您可以向策略添加条件来限制对操作和资源的访问。例如,您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定 AWS 服务的(例如)使用的,则也可以使用条件来授予对服务操作的访问权限 AWS CloudFormation。有关更多信息,请参阅《IAM 用户指南》中的 IAM JSON 策略元素:条件

  • 使用 IAM Access Analyzer 验证您的 IAM 策略,以确保权限的安全性和功能性 – IAM Access Analyzer 会验证新策略和现有策略,以确保策略符合 IAM 策略语言(JSON)和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议,以帮助您制定安全且功能性强的策略。有关更多信息,请参阅《IAM 用户指南》中的使用 IAM Access Analyzer 验证策略

  • 需要多重身份验证 (MFA)-如果 AWS 账户您的场景需要 IAM 用户或根用户,请启用 MFA 以提高安全性。若要在调用 API 操作时需要 MFA,请将 MFA 条件添加到您的策略中。有关更多信息,请参阅《IAM 用户指南》中的使用 MFA 保护 API 访问

有关 IAM 中的最佳实操的更多信息,请参阅《IAM 用户指南》中的 IAM 中的安全最佳实践

使用 Amazon Location 控制

要访问 Amazon Location Service 控制台,您必须具有一组最低的权限。这些权限必须允许您列出和查看有关您的 Amazon Location 资源的详细信息 AWS 账户。如果创建比必需的最低权限更为严格的基于身份的策略,对于附加了该策略的实体(用户或角色),控制台将无法按预期正常运行。

对于仅调用 AWS CLI 或 AWS API 的用户,您无需为其设置最低控制台权限。相反,只允许访问与其尝试执行的 API 操作相匹配的操作。

为确保用户和角色可以使用 Amazon Location 控制台,请将以下策略添加到实体上。有关更多信息,请参阅《IAM 用户指南》中的为用户添加权限

以下政策允许访问 Amazon Location Service 控制台,以便能够在您的 AWS 账户中创建、删除、列出和查看有关 Amazon Location 资源的详细信息。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "GeoPowerUser", "Effect": "Allow", "Action": [ "geo:*", "geo-maps:*", "geo-places:*", "geo-routes:*" ], "Resource": "*" } ] }

或者,您可以授予只读权限以简化只读访问。使用只读权限时,如果用户尝试写入操作(例如创建或删除资源),则会显示一条错误消息。有关示例,请参阅 跟踪器资源的只读策略

允许用户查看他们自己的权限

该示例说明了您如何创建策略,以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用 AWS CLI 或 AWS API 以编程方式完成此操作的权限。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "ViewOwnUserInfo", "Effect": "Allow", "Action": [ "iam:GetUserPolicy", "iam:ListGroupsForUser", "iam:ListAttachedUserPolicies", "iam:ListUserPolicies", "iam:GetUser" ], "Resource": ["arn:aws:iam::*:user/${aws:username}"] }, { "Sid": "NavigateInConsole", "Effect": "Allow", "Action": [ "iam:GetGroupPolicy", "iam:GetPolicyVersion", "iam:GetPolicy", "iam:ListAttachedGroupPolicies", "iam:ListGroupPolicies", "iam:ListPolicyVersions", "iam:ListPolicies", "iam:ListUsers" ], "Resource": "*" } ] }

在策略中使用 Amazon Location Service 资源

Amazon Location Service 对资源使用以下前缀:

Amazon Location 资源前缀
资源 资源前缀
地图资源 map
放置资源 place-index
路线资源 route-calculator
跟踪器资源 tracker
地理围栏集合资源 geofence-collection

使用下面的 ARN 语法:

arn:Partition:geo:Region:Account:ResourcePrefix/ResourceName

有关格式的更多信息 ARNs,请参阅 Amazon 资源名称 (ARNs) 和 AWS 服务命名空间

示例

  • 使用以下 ARN 允许访问指定的地图资源。

    "Resource": "arn:aws:geo:us-west-2:account-id:map/map-resource-name"
  • 要指定对属于特定账户的所有 map 资源的访问,使用通配符(*):

    "Resource": "arn:aws:geo:us-west-2:account-id:map/*"
  • 无法对特定资源执行某些 Amazon Location 操作,例如用于创建资源的操作。在这些情况下,您必须使用通配符 (*)。

    "Resource": "*"

要查看亚马逊定位资源类型及其列表 ARNs,请参阅服务授权参考中的 Amazon Location Service 定义的资源。要了解您可以使用哪些操作指定每个资源的 ARN,请参阅 Amazon Location Service 定义的操作

更新设备位置的权限

要更新多个跟踪器的设备位置,您需要向用户授予访问您的一个或多个跟踪器资源的权限。您还希望允许用户更新一批设备位置。

在此示例中,除了授予对Tracker1Tracker2资源的访问权限外,以下策略还授予对Tracker1Tracker2资源使用geo:BatchUpdateDevicePosition操作的权限。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker1", "arn:aws:geo:us-west-2:account-id:tracker/Tracker2" ] } ] }

如果您想限制用户只能更新特定设备的设备位置,则可以为该设备 ID 添加条件键。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker1", "arn:aws:geo:us-west-2:account-id:tracker/Tracker2" ], "Condition":{ "ForAllValues:StringLike":{ "geo:DeviceIds":[ "deviceId" ] } } } ] }

跟踪器资源的只读策略

要为 AWS 账户中的所有跟踪器资源创建只读政策,您需要授予对所有跟踪器资源的访问权限。您还需要授予用户访问操作的权限,这些操作允许他们获取多台设备的设备位置,从一台设备获取设备位置并获取位置历史记录。

在这个示例中,以下策略授予对以下操作的权限:

  • geo:BatchGetDevicePosition 检索多个设备的位置。

  • geo:GetDevicePosition 检索单个设备的位置。

  • geo:GetDevicePositionHistory 检索设备的位置历史记录。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchGetDevicePosition", "geo:GetDevicePosition", "geo:GetDevicePositionHistory" ], "Resource": "arn:aws:geo:us-west-2:account-id:tracker/*" } ] }

创建地理围栏的策略

要创建允许用户创建地理围栏的策略,您需要向允许用户在地理围栏集合上创建一个或多个地理围栏的特定操作授予访问权限。

以下政策授予对以下操作的权限Collection

  • geo:BatchPutGeofence 创建多个地理围栏。

  • geo:PutGeofence 创建单个地理围栏。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "CreateGeofences", "Effect": "Allow", "Action": [ "geo:BatchPutGeofence", "geo:PutGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection" } ] }

地理围栏的只读策略

要为存储在 AWS 账户地理围栏集合中的地理围栏创建只读策略,您需要授予访问从存储地理围栏的地理围栏集合中读取的操作的访问权限。

以下政策授予对以下操作的权限Collection

  • geo:ListGeofences 列出指定地理围栏集合中的地理围栏。

  • geo:GetGeofence 从地理围栏集合中检索地理围栏集合。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetGeofences", "Effect": "Allow", "Action": [ "geo:ListGeofences", "geo:GetGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection" } ] }

渲染地图资源的权限

要授予足够的权限来渲染地图,你需要授予对地图图块、精灵、字形和样式描述符的访问权限:

  • geo:GetMapTile 检索用于在地图上有选择地渲染要素的地图图块。

  • geo:GetMapSprites 检索 PNG 精灵表和描述其中的偏移量的相应的 JSON 文档。

  • geo:GetMapGlyphs 检索用于显示文本的字形。

  • geo:GetMapStyleDescriptor 检索地图的样式描述符,其中包含渲染规则。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetTiles", "Effect": "Allow", "Action": [ "geo:GetMapTile", "geo:GetMapSprites", "geo:GetMapGlyphs", "geo:GetMapStyleDescriptor" ], "Resource": "arn:aws:geo:us-west-2:account-id:map/Map" } ] }

允许搜索操作的权限

要创建允许搜索操作的政策,您首先需要授予对 AWS 账户中地点索引资源的访问权限。您还需要授予访问权限,这些操作允许用户通过地理编码使用文本进行搜索,并通过反向地理编码使用位置进行搜索。

在此示例中,除了授予访问权限外PlaceIndex,以下策略还授予对以下操作的权限:

  • geo:SearchPlaceIndexForPosition 允许您搜索给定位置附近的地点或兴趣点。

  • geo:SearchPlaceIndexForText 允许您使用自由格式文本搜索地址、名称、城市或地区。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "Search", "Effect": "Allow", "Action": [ "geo:SearchPlaceIndexForPosition", "geo:SearchPlaceIndexForText" ], "Resource": "arn:aws:geo:us-west-2:account-id:place-index/PlaceIndex" } ] }

路线计算器的只读策略

您可以创建只读策略,允许用户访问路线计算器资源来计算路线。

在此示例中,除了授予访问权限外ExampleCalculator,以下策略还授予对以下操作的权限:

  • geo:CalculateRoute 计算给定出发位置、目的地位置和路径点位置列表的路线。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "RoutesReadOnly", "Effect": "Allow", "Action": [ "geo:CalculateRoute" ], "Resource": "arn:aws:geo:us-west-2:accountID:route-calculator/ExampleCalculator" } ] }

根据条件键控制资源访问权限

在创建 IAM policy 以授予使用地理围栏或设备位置的访问权限时,您可以使用条件运算符更精确地控制用户可以访问哪些地理围栏或设备。为此,您可以将地理围栏 ID 或设备 ID 包含在策略的 Condition 元素中。

以下示例策略演示了如何创建允许用户更新特定设备的设备位置的策略。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker" ], "Condition":{ "ForAllValues:StringLike":{ "geo:DeviceIds":[ "deviceId" ] } } } ] }

基于标签控制对资源的访问

当您创建 IAM policy 以授予使用您的 Amazon Location 资源的访问权限时,您可以使用基于属性的访问控制来更好地控制用户可以修改、使用或删除哪些资源。为此,您可以将标签信息包含在策略 Condition 元素中,以便根据资源标签控制访问权限。

以下示例策略演示了如何创建允许用户创建地理围栏的策略。这允许以下操作在名为的地理围栏集合上创建一个或多个地理围栏:Collection

  • geo:BatchPutGeofence 创建多个地理围栏。

  • geo:PutGeofence 创建单个地理围栏。

但是,只有当Collection标签的值为该用户的用户名时Owner,此策略才使用Condition元素来授予权限。

  • 例如,如果名为的用户richard-roe尝试查看 Amazon 地点Collection,则Collection必须将其标记为Owner=richard-roeowner=richard-roe。否则,该用户将被拒绝访问。

    注意

    条件标签键 Owner 匹配 Ownerowner,因为条件键名称不区分大小写。有关更多信息,请参阅 IAM 用户指南 中的 IAM JSON 策略元素:条件

{ "Version": "2012-10-17", "Statement": [ { "Sid": "CreateGeofencesIfOwner", "Effect": "Allow", "Action": [ "geo:BatchPutGeofence", "geo:PutGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection", "Condition": { "StringEquals": {"geo:ResourceTag/Owner": "${aws:username}"} } } ] }

有关如何根据标签定义访问 AWS 资源的权限的教程,请参阅 AWS Identity and Access Management 用户指南

Amazon Location Service 身份和访问权限故障排查

使用以下信息可帮助您诊断和修复在使用 Amazon Location 和 IAM 时可能遇到的常见问题。

我无权在 Amazon Location 中执行操作

如果您收到错误提示,指明您无权执行某个操作,则必须更新策略以允许执行该操作。

mateojackson IAM 用户尝试使用控制台查看有关虚构 my-example-widget 资源的详细信息,但不拥有虚构 geo:GetWidget 权限时,会发生以下示例错误。

User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: geo:GetWidget on resource: my-example-widget

在此情况下,必须更新 mateojackson 用户的策略,以允许使用 geo:GetWidget 操作访问 my-example-widget 资源。

如果您需要帮助,请联系您的 AWS 管理员。您的管理员是提供登录凭证的人。

我无权执行 iam:PassRole

如果您收到一个错误,指明您无权执行 iam:PassRole 操作,则必须更新策略以允许您将角色传递给 Amazon Location。

有些 AWS 服务 允许您将现有角色传递给该服务,而不是创建新的服务角色或服务相关角色。为此,您必须具有将角色传递到服务的权限。

当名为 marymajor 的 IAM 用户尝试使用控制台在 Amazon Location 中执行操作时,会发生以下示例错误。但是,服务必须具有服务角色所授予的权限才可执行此操作。Mary 不具有将角色传递到服务的权限。

User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole

在这种情况下,必须更新 Mary 的策略以允许她执行 iam:PassRole 操作。

如果您需要帮助,请联系您的 AWS 管理员。您的管理员是提供登录凭证的人。

我想允许我以外的人访问我 AWS 账户 的 Amazon Location 资源

您可以创建一个角色,以便其他账户中的用户或您组织外的人员可以使用该角色来访问您的资源。您可以指定谁值得信赖,可以代入角色。对于支持基于资源的策略或访问控制列表 (ACLs) 的服务,您可以使用这些策略向人们授予访问您的资源的权限。

要了解更多信息,请参阅以下内容: