适用于 Amazon Location Service 的基于

默认情况下，用户和角色没有创建或修改 Amazon Location 资源的权限。他们也无法使用 AWS Management Console、AWS Command Line Interface（AWS CLI）或 AWS API 执行任务。IAM 管理员必须创建 IAM policy，以便为用户和角色授予权限，以对所需资源执行操作。然后，管理员必须为需要这些策略的用户附加这些策略。

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》中的 创建 IAM policy。

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

策略最佳实践

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

• AWS 托管策略及转向最低权限许可入门 - 要开始向用户和工作负载授予权限，请使用 AWS 托管策略来为许多常见使用场景授予权限。您可以在 AWS 账户 中找到这些策略。我们建议通过定义特定于您的使用场景的 AWS 客户管理型策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》中的 AWS 托管策略或工作职能的 AWS 托管策略。

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

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

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

• Require multi-factor authentication（MFA）[需要多重身份验证（MFA）] – 如果您所处的场景要求您的 AWS 账户 中有 IAM 用户或根用户，请启用 MFA 来提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》中的配置受 MFA 保护的 API 访问。

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

使用 Amazon Location

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

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

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

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GeoPowerUser",
      "Effect": "Allow",
      "Action": [
        "geo:*"
      ],
      "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": "*"
        }
    ]
}

在政策中使用亚马逊Location Service 资源

亚马逊Location Service 使用以下资源前缀：

亚马逊位置资源前缀
资源	资源前缀
映射资源	map
放置资源	place-index
路线资源	route-calculator
跟踪资源	tracker
GeoFederseFeder	geofence-collection

使用以下 ARN 语法：

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

有关 ARN 格式的更多信息，请参阅 Amazon Resource Name（ARN）和 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 Location 操作，例如用于创建资源的操作，例如，用于创建资源的操作。在这些情况下，您必须使用通配符 (*)。

  "Resource": "*"

要查看 Amazon Location 资源类型及其 ARN 的列表，请参阅《服务授权参考》中的 Amazon Location Service 定义的资源。要了解您可以在哪些操作中指定每个资源的 ARN，请参阅 Amazon Location Service 定义的操作。

更新设备位置的权限

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

在此示例中，除了授予对 Tracker1 和 Trac ker2 资源的访问权限外，以下策略还授予对 Tracker1 和 Tracker 2 资源使用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/*"
    }
  ]
}

创建地理围栏的政策

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

以下政策授予对收藏进行以下操作的权限：

• 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账户的 geofence 集合中的地理围栏创建只读策略，您需要授予从存储地理围栏的 geofence 集合中读取的操作的访问权限。

以下政策授予对收藏进行以下操作的权限：

• 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 策略以授予使用地理围栏或设备位置的访问权限时，您可以使用条件运算符更精确地控制用户可以访问哪些地理围栏或设备。您可以通过在策略Condition元素中包含地理围栏 ID 或设备 ID 来实现此目的。

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

{
  "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 策略以授予使用您的 Amazon L ocation 资源的访问权限时，您可以使用基于属性的访问控制来更好地控制用户可以修改、使用或删除哪些资源。为此，您可以将标签信息包含在策略Condition元素中，以根据资源标签控制访问权限。

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

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

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

但是，只有在集合标签具有该用户的用户名值时Owner，此策略才使用该Condition元素来授予权限。

• 例如，如果名为的用户richard-roe尝试查看 Amazon Location Co llection Collection，则必须将该集合标记为Owner=richard-roe或owner=richard-roe。否则，用户将被拒绝访问。

  注意

  条件标签键 Owner 匹配 Owner 和 owner，因为条件键名称不区分大小写。有关更多信息，请参阅《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用户指南。