受众使用身份进行身份验证使用策略管理访问如何 AWS Cloud9 与 IAM 配合使用基于身份的策略示例故障排查如何 AWS Cloud9 使用 IAM 资源和操作 AWS 托管策略为创建客户托管策略 AWS Cloud9 AWS Cloud9 权限参考 AWS 托管的临时证书

适用于 Identity and Access Managem AWS Cloud9

AWS Identity and Access Management (IAM) AWS 服务可帮助管理员安全地控制对 AWS 资源的访问权限。IAM 管理员控制谁可以进行身份验证（登录）和授权（拥有权限）使用 AWS Cloud9 资源。您可以使用 IAM AWS 服务，无需支付额外费用。

受众

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

服务用户：如果您无法访问功能，请从管理员处请求权限（请参阅对 AWS Cloud9 身份和访问进行故障排除）
服务管理员：确定用户访问权限并提交权限请求（请参阅如何 AWS Cloud9 与 IAM 配合使用）
IAM 管理员：编写用于管理访问权限的策略（请参阅 AWS Cloud9基于身份的策略示例）

使用身份进行身份验证

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

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

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

AWS 账户 root 用户

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

联合身份

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

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

要集中管理访问权限，建议使用 AWS IAM Identity Center。有关更多信息，请参阅《AWS IAM Identity Center 用户指南》中的什么是 IAM Identity Center？。

IAM 用户和群组

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

IAM 组指定一组 IAM 用户，便于更轻松地对大量用户进行权限管理。有关更多信息，请参阅《IAM 用户指南》中的 IAM 用户的使用案例。

IAM 角色

IAM 角色是具有特定权限的身份，可提供临时凭证。您可以通过从用户切换到 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 用户指南中的策略评估逻辑。

如何 AWS Cloud9 与 IAM 配合使用

在使用 IAM 管理访问权限之前 AWS Cloud9，请先了解哪些可用的 IAM 功能 AWS Cloud9。

您可以搭配使用的 IAM 功能 AWS Cloud9
IAM 功能	AWS Cloud9 支持
基于身份的策略	是
基于资源的策略	否
策略操作	是
策略资源	是
策略条件键（特定于服务）	是
ACLs	否
ABAC（策略中的标签）	是
临时凭证	是
转发访问会话（FAS）	是
服务角色	是
服务相关角色	是

要全面了解 AWS Cloud9 以及其他 AWS 服务如何与大多数 IAM 功能配合使用，请参阅 IAM 用户指南中的与 IAM 配合使用的AWS 服务。

基于身份的策略 AWS Cloud9

支持基于身份的策略：是

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

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

基于身份的策略示例 AWS Cloud9

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

内部基于资源的政策 AWS Cloud9

支持基于资源的策略：否

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

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

AWS Cloud9 不支持基于资源的策略，但您仍然可以通过 AWS Cloud9 API 和 AWS Cloud9 IDE 控制 AWS Cloud9 AWS Cloud9 环境成员的环境资源权限。

的政策行动 AWS Cloud9

支持策略操作：是

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

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

要查看 AWS Cloud9 操作列表，请参阅《服务授权参考》 AWS Cloud9中定义的操作。

正在执行的策略操作在操作前 AWS Cloud9 使用以下前缀：


account

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


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

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

的政策资源 AWS Cloud9

支持策略资源：是

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

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


"Resource": "*"

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

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

的策略条件密钥 AWS Cloud9

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

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

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

要查看 AWS Cloud9 条件键列表，请参阅《服务授权参考》 AWS Cloud9中的条件密钥。要了解可以使用条件键的操作和资源，请参阅由定义的操作 AWS Cloud9。

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

ACLs in AWS Cloud9

支持 ACLs：否

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

ABAC with AWS Cloud9

支持 ABAC（策略中的标签）：是

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

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

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

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

将临时证书与 AWS Cloud9

支持临时凭证：是

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

转发访问会话 AWS Cloud9

支持转发访问会话（FAS）：是

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

AWS Cloud9的服务角色

支持服务角色：是

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

警告

更改服务角色的权限可能会中断 AWS Cloud9 功能。只有在 AWS Cloud9 提供操作指导时才编辑服务角色。

的服务相关角色 AWS Cloud9

支持服务相关角色：是

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

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

AWS Cloud9基于身份的策略示例

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

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

有关由 AWS Cloud9定义的操作和资源类型（包括每种资源类型的格式）的详细信息，请参阅《服务授权参考》 AWS Cloud9中的操作、资源和条件密钥。 ARNs

主题

策略最佳实践
使用 AWS Cloud9 控制台
允许用户查看他们自己的权限

策略最佳实践

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

开始使用 AWS 托管策略并转向最低权限权限 — 要开始向用户和工作负载授予权限，请使用为许多常见用例授予权限的AWS 托管策略。它们在你的版本中可用 AWS 账户。我们建议您通过定义针对您的用例的 AWS 客户托管策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》中的 AWS 托管式策略或工作职能的AWS 托管式策略。
应用最低权限：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为最低权限许可。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》中的 IAM 中的策略和权限。
使用 IAM 策略中的条件进一步限制访问权限：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定的方式使用的，则也可以使用条件来授予对服务操作的访问权限 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 中的安全最佳实操。

使用 AWS Cloud9 控制台

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

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

为确保用户和角色仍然可以使用 AWS Cloud9 控制台，还需要将 AWS Cloud9 ConsoleAccess或ReadOnly AWS 托管策略附加到实体。有关更多信息，请参阅《IAM 用户指南》中的为用户添加权限。

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

该示例说明了您如何创建策略，以允许 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": "*"
        }
    ]
}

对 AWS Cloud9 身份和访问进行故障排除

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

主题

我无权在以下位置执行操作 AWS Cloud9
我无权执行 iam：PassRole
我想允许我以外的人 AWS 账户访问我的 AWS Cloud9 资源

我无权在以下位置执行操作 AWS Cloud9

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

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

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

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

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

我无权执行 iam：PassRole

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

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

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


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

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

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

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

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

要了解更多信息，请参阅以下内容：

