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

亚马逊 Pinpoint 是如何使用的 IAM

要使用 Amazon Pinpoint，您 AWS 账户中的用户需要权限才能查看分析数据、创建项目、定义用户群体、部署活动等。如果将移动或 Web 应用程序与 Amazon Pinpoint 集成，则应用程序的用户还需要具有 Amazon Pinpoint 的访问权限。此访问权限允许您的应用向 Amazon Pinpoint 注册端点并报告使用情况数据。要授予对亚马逊 Pinpoint 功能的访问权限，请创建 AWS Identity and Access Management (IAM) 策略，允许亚马逊 Pinpoint IAM 对身份或 Amazon Pinpoint 资源执行操作。

IAM是一项可帮助管理员安全地控制对 AWS 资源的访问的服务。IAM策略包括允许或拒绝特定用户或针对特定资源的特定操作的声明。Amazon Pinpoint 提供了一组操作，您可以在IAM策略中使用这些操作来为亚马逊 Pinpoint 用户和资源指定精细权限。这意味着，您可以授予对 Amazon Pinpoint 的适当级别的访问权限，而不会创建可能会泄漏重要数据或危害资源的过于宽松的策略。例如，您可以向 Amazon Pinpoint 管理员授予不受限制的访问权限，向只需访问特定项目的个人授予只读访问权限。

在使用管理IAM对亚马逊 Pinpoint 的访问权限之前，您应该了解亚马逊 Pinpoint 有哪些IAM功能可供使用。要全面了解 Amazon Pinpoint 和其他 AWS 服务的使用方式IAM，请参阅IAM用户指南IAM中与之配合使用的AWS 服务。

Amazon Pinpoint 基于身份的策略

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

操作

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

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

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

这意味着，策略操作控制用户可以在 Amazon Pinpoint 控制台上执行的操作。它们还可以通过直接使用 AWS SDKs、 AWS Command Line Interface (AWS CLI) 或 Amazon Pinpo APIs int 以编程方式控制用户可以执行的操作。

Amazon Pinpoint 中的策略操作使用以下前缀：

例如，要授予某人查看项目所有细分信息的权限（该操作与 Amazon Pinpoint 中的GetSegments操作相对应）API，请将该mobiletargeting:GetSegments操作包含在他们的策略中。策略语句必须包含 Action 或 NotAction 元素。Amazon Pinpoint 定义了一组自己的操作，以描述您可以使用该服务执行的任务。

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

