View a markdown version of this page

Amazon GameLift Streams 如何使用 IAM - 亚马逊 GameLift 直播

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

Amazon GameLift Streams 如何使用 IAM

在使用 IAM 管理对 Amazon GameLift Streams 的访问权限之前,请了解哪些 IAM 功能可用于亚马逊 GameLift Streams。

您可以在 Amazon GameLift Streams 中使用的 IAM 功能
IAM 功能 亚马逊 GameLift 直播支持

Identity-based 政策

Resource-based 政策

策略操作

策略资源

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

ACL

ABAC(策略中的标签)

局部的。ABAC 仅支持应用程序和直播组。

临时凭证

主体权限

服务角色

Service-linked 角色

要详细了解 Amazon GameLift Streams 和其他 AWS 服务如何与大多数 IAM 功能配合使用,请参阅 IAM 用户指南中的与 I AM 配合使用的AWS 服务。

Identity-based 亚马逊 GameLift 直播政策

支持基于身份的策略:

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

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

Identity-based 亚马逊 GameLift 直播的政策示例

要查看 Amazon GameLift Streams 基于身份的政策示例,请参阅。Identity-based 亚马逊 GameLift 直播的政策示例

Resource-based 亚马逊 GameLift 流媒体内部的政策

支持基于资源的策略:

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

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

Amazon GameLift Streams 的政策行动

支持策略操作:

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

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

Amazon GameLift Streams 中的政策操作在操作前使用以下前缀:

gameliftstreams

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

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

要查看 Amazon GameLift Streams 基于身份的政策示例,请参阅。Identity-based 亚马逊 GameLift 直播的政策示例

Amazon GameLift Streams 的政策资源

支持策略资源:

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

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

"Resource": "*"

直播网址资源 ARN 使用以下格式:

arn:aws:gameliftstreams:region:account-id:streamurl/streamGroupId/streamUrlId

直播网址 ARN 嵌套在其所属的直播组下,直播网址 ID 使用su-前缀。此 ARN 在 API 响应、日志和 CloudTrail 事件中标识直播网址。Amazon GameLift Streams 不使用此 ARN 获得 IAM 资源级权限:您不能在策略Resource元素中使用直播网址 ARN 来授予或拒绝对单个直播网址的访问权限。改为RevokeStreamUrl在直播组级别使用范围CreateStreamUrl和,并使用 Resource set to "*" for ListStreamUrlsGetStreamUrl有关示例,请参阅创建和管理直播网址

要查看 Amazon GameLift Streams 基于身份的政策示例,请参阅。Identity-based 亚马逊 GameLift 直播的政策示例

Amazon GameLift Streams 的政策条件密钥

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

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

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

要查看 Amazon GameLift Streams 基于身份的政策示例,请参阅。Identity-based 亚马逊 GameLift 直播的政策示例

Amazon GameLift Streams 支持以下特定服务的条件密钥:

  • gameliftstreams:RoleArnStartStreamSession 请求RoleArn参数中指定的 IAM 角色的 ARN。使用此条件密钥来限制委托人在启动直播会话时可以传递哪些 IAM 角色。

  • gameliftstreams:ApplicationArn— 在StartStreamSession请求ApplicationIdentifier参数中指定的应用程序的 ARN。

您可以在 IAM 策略中使用这些条件密钥来设置精细的权限。例如,以下策略允许委托人仅在使用特定 IAM 角色时启动直播会话:

{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": "gameliftstreams:StartStreamSession", "Resource": "arn:aws:gameliftstreams:*:123456789012:streamgroup/*", "Condition": { "StringEquals": { "gameliftstreams:RoleArn": "arn:aws:iam::123456789012:role/GameLiftStreams-MyApprovedRole" } } }] }

Amazon GameLift Streams 中的 ACL

支持 ACL:

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

ABAC 与亚马逊 Streams GameLift

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

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

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

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

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

Attribute-based 访问控制 (ABAC) 仅适用于应用程序和流组。无法标记直播网址,因此您无法使用基于标签的条件来控制对直播网址操作的访问权限。将直播 URL 权限范围限定为直播组级别,如所示创建和管理直播网址

在 Amazon GameLift Streams 中使用临时证书

支持临时凭证:

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

Cross-service Amazon GameLift Streams 的主要权限

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

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

创建新的应用程序资源时,Amazon GameLift Streams 使用调用主体的权限访问包含客户应用程序文件的 Amazon S3 存储桶。Amazon GameLift Streams 还对主叫方负责人进行审查,以验证某些跨区域功能(例如多地点直播群组)的选择加入资格。

Amazon GameLift Streams 的服务角色

支持服务角色:

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

警告

更改服务角色的权限可能会中断 Amazon GameLift Streams 的功能。仅在 Amazon GameLift Streams 提供指导时才编辑服务角色。

您可以在启动流会话时传递 IAM 角色以向您的应用程序提供证书。当您使用启动直播会话时RoleArn,Amazon Stre GameLift ams 使用gameliftstreams.amazonaws.com服务主体代入该角色,并为您的应用程序提供短期自动刷新的 AWS 证书。

要使用此功能,请执行以下操作:

  1. 使用允许gameliftstreams.amazonaws.com代入该角色的信任策略创建 IAM 角色。

  2. 向致电的 IAM 委托人授予iam:PassRole权限StartStreamSession

该角色必须与直播组 AWS 账户 相同。Amazon GameLift Streams 不支持跨账户角色或服务相关角色。

有关设置说明,请参阅向流式传输应用程序提供 AWS 凭证

Service-linked 亚马逊 GameLift Streams 的角色

支持服务相关角色:

服务相关角色是一种链接到的服务角色。 AWS 服务该服务可以代入代表您执行操作的角色。 Service-linked 角色显示在您的中 AWS 账户 且归服务所有。IAM 管理员可以查看但不能编辑服务关联角色的权限。

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