要了解是否 AWS Cloud9 支持这些功能，请参阅如何 AWS Cloud9 与 IAM 配合使用。
要了解如何提供对您拥有的资源的访问权限 AWS 账户，请参阅 IAM 用户指南中的向您拥有 AWS 账户的另一个 IAM 用户提供访问权限。
要了解如何向第三方提供对您的资源的访问权限 AWS 账户，请参阅 IAM 用户指南中的向第三方提供访问权限。 AWS 账户
要了解如何通过身份联合验证提供访问权限，请参阅《IAM 用户指南》中的为经过外部身份验证的用户（身份联合验证）提供访问权限。
要了解使用角色和基于资源的策略进行跨账户访问之间的差别，请参阅《IAM 用户指南》中的 IAM 中的跨账户资源访问。

如何 AWS Cloud9 使用 IAM 资源和操作

AWS Identity and Access Management 用于管理允许您同时使用 AWS Cloud9 开发环境以及其他 AWS 服务和资源的权限。

AWS Cloud9 资源和运营

在中 AWS Cloud9，主要资源是 AWS Cloud9 开发环境。在策略中，您可以使用 Amazon 资源名称（ARN）标识策略应用到的资源。下表列出了环境 ARNs。有关更多信息，请参阅中的 Amazon 资源名称 (ARNs) 和 AWS 服务命名空间。Amazon Web Services 一般参考