"Action": [
      "mobiletargeting:action1",
      "mobiletargeting:action2"

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

"Action": "mobiletargeting:Get*"

但作为最佳实践，您应创建遵循最低权限 原则的策略。换句话说，您应创建仅包含执行特定操作所需的权限的策略。

有关可在IAM策略中使用的 Amazon Pinpoint 操作的列表，请参阅。亚马逊 Pinpoint 针对政策采取的行动 IAM

资源

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

ResourceJSON策略元素指定要应用操作的一个或多个对象。语句必须包含 Resource 或 NotResource 元素。最佳做法是，使用资源的 Amazon 资源名称 (ARN) 指定资源。对于支持特定资源类型（称为资源级权限）的操作，您可以执行此操作。

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

"Resource": "*"

例如，mobiletargeting:GetSegments 操作检索与特定 Amazon Pinpoint 项目关联的所有分段的信息。您可以使用以下格式标识项目：ARN

arn:aws:mobiletargeting:${Region}:${Account}:apps/${projectId}

有关格式的更多信息ARNs，请参阅中的 Amazon 资源名称 (ARNs) AWS 一般参考。

在IAM政策中，您可以ARNs为以下类型的 Amazon Pinpoint 资源指定：

例如，要为具有项目 ID 的项目创建政策声明810c7aab86d42fb2b56c8c966example，请使用以下命令ARN：

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/810c7aab86d42fb2b56c8c966example"

要指定属于特定账户的所有项目，请使用通配符 (*)：

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/*"

某些 Amazon Pinpoint 操作（如用于创建资源的某些操作）不能在特定资源上执行。在这些情况下，您必须使用通配符 (*)：

"Resource": "*"

在IAM政策中，您还可以指定以下类型ARNs的 Amazon Pinpoint SMS 和语音资源：

例如，要为具有电话号码 ID 的电话号码创建政策声明，phone-12345678901234567890123456789012请使用以下命令ARN：

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/phone-12345678901234567890123456789012"

要指定属于特定账户的所有电话号码，请使用通配符 (*) 代替电话号码 ID：

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/*"

某些 Amazon Pinpoint SMS 和语音操作不是在特定资源上执行的，例如用于管理支出限制等账户级别设置的操作。在这些情况下，您必须使用通配符 (*)：

"Resource": "*"

某些 Amazon Pinpoint API 操作涉及多个资源。例如，TagResource 操作可以向多个项目添加标签。要在单个语句中指定多个资源，请ARNs用逗号分隔：

"Resource": [
      "resource1",
      "resource2"

要查看 Amazon Pinpoint 资源类型及其列表ARNs，请参阅用户指南中的IAM亚马逊 Pinpoint 定义的资源。要了解您可以为每种资源类型指定哪些操作，请参阅IAM用户指南中的 Amazon Pinpoint 定义的操作。ARN

条件键

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

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

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

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

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

Amazon Pinpoint 定义了自己的一组条件键，同时还支持一些全局条件键。要查看所有 AWS 全局条件键的列表，请参阅《IAM用户指南》中的AWS 全局条件上下文键。要查看亚马逊 Pinpoint 条件键列表，请参阅用户指南中的IAM亚马逊 Pinpoint 条件密钥。要了解您可以使用条件键的操作和资源，请参阅《IAM用户指南》中的 Amazon Pinpoint 定义的操作。

示例

要查看 Amazon Pinpoint 基于身份的策略的示例，请参阅 Amazon Pinpoint 基于身份的策略示例。

Amazon Pinpoint 基于资源的权限策略

基于资源的权限JSON策略是政策文件，用于指定委托人可以对 Amazon Pinpoint 资源执行哪些操作以及在什么条件下可以执行哪些操作。Amazon Pinpoint 支持针对活动、旅程、消息模板（模板）、推荐器模型（推荐器）、项目（应用程序）和分段的基于资源的权限策略。

示例

要查看 Amazon Pinpoint 基于资源的策略的示例，请参阅 Amazon Pinpoint 基于身份的策略示例，

基于 Amazon Pinpoint 标签的授权

您可以将标签与特定类型的 Amazon Pinpoint 资源关联，或将请求中的标签传递给 Amazon Pinpoint。要基于标签控制访问，您需要使用 aws:ResourceTag/${TagKey}、aws:RequestTag/${TagKey} 或 aws:TagKeys 条件键在策略的条件元素中提供标签信息。

有关标记 Amazon Pinpoint 资源的信息（包括IAM示例策略），请参阅。管理 Amazon Pinpoint 资源标签

亚马逊 Pinpoint 角色 IAM

IAM角色是您的 AWS 账户中具有特定权限的实体。

将临时凭证用于 Amazon Pinpoint

您可以使用临时证书通过联合身份登录、代入IAM角色或代入跨账户角色。您可以通过调用 AWS Security Token Service (AWS STS) API 操作（例如AssumeRole或）来获取临时安全证书GetFederationToken。

Amazon Pinpoint 支持使用临时凭证。

服务相关角色

服务相关角色允许 AWS 服务访问其他服务中的资源以代表您完成操作。服务相关角色显示在您的IAM账户中，并归服务所有。IAM管理员可以查看但不能编辑服务相关角色的权限。

Amazon Pinpoint 不使用服务相关角色。

服务角色

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

Amazon Pinpoint 支持使用服务角色。