资源类型	ARN 格式
环境	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`
指定 AWS 区域中的指定账户拥有的每个环境	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:*`
指定区域中的指定账户拥有的每个环境	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:*`
每种 AWS Cloud9 资源，无论账户和地区如何	`arn:aws:cloud9:*`

例如，您可以在语句中使用 Amazon 资源名称（ARN）指示特定的环境，如下所示。


"Resource": "arn:aws:cloud9:us-east-2:123456789012:environment:70d899206236474f9590d93b7c41dfEX"

要指定所有资源，请在 Resource 元素中使用通配符（*）。


"Resource": "*"

要在单个语句中指定多个资源，请用逗号分隔它们的 Amazon 资源名称 (ARNs)。


"Resource": [
  "arn:aws:cloud9:us-east-2:123456789012:environment:70d899206236474f9590d93b7c41dfEX",
  "arn:aws:cloud9:us-east-2:123456789012:environment:81e900317347585a0601e04c8d52eaEX"
]

AWS Cloud9 提供了一组使用 AWS Cloud9 资源的操作。有关列表，请参阅 AWS Cloud9 权限参考。

了解资源所有权

该 AWS 账户账户拥有在账户中创建的资源，无论谁创建了这些资源。

请考虑以下使用案例和场景：

假设您使用您的 AWS 账户根账户证书创建 AWS Cloud9 开发环境。尽管可能，但不建议这样做。在这种情况下，您 AWS 账户就是环境的所有者。
假设您在中创建了一个 IAM 用户， AWS 账户并向该用户授予了创建环境的权限。然后，用户可以创建环境。但是，用户所属的您 AWS 账户仍然拥有该环境。
假设您在中创建了一个 AWS 账户拥有创建环境权限的 IAM 角色。然后，可以代入该角色的任何人都可以创建环境。角色所属的 AWS 账户拥有此环境。

注意

如果您删除一个或多个 AWS Cloud9 环境的 ARN 所有者的用户账户，则这些环境将没有所有者。这种情况的解决方法是使用 AWS Cloud9 软件开发工具包通过CreateEnvironmentMembership操作和EnvironmentMember数据类型添加另一位具有读写权限的 IAM 用户。添加此 IAM 用户后，您可以将环境文件复制到新 AWS Cloud9 环境中，并将该所有者设为 ARN 所有者。有关此操作的更多信息 CreateEnvironmentMembership，请参阅；有关此数据类型的更多信息，请参阅 AWS Cloud9 API 参考指南EnvironmentMember中的。

管理对资源的访问

权限策略规定谁可以访问哪些资源。

注意

本节讨论如何在 AWS Cloud9中使用 IAM。这里不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档，请参阅 IAM 用户指南中的什么是 IAM？。有关 IAM 策略语法和说明的信息，请参阅 IAM 用户指南中 IAM JSON 策略参考。

附加到 IAM 身份的策略称为基于身份的策略（或 IAM 策略）。附加到资源的策略称为基于资源的策略。 AWS Cloud9 支持基于身份和基于资源的策略。

以下各项 API 操作仅要求将一个 IAM 策略附加到要调用这些 API 操作的 IAM 身份：

CreateEnvironmentEC2
DescribeEnvironments

以下 API 操作需要使用基于资源的策略。IAM 策略不是必需的，但如果它附加到想要调 AWS Cloud9 用这些 API 操作的 IAM 身份，则使用 IAM 策略。基于资源的策略必须应用于所需的 AWS Cloud9 资源：

CreateEnvironmentMembership
DeleteEnvironment
DeleteEnvironmentMembership
DescribeEnvironmentMemberships
DescribeEnvironmentStatus
UpdateEnvironment
UpdateEnvironmentMembership

有关每个 API 操作执行的任务的更多信息，请参阅《AWS Cloud9 API 参考》。

您不能将基于资源的策略直接附加到 AWS Cloud9 资源。相反，在添加、修改、更新或删除环境成员时，将相应的基于 AWS Cloud9 资源的策略 AWS Cloud9 附加到资源。

要向用户授予对 AWS Cloud9 资源执行操作的权限，您需要向该用户所属的 IAM 群组附加权限策略。我们建议您 AWS Cloud9 尽可能为其附加 AWS 托管（预定义）策略。 AWS 托管策略包含针对常见使用场景和用户类型的预定义访问权限集，例如对环境的全面管理、环境用户以及对环境只有只读访问权限的用户。有关 AWS 托管策略的列表 AWS Cloud9，请参阅AWS 的托管策略 AWS Cloud9。

对于更详细的使用方案和独特的用户类型，您可以创建并附加自己的客户托管式策略。请参阅 AWS Cloud9的其他设置选项和为创建客户托管策略 AWS Cloud9。

要将 IAM 策略（AWS 托管或客户托管）附加到 IAM 身份，请参阅 IAM 用户指南中的附加 IAM 策略（控制台）。

API 操作的会话权限

使用 AWS CLI 或 AWS API 以编程方式为角色或联合用户创建临时会话时，您可以将会话策略作为参数传递以扩展角色会话的范围。这意味着会话的有效权限是角色基于身份的策略与会话策略的交集。

在会话期间请求访问资源时，如果没有适用的 Deny 语句，也没有适用的 Allow 语句，则策略评估的结果是隐式拒绝。（有关更多信息，请参阅 IAM 用户指南中的确定账户内请求是否被允许或拒绝。）

但是，对于需要基于资源的策略的 AWS Cloud9 API 操作（见上文），如果资源策略Principal中指定为，则会向正在调用的 IAM 实体授予权限。此显式权限优先于隐式拒绝会话策略，从而允许会话成功调用 AWS Cloud9 API 操作。

AWS 的托管策略 AWS Cloud9

AWS 托管策略是由创建和管理的独立策略 AWS。 AWS 托管策略旨在为许多常见用例提供权限，以便您可以开始为用户、组和角色分配权限。

请记住， AWS 托管策略可能不会为您的特定用例授予最低权限权限，因为它们可供所有 AWS 客户使用。我们建议通过定义特定于您的使用场景的客户管理型策略来进一步减少权限。

您无法更改 AWS 托管策略中定义的权限。如果 AWS 更新 AWS 托管策略中定义的权限，则更新会影响该策略所关联的所有委托人身份（用户、组和角色）。 AWS 最有可能在启动新的 API 或现有服务可以使用新 AWS 服务的 API 操作时更新 AWS 托管策略。

有关更多信息，请参阅《IAM 用户指南》中的 AWS 托管式策略。

AWS 托管策略： AWSCloud9管理员

您可以将 AWSCloud9Administrator 策略附加到 IAM 身份。

此策略授予提供管理员访问administrative权限的权限 AWS Cloud9。

权限详细信息

该策略包含以下权限。

AWS Cloud9 — 所有 AWS Cloud9 动作都在他们身上 AWS 账户。
亚马逊 EC2 — 获取有关其中的多个 Amazon VPC 和子网资源的信息 AWS 账户。
IAM — 获取有关其中的 IAM 用户的信息 AWS 账户，并根据需要在他们 AWS 账户中创建 AWS Cloud9 服务相关角色。
Systems Manager-允许用户 StartSession 通过呼叫启动与实例的连接以进行会话管理器会话。打开通过 Systems Manager 与其 EC2 实例通信的环境的用户需要此权限。有关更多信息，请参阅使用访问无入口实例 EC2 AWS Systems Manager。

AWS 托管策略： AWSCloud9用户

您可以将 AWSCloud9User 策略附加到 IAM 身份。

此政策授予创建 AWS Cloud9 开发环境和管理自有环境的user权限。

权限详细信息

该策略包含以下权限。

AWS Cloud9 — 创建和获取有关其环境的信息，以及获取和更改其环境的用户设置。
亚马逊 EC2 — 获取有关其中的多个 Amazon VPC 和子网资源的信息 AWS 账户。
IAM — 获取有关其中的 IAM 用户的信息 AWS 账户，并根据需要在他们 AWS 账户中创建 AWS Cloud9 服务相关角色。
Systems Manager-允许用户 StartSession 通过呼叫启动与实例的连接以进行会话管理器会话。打开通过 Systems Manager 与其 EC2 实例通信的环境的用户需要此权限。有关更多信息，请参阅使用访问无入口实例 EC2 AWS Systems Manager。

JSON


{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:UpdateUserSettings",
                "cloud9:GetUserSettings",
                "iam:GetUser",
                "iam:ListUsers",
                "ec2:DescribeVpcs",
                "ec2:DescribeSubnets",
                "ec2:DescribeInstanceTypeOfferings",
                "ec2:DescribeRouteTables"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:CreateEnvironmentEC2",
                "cloud9:CreateEnvironmentSSH"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "cloud9:OwnerArn": "true"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:GetUserPublicKey"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "cloud9:UserArn": "true"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:DescribeEnvironmentMemberships"
            ],
            "Resource": [
                "*"
            ],
            "Condition": {
                "Null": {
                    "cloud9:UserArn": "true",
                    "cloud9:EnvironmentId": "true"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "iam:AWSServiceName": "cloud9.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:StartSession",
                "ssm:GetConnectionStatus"
            ],
            "Resource": "arn:aws:ec2:*:*:instance/*",
            "Condition": {
                "StringLike": {
                    "ssm:resourceTag/aws:cloud9:environment": "*"
                },
                "StringEquals": {
                    "aws:CalledViaFirst": "cloud9.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:StartSession"
            ],
            "Resource": [
                "arn:aws:ssm:*:*:document/*"
            ]
        }
    ]
}

AWS 托管策略： AWSCloud9EnvironmentMember

您可以将 AWSCloud9EnvironmentMember 策略附加到 IAM 身份。

此策略授予允许加入 AWS Cloud9 共享环境的membership权限。

权限详细信息

该策略包含以下权限：

AWS Cloud9 — 获取有关其环境的信息，并获取和更改其环境的用户设置。
IAM — 获取有关其中的 IAM 用户的信息 AWS 账户，并根据需要在他们 AWS 账户中创建 AWS Cloud9 服务相关角色。
Systems Manager-允许用户 StartSession 通过呼叫启动与实例的连接以进行会话管理器会话。打开通过 Systems Manager 与其 EC2 实例通信的环境的用户需要此权限。有关更多信息，请参阅使用访问无入口实例 EC2 AWS Systems Manager。

AWS 托管策略：`AWSCloud9ServiceRolePolicy`

服务相关角色AWSServiceRoleForAWSCloud9使用此策略允许 AWS Cloud9 环境与 Amazon EC2 和 CloudFormation 资源进行交互。

权限详细信息

AWSCloud9ServiceRolePolicy授予 AWSServiceRoleForAWSCloud9创建和运行开发环境所需的 AWS 服务（Amazon EC2 和 CloudFormation）交互所需的权限。 AWS Cloud9

AWS Cloud9 定义其服务相关角色的权限，并且 AWS Cloud9 只能担任其角色。定义的权限包括信任策略和权限策略，而且权限策略不能附加到任何其他 IAM 实体。

有关如何 AWS Cloud9 使用服务相关角色的更多信息，请参阅将服务相关角色用于 AWS Cloud9。

JSON


{
	"Version":"2012-10-17",		 	 	 
	"Statement": [
		{
			"Effect": "Allow",
			"Action": [
				"ec2:RunInstances",
				"ec2:CreateSecurityGroup",
				"ec2:DescribeVpcs",
				"ec2:DescribeSubnets",
				"ec2:DescribeSecurityGroups",
				"ec2:DescribeInstances",
				"ec2:DescribeInstanceStatus",
				"cloudformation:CreateStack",
				"cloudformation:DescribeStacks",
				"cloudformation:DescribeStackEvents",
				"cloudformation:DescribeStackResources"
			],
			"Resource": "*"
		},
		{
			"Effect": "Allow",
			"Action": [
				"ec2:TerminateInstances",
				"ec2:DeleteSecurityGroup",
				"ec2:AuthorizeSecurityGroupIngress"
			],
			"Resource": "*"
		},
		{
			"Effect": "Allow",
			"Action": [
				"cloudformation:DeleteStack"
			],
			"Resource": "arn:aws:cloudformation:*:*:stack/aws-cloud9-*"
		},
		{
			"Effect": "Allow",
			"Action": [
				"ec2:CreateTags"
			],
			"Resource": [
				"arn:aws:ec2:*:*:instance/*",
				"arn:aws:ec2:*:*:security-group/*"
			],
			"Condition": {
				"StringLike": {
					"aws:RequestTag/Name": "aws-cloud9-*"
				}
			}
		},
		{
			"Effect": "Allow",
			"Action": [
				"ec2:StartInstances",
				"ec2:StopInstances"
			],
			"Resource": "*",
			"Condition": {
				"StringLike": {
					"ec2:ResourceTag/aws:cloudformation:stack-name": "aws-cloud9-*"
				}
			}
		},
		{
			"Effect": "Allow",
			"Action": [
				"ec2:StartInstances",
				"ec2:StopInstances"
			],
			"Resource": [
				"arn:aws:license-manager:*:*:license-configuration:*"
			]
		},
		{
			"Effect": "Allow",
			"Action": [
				"iam:ListInstanceProfiles",
				"iam:GetInstanceProfile"
			],
			"Resource": [
				"arn:aws:iam::*:instance-profile/cloud9/*"
			]
		},
		{
			"Effect": "Allow",
			"Action": [
				"iam:PassRole"
			],
			"Resource": [
				"arn:aws:iam::*:role/service-role/AWSCloud9SSMAccessRole"
			],
			"Condition": {
				"StringLike": {
					"iam:PassedToService": "ec2.amazonaws.com"
				}
			}
		}
	]
}

AWS Cloud9AWS 托管策略的更新

查看 AWS Cloud9 自该服务开始跟踪这些更改以来 AWS 托管策略更新的详细信息。要获得有关此页面更改的自动提醒，请订阅 “ AWS Cloud9 文档历史记录” 页面上的 RSS feed。

更改	描述	日期
已在 “AWSCloud9用户”、“AWSCloud9管理员” 和 “AWSCloud9EnvironmentMember策略” 中添加了新操作。	该`ssm:GetConnectionStatus`操作已添加到AWSCloud9用户AWSCloud9管理员和AWSCloud9EnvironmentMember策略中。此操作将授予用户检查 SSM 连接状态的权限。该 `cloud9:ValidateEnvironmentName` API 已从AWSCloud9用户政策中删除，因为它已被弃用。	2023 年 10 月 12 日
API 已添加到AWSCloud9用户和AWSCloud9管理员策略中。	在AWSCloud9用户和AWSCloud9管理员策略中添加了两个新 API，这些 API 是`ec2:DescribeInstanceTypeOfferings`和`ec2:DescribeRouteTables`。这些 API 的 AWS Cloud9 目的是验证默认子网是否支持客户在创建 AWS Cloud9 环境时选择的实例类型。	2023 年 8 月 02 日
更新至 AWSCloud9ServiceRolePolicy	AWSCloud9ServiceRolePolicy已更新， AWS Cloud9 允许启动和停止由 License Manager 许可配置管理的 Amazon EC2 实例。	2022 年 1 月 12 日
AWS Cloud9 开始跟踪更改	AWS Cloud9 开始跟踪其 AWS 托管策略的更改。	2021 年 3 月 15 日

为创建客户托管策略 AWS Cloud9

如果所有 AWS 托管策略都不符合您的访问控制要求，则可以创建并附加自己的客户托管策略。

要创建客户托管式策略，请参阅 IAM 用户指南中的创建 IAM 策略（控制台）。

主题

指定策略元素：效果、委托人、操作和资源
客户管理型策略示例

指定策略元素：效果、委托人、操作和资源

对于每种 AWS Cloud9 资源，该服务都定义了一组 API 操作。要授予这些 API 操作的权限，请 AWS Cloud9 定义一组可在策略中指定的操作。

以下是基本的策略元素：

Effect – 用于指定在用户请求操作时的效果（可以是允许或拒绝）。如果没有显式授予（允许）对资源的访问权限，则隐式拒绝访问。您也可显式拒绝对资源的访问。您可以执行该操作以确保用户无法访问资源，即使其他策略授予了访问权限。
Principal – 在基于身份的策略（IAM 策略）中，策略附加到的用户是隐式委托人。对于基于资源的策略，您可以指定您希望将权限授予的用户、账户、服务或其他实体。
Resource – 使用 Amazon 资源名称（ARN）以确定策略应用到的资源。
Action – 使用操作关键字来标识要允许或拒绝的资源操作。例如，cloud9:CreateEnvironmentEC2 权限授予用户执行 CreateEnvironmentEC2 操作的权限。

有关 IAM 策略语法和介绍的更多信息，请参阅 IAM 用户指南的 IAM JSON 策略参考。

有关显示所有 AWS Cloud9 API 操作及其适用的资源的表格，请参阅AWS Cloud9 权限参考。

客户管理型策略示例

在本节中，您可以找到为 AWS Cloud9 操作授予权限的示例策略。您可以修改以下示例 IAM 策略以允许或明确拒绝您的 IAM 身份访问 AWS Cloud9 。

要创建客户托管式策略或将其附加到 IAM 身份，请参阅 IAM 用户指南中的创建 IAM 策略（控制台）和附加 IAM 策略（控制台）。

注意

以下示例使用美国东部（俄亥俄州）区域 (us-east-2)、虚构的 AWS 账户 ID (123456789012) 和虚构的 AWS Cloud9 开发环境 ID ()。81e900317347585a0601e04c8d52eaEX

主题

获取有关环境的信息
创建 EC2 环境
使用特定 Amazon EC2 实例类型创建 EC2 环境
在特定的 Amazon VPC 子网中创建 EC2 环境
创建具有特定 EC2 环境名称的环境
仅创建 SSH 环境
更新环境或禁止更新环境
获取环境成员列表
仅与特定用户共享环境
禁止共享环境
更改或禁止更改环境成员设置
删除或禁止删除环境成员
删除或阻止删除环境
用于创建 SSM 环境的自定义 IAM 策略

获取有关环境的信息

以下示例 IAM 策略语句附加到一个 IAM 实体，此语句允许该实体获取有关其账户中的任何环境的信息。

注意

上述访问权限已包含在 AWS 托管策略AWSCloud9Administrator和AWSCloud9User。

创建 EC2 环境

以下 IAM 策略声明示例（附加到 IAM 实体）允许该实体在其账户中创建 AWS Cloud9 EC2 开发环境。

注意

上述访问权限已包含在 AWS 托管策略AWSCloud9Administrator和AWSCloud9User。

使用特定 Amazon EC2 实例类型创建 EC2 环境

以下 IAM 策略声明示例（附加到 IAM 实体）允许该实体在其账户中创建 AWS Cloud9 EC2 开发环境。但是， EC2 环境只能使用指定类别的 Amazon EC2 实例类型。

注意

如果 AWS 托管策略AWSCloud9Administrator或已附加到 IAM 实体，AWSCloud9User则该 AWS 托管策略将覆盖前面的 IAM 策略声明的行为。这是因为这些 AWS 托管策略更宽松。

在特定的 Amazon VPC 子网中创建 EC2 环境

以下 IAM 策略声明示例（附加到 IAM 实体）允许该实体在其账户中创建 AWS Cloud9 EC2 开发环境。但是， EC2 环境只能使用指定的 Amazon VPC 子网。

注意

创建具有特定 EC2 环境名称的环境

以下 IAM 策略声明示例（附加到 IAM 实体）允许该实体在其账户中创建 AWS Cloud9 EC2 开发环境。但是， EC2 环境只能使用指定的名称。

注意

仅创建 SSH 环境

以下 IAM 策略声明示例（附加到 IAM 实体）允许该实体在其账户中创建 AWS Cloud9 SSH 开发环境。但是，该实体无法创建 AWS Cloud9 EC2 开发环境。

更新环境或禁止更新环境

以下 IAM 政策声明示例（附加到 IAM 实体）允许该实体更改有关其账户中任何 AWS Cloud9 开发环境的信息。

注意

上述访问权限已包含在 AWS 托管策略中AWSCloud9Administrator。

以下示例 IAM policy 语句附加到一个 IAM 实体，此语句显式防止该实体更改有关具有指定 Amazon 资源名称（ARN）的环境的信息。

获取环境成员列表

以下示例 IAM 策略语句附加到一个 IAM 实体，此语句允许该实体获取其账户中的任何环境的成员列表。

注意

上述访问权限已包含在 AWS 托管策略中AWSCloud9Administrator。此外，前面的访问权限比 AWS 托管策略AWSCloud9User中的等效访问权限更具宽松性。

仅与特定用户共享环境

以下示例 IAM 策略语句附加到一个 IAM 实体，此语句允许该实体仅与指定用户共享其账户中的任何环境。

注意

如果 AWS 托管策略AWSCloud9Administrator或已附加到 IAM 实体，AWSCloud9User则这些 AWS 托管策略将覆盖前面的 IAM 策略声明的行为。这是因为这些 AWS 托管策略更宽松。

禁止共享环境

以下示例 IAM 策略语句附加到一个 IAM 实体，此语句禁止该实体共享其账户中的任何环境。

更改或禁止更改环境成员设置

以下示例 IAM 策略语句附加到一个 IAM 实体，此语句允许该实体更改其账户的任何环境中的成员设置。

注意

上述访问权限已包含在 AWS 托管策略中AWSCloud9Administrator。

以下示例 IAM policy 语句附加到一个 IAM 实体，此语句显式防止该实体更改具有指定 Amazon 资源名称（ARN）的环境中的成员设置。

删除或禁止删除环境成员

以下示例 IAM 策略语句附加到一个 IAM 实体，此语句允许该实体从其账户的任何环境中删除任何成员。

注意

上述访问权限已包含在 AWS 托管策略中AWSCloud9Administrator。

以下示例 IAM policy 语句附加到一个 IAM 实体，此语句显式防止该实体从具有指定 Amazon 资源名称（ARN）的环境中删除任何成员。

删除或阻止删除环境

以下示例 IAM 策略语句附加到一个 IAM 实体，此语句允许该实体删除其账户中的任何环境。

注意

上述访问权限已包含在 AWS 托管策略中AWSCloud9Administrator。

以下示例 IAM policy 语句附加到一个 IAM 实体，此语句显式防止该实体删除具有指定 Amazon 资源名称（ARN）的环境。

用于创建 SSM 环境的自定义 IAM 策略

当前存在一个权限问题，会在创建附加 AWSCloud9Administrator 或 AWSCloud9User 策略的 SSM 环境时出现。以下示例 IAM 策略声明在附加到 IAM 实体时，允许用户附加和使用 AWS 托管策略AWSCloud9Administrator或AWSCloud9User。

JSON


{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:UpdateUserSettings",
                "cloud9:GetUserSettings",
                "iam:GetUser",
                "iam:ListUsers",
                "iam:ListRoles",
                "ec2:DescribeVpcs",
                "ec2:DescribeSubnets",
                "ec2:DescribeRouteTables"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:CreateEnvironmentEC2",
                "cloud9:CreateEnvironmentSSH"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "cloud9:OwnerArn": "true"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:GetUserPublicKey"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "cloud9:UserArn": "true"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloud9:DescribeEnvironmentMemberships"
            ],
            "Resource": [
                "*"
            ],
            "Condition": {
                "Null": {
                    "cloud9:UserArn": "true",
                    "cloud9:EnvironmentId": "true"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "iam:AWSServiceName": "cloud9.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "ssm:StartSession",
            "Resource": "arn:aws:ec2:*:*:instance/*",
            "Condition": {
                "StringLike": {
                    "ssm:resourceTag/aws:cloud9:environment": "*"
                },
                "StringEquals": {
                    "aws:CalledViaFirst": "cloud9.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:StartSession"
            ],
            "Resource": [
                "arn:aws:ssm:*:*:document/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": ["iam:ListInstanceProfilesForRole", "iam:CreateRole"],
            "Resource": ["arn:aws:iam::*:role/service-role/AWSCloud9SSMAccessRole"]
        },
        {
            "Effect": "Allow",
            "Action": ["iam:AttachRolePolicy"],
            "Resource": ["arn:aws:iam::*:role/service-role/AWSCloud9SSMAccessRole"],
            "Condition": {
                "StringEquals": {
                    "iam:PolicyARN": "arn:aws:iam::aws:policy/AWSCloud9SSMInstanceProfile"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::*:role/service-role/AWSCloud9SSMAccessRole",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": "ec2.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:CreateInstanceProfile",
                "iam:AddRoleToInstanceProfile"
            ],
            "Resource": [
                "arn:aws:iam::*:instance-profile/cloud9/AWSCloud9SSMInstanceProfile"
            ]
        }
    ]
}

AWS Cloud9 权限参考

您可以在 AWS Cloud9 策略中使用 AWS 宽条件密钥来表达条件。有关列表，请参阅 IAM 用户指南中的 IAM JSON 策略元素：条件。

请在策略的 Action 字段中指定这些操作。要指定操作，请在 API 操作名称之前使用 cloud9: 前缀（例如，"Action": "cloud9:DescribeEnvironments"）。要在单个语句中指定多项操作，请使用逗号将它们隔开（例如，"Action": [ "cloud9:UpdateEnvironment", "cloud9:DeleteEnvironment" ]）。

使用通配符

您可以在策略的 * 字段中将带或不带通配符 (Resource) 的 ARN 指定为资源值。您可以使用通配符指定多个操作或资源。例如，cloud9:*指定所有 AWS Cloud9 操作并cloud9:Describe*指定以开头的所有 AWS Cloud9 操作Describe。

以下示例允许 IAM 实体获取有关其账户中的任何环境和环境成员的信息。

注意

上述访问权限已包含在 AWS 托管策略中AWSCloud9Administrator。此外，前面的访问权限比 AWS 托管策略AWSCloud9User中的等效访问权限更具宽松性。

AWS Cloud9 API 操作和操作所需的权限

注意

在设置访问控制以及编写要附加到 IAM 身份的权限策略（基于身份的策略）时，可以使用下表作为参考。

该Public API operations表列出了客户可以使用 SDKs 和调用的 API 操作 AWS Command Line Interface。

Permission-only API operations 列出了客户代码或 AWS Command Line Interface无法直接调用的 API 操作。但 IAM 用户确实需要这些操作的权限，这些操作在执行 AWS Cloud9 操作时使用控制台调用。

公有 API 操作
AWS Cloud9 操作	所需的权限（API 操作）	资源
`CreateEnvironmentEC2`	`cloud9:CreateEnvironmentEC2` 创建 AWS Cloud9 EC2 开发环境所必需的。	`*`
`CreateEnvironmentMembership`	`cloud9:CreateEnvironmentMembership` 需要使用该权限在环境中添加成员。	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`
`DeleteEnvironment`	`cloud9:DeleteEnvironment` 需要使用该权限删除环境。	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`
`DeleteEnvironmentMembership`	`cloud9:DeleteEnvironmentMembership` 需要使用该权限从环境中移除成员。	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`
`DescribeEnvironmentMemberships`	`cloud9:DescribeEnvironmentMemberships` 需要使用该权限以获取环境中的成员列表。	`*`
`DescribeEnvironments`	`cloud9:DescribeEnvironments` 需要使用该权限以获取有关环境的信息。	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`
`DescribeEnvironmentStatus`	`cloud9:DescribeEnvironmentStatus` 需要使用该权限以获取有关环境状态的信息。	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`
`UpdateEnvironment`	`cloud9:UpdateEnvironment` 需要使用该权限以更新环境设置。	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`
`UpdateEnvironmentMembership`	`cloud9:UpdateEnvironmentMembership` 需要使用该权限以更新环境中的成员设置。	`arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID`

仅限
权限的 API 操作
AWS Cloud9 操作	描述	控制台文档
`ActivateEC2Remote`	`cloud9:ActivateEC2Remote` 启动您的 AWS Cloud9 IDE 所连接的 Amazon EC2 实例。	在中打开环境 AWS Cloud9
`CreateEnvironmentSSH`	`cloud9:CreateEnvironmentSSH` 创建 AWS Cloud9 SSH 开发环境。	创建 SSH 环境
`CreateEnvironmentToken`	`cloud9:CreateEnvironmentToken` 创建身份验证令牌，以允许 AWS Cloud9 IDE 和用户环境之间的连接。	创建 EC2 环境
`DescribeEC2Remote`	`cloud9:DescribeEC2Remote` 获取有关 EC2 开发环境连接的详细信息，包括主机、用户和端口。	创建 EC2 环境
`DescribeSSHRemote`	`cloud9:DescribeSSHRemote` 获取有关 SSH 开发环境（包括主机、用户和端口）连接详细信息。	创建 SSH 环境
`GetEnvironmentConfig`	`cloud9:GetEnvironmentConfig` 获取用于初始化 AWS Cloud9 IDE 的配置信息。	使用 AWS Cloud9 IDE
`GetEnvironmentSettings`	`cloud9:GetEnvironmentSettings` 获取指定开发环境的 AWS Cloud9 IDE 设置。	使用 AWS Cloud9 IDE
`GetMembershipSettings`	`cloud9:GetMembershipSettings` 获取指定环境成员的 AWS Cloud9 IDE 设置。	在中使用共享环境 AWS Cloud9
`GetUserPublicKey`	`cloud9:GetUserPublicKey` 获取用户的 SSH 公钥，该密钥用于连接 AWS Cloud9 到 SSH 开发环境。	创建 SSH 环境
`GetUserSettings`	`cloud9:GetUserSettings` 获取指定用户的 AWS Cloud9 IDE 设置。	使用 AWS Cloud9 IDE
`ModifyTemporaryCredentialsOnEnvironmentEC2`	`cloud9:ModifyTemporaryCredentialsOnEnvironmentEC2` 在 AWS Cloud9 集成开发环境 (IDE) 使用的 Amazon EC2 实例上设置 AWS 托管临时证书。	AWS 托管的临时证书
`UpdateEnvironmentSettings`	`cloud9:UpdateEnvironmentSettings` 更新指定开发环境的 AWS Cloud9 IDE 设置。	使用 AWS Cloud9 IDE
`UpdateMembershipSettings`	`cloud9:UpdateMembershipSettings` 更新指定环境成员的 AWS Cloud9 IDE 设置。	在中使用共享环境 AWS Cloud9
`UpdateSSHRemote`	`cloud9:UpdateSSHRemote` 更新有关 SSH 开发环境的（包括主机、用户和端口）连接详细信息。	创建 SSH 环境
`UpdateUserSettings`	`cloud9:UpdateUserSettings` 更新指定用户的 AWS Cloud9 IDE 设置。	使用 AWS Cloud9 IDE
`GetMigrationExperiences`	`cloud9:GetMigrationExperiences` 向 AWS Cloud9 用户授予从 AWS Cloud9 到的迁移体验的权限 CodeCatalyst。

AWS 托管的临时证书

如果您只是在寻找 AWS 托管临时证书支持的操作列表，请直接跳至AWS 托管临时证书支持的操作。

对于 AWS Cloud9 EC2 开发环境 AWS Cloud9 ，您可以在环境中 AWS 使用临时访问证书。我们将这些凭证称为 AWS 托管式临时凭证。这些凭证具有以下优势：

您无需将 AWS 实体（例如 IAM 用户）的永久 AWS 访问凭证存储在环境中的任何地方。这会在您不知情和未批准的情况下禁止环境成员访问这些凭证。
您无需手动设置、管理实例配置文件或将实例配置文件附加到连接到环境的 Amazon EC2 实例。实例配置文件是管理临时 AWS 访问证书的另一种方法。
AWS Cloud9 不断更新其临时证书，因此一组证书只能在有限的时间内使用。这是一种 AWS 安全最佳实践。有关更多信息，请参阅创建和更新 AWS 托管临时证书。
AWS Cloud9 对如何使用其临时证书从环境中访问 AWS 操作和资源施加了额外限制。这也是一种 AWS 安全最佳实践。

重要

目前，如果您的环境 EC2 实例启动到私有子网，则您不能使用 AWS 托管临时证书来允许 EC2环境代表 AWS 实体（例如，IAM 用户）访问 AWS 服务。

有关何时可以在私有子网中启动 EC2 实例的更多信息，请参阅为创建子网 AWS Cloud9。

注意

在使用 AWS 托管临时证书时，请考虑使用 AWS 托管策略而不是内联策略。

以下是当 EC2 环境尝试代表 AWS 实体（例如，IAM 用户）访问时， AWS 托管临时证书的工作原理： AWS 服务

AWS Cloud9 检查调用 AWS 实体（例如，IAM 用户）是否有权对中请求的资源执行请求的操作 AWS。如果没有或明确拒绝该权限，请求将失败。
AWS Cloud9 检查 AWS 托管的临时证书，以查看其权限是否允许对中请求的资源执行请求的操作 AWS。如果没有或明确拒绝该权限，请求将失败。有关 AWS 托管临时证书支持的权限列表，请参阅AWS 托管临时证书支持的操作。

如果 AWS 实体和 AWS 托管临时证书都允许对请求的资源执行请求的操作，则请求成功。
如果 AWS 实体或 AWS 托管临时证书明确拒绝或未明确允许对请求的资源执行请求的操作，则请求将失败。这意味着，即使调用 AWS 实体具有正确的权限，如果 AWS Cloud9 不明确允许，请求也会失败。同样，如果 AWS Cloud9 允许对特定资源采取特定操作，则如果该 AWS 实体不明确允许，则请求将失败。

环境的所有者可以随时为该 EC2 环境开启或关闭 AWS 托管临时证书，如下所示：

打开环境后，在 AWS Cloud9 IDE 的菜单栏中选择AWS Cloud9“首选项”。
在 Preferences (首选项) 选项卡中，在导航窗格中选择 AWS Settings > Credentials（Amazon 设置 > 凭证）。
使用 AWS 托管式临时凭证以启用或禁用 AWS 托管式临时凭证。

注意

您还可以通过调用 AWS Cloud9 API 操作UpdateEnvironment并为managedCredentialsAction参数分配值来开启或关闭 AWS 托管临时证书。您可以使用标准 AWS 工具（例如 AWS SDKs 和）来请求此 API 操作 AWS CLI。

如果您关闭 AWS 托管临时证书，则无论是哪个 AWS 实体提出请求 AWS 服务，环境都无法访问任何证书。但是，假设你不能或不想为环境开启 AWS 托管临时证书，但你仍然需要环境才能访问 AWS 服务。则考虑以下替代方案：

将实例配置文件附加到连接到环境的 Amazon EC2 实例。有关说明，请参阅创建和使用实例配置文件管理临时凭证。
例如，通过设置特殊的环境变量或运行aws configure命令将您的永久 AWS 访问凭证存储在环境中。有关说明，请参阅在环境中创建和存储永久访问凭证。

上述备选方案将覆盖 EC2 环境中 AWS 托管临时证书允许（或拒绝）的所有权限。

AWS 托管临时证书支持的操作

对于 AWS Cloud9 EC2 开发环境， AWS 托管临时证书允许对调用者中的所有 AWS 资源进行所有 AWS 操作 AWS 账户，但有以下限制：

对于 AWS Cloud9，仅允许执行以下操作：
- cloud9:CreateEnvironmentEC2
- cloud9:CreateEnvironmentSSH
- cloud9:DescribeEnvironmentMemberships
- cloud9:DescribeEnvironments
- cloud9:DescribeEnvironmentStatus
- cloud9:UpdateEnvironment
对于 IAM，仅允许执行以下操作：
- iam:AttachRolePolicy
- iam:ChangePassword
- iam:CreatePolicy
- iam:CreatePolicyVersion
- iam:CreateRole
- iam:CreateServiceLinkedRole
- iam:DeletePolicy
- iam:DeletePolicyVersion
- iam:DeleteRole
- iam:DeleteRolePolicy
- iam:DeleteSSHPublicKey
- iam:DetachRolePolicy
- iam:GetInstanceProfile
- iam:GetPolicy
- iam:GetPolicyVersion
- iam:GetRole
- iam:GetRolePolicy
- iam:GetSSHPublicKey
- iam:GetUser
- iam:List*
- iam:PassRole
- iam:PutRolePolicy
- iam:SetDefaultPolicyVersion
- iam:UpdateAssumeRolePolicy
- iam:UpdateRoleDescription
- iam:UpdateSSHPublicKey
- iam:UploadSSHPublicKey
仅以 Cloud9- 开头的角色名称允许执行与角色交互的所有 IAM 操作。不过，iam:PassRole 适用于所有角色名称。
对于 AWS Security Token Service (AWS STS)，仅允许执行以下操作：
- sts:GetCallerIdentity
- sts:DecodeAuthorizationMessage
所有支持的 AWS 操作仅限于环境的 IP 地址。这是一种 AWS 安全最佳实践。

如果 AWS Cloud9 不支持您需要 EC2 环境才能访问的操作或资源，或者如果某个环境的 AWS 托管临时证书已关闭并且您无法将其重新打开，请考虑以下替代方案： EC2

将实例配置文件附加到连接到 EC2 环境的 Amazon EC2 实例。有关说明，请参阅创建和使用实例配置文件管理临时凭证。
例如，通过设置特殊的 EC2 环境变量或运行aws configure命令将您的永久 AWS 访问凭证存储在环境中。有关说明，请参阅在环境中创建和存储永久访问凭证。

上述备选方案将覆盖 EC2 环境中 AWS 托管临时证书允许（或拒绝）的所有权限。

创建和更新 AWS 托管临时证书

对于 AWS Cloud9 EC2 开发环境， AWS 托管临时证书是在您首次打开环境时创建的。

AWS 在以下任一条件下更新托管临时证书：

每次经过特定的一段时间。目前，该时间段为 5 分钟。
每次重新加载显示环境 IDE 的 Web 浏览器选项卡时。
在到达环境的 ~/.aws/credentials 文件中列出的时间戳时。
如果每次重新启用设置时，AWS 托管式临时凭证设置为禁用。（要查看或更改该设置，请选择 IDE 的菜单栏中的 AWS Cloud9，Preferences（首选项）。在 Preferences（首选项）选项卡上，在导航窗格中，选择 AWS Settings > Credentials（Amazon 设置 > 凭证）。）
出于安全考虑， AWS 托管临时证书会在 15 分钟后自动过期。要刷新凭证，环境拥有者必须通过 IDE 连接到 AWS Cloud9 环境。有关环境拥有者角色的更多信息，请参阅控制对 AWS 托管式临时凭证的访问。

控制对 AWS 托管式临时凭证的访问

拥有 AWS 托管临时证书的合作者可以使用与其他 AWS Cloud9 AWS 服务人互动。为了确保仅向受信任的协作者提供 AWS 托管式临时凭证，如果环境拥有者以外的任何人添加了新成员，则这些凭证将被禁用。通过删除 ~/.aws/credentials 文件禁用凭证。

重要

AWS 托管临时证书也每 15 分钟自动过期。要刷新凭据以便协作者可以继续使用它们，必须通过 IDE 将环境所有者连接到 AWS Cloud9 环境。

只有环境所有者才能重新启用 AWS 托管临时证书，以便与其他成员共享这些证书。当环境所有者打开 IDE 时，会出现一个对话框，确认 AWS 托管临时凭证已禁用。环境拥有者可以为所有成员重新启用凭证，或禁用所有成员的凭证。

警告

要遵守最佳安全实践，如果您不确定上一个添加到环境中的用户的身份，请保持禁用托管式临时凭证。您可以在 “协作” 窗口中查看具有 read/write 权限的成员列表。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

数据加密

日志记录和监控

适用于 Identity and Access Managem AWS Cloud9

主题

受众

使用身份进行身份验证

AWS 账户 root 用户

联合身份

IAM 用户和群组

IAM 角色

使用策略管理访问

基于身份的策略

基于资源的策略

其他策略类型

多个策略类型

如何 AWS Cloud9 与 IAM 配合使用

基于身份的策略 AWS Cloud9

基于身份的策略示例 AWS Cloud9

内部基于资源的政策 AWS Cloud9

的政策行动 AWS Cloud9

的政策资源 AWS Cloud9

的策略条件密钥 AWS Cloud9

ACLs in AWS Cloud9

ABAC with AWS Cloud9

将临时证书与 AWS Cloud9

转发访问会话 AWS Cloud9

AWS Cloud9的服务角色

警告

的服务相关角色 AWS Cloud9

AWS Cloud9基于身份的策略示例

主题

策略最佳实践

使用 AWS Cloud9 控制台

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

对 AWS Cloud9 身份和访问进行故障排除

主题

我无权在以下位置执行操作 AWS Cloud9

我无权执行 iam：PassRole

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

如何 AWS Cloud9 使用 IAM 资源和操作

AWS Cloud9 资源和运营

了解资源所有权

注意

管理对 资源的访问

注意

API 操作的会话权限

AWS 的托管策略 AWS Cloud9

AWS 托管策略： AWSCloud9管理员

AWS 托管策略： AWSCloud9用户

AWS 托管策略： AWSCloud9EnvironmentMember

AWS 托管策略：AWSCloud9ServiceRolePolicy

AWS Cloud9AWS 托管策略的更新

为创建客户托管策略 AWS Cloud9

主题

指定策略元素：效果、委托人、操作和资源

客户管理型策略示例

注意

主题

获取有关环境的信息

注意

创建 EC2 环境

注意

使用特定 Amazon EC2 实例类型创建 EC2 环境

注意

在特定的 Amazon VPC 子网中创建 EC2 环境

注意

创建具有特定 EC2 环境名称的环境

注意

仅创建 SSH 环境

更新环境或禁止更新环境

注意

获取环境成员列表

注意

仅与特定用户共享环境

注意

禁止共享环境

更改或禁止更改环境成员设置

注意

删除或禁止删除环境成员

注意

删除或阻止删除环境

注意

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

管理对资源的访问

AWS 托管策略：`AWSCloud9ServiceRolePolicy`