AWS CodeCommit 不再向新客户提供。 AWS CodeCommit 的现有客户可以继续正常使用该服务。了解更多

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

适用于 Identity and Access Managem AWS CodeCommit

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

受众

你使用 AWS Identity and Access Management (IAM) 的方式会有所不同，具体取决于你所做的工作 CodeCommit。

服务用户-如果您使用 CodeCommit 服务完成工作，则管理员会为您提供所需的凭证和权限。当你使用更多 CodeCommit 功能来完成工作时，你可能需要额外的权限。了解如何管理访问权限有助于您向管理员请求适合的权限。如果您无法访问中的功能 CodeCommit，请参阅对 AWS CodeCommit 身份和访问进行故障排除。

服务管理员-如果您负责公司的 CodeCommit 资源，则可能拥有完全访问权限 CodeCommit。您的工作是确定您的服务用户应访问哪些 CodeCommit 功能和资源。然后，您必须向IAM管理员提交更改服务用户权限的请求。查看此页面上的信息以了解的基本概念IAM。要详细了解贵公司如何IAM与配合使用 CodeCommit，请参阅AWS CodeCommit 如何使用 IAM。

IAM管理员-如果您是IAM管理员，则可能需要详细了解如何编写用于管理访问权限的策略 CodeCommit。要查看可在中使用的 CodeCommit 基于身份的策略示例IAM，请参阅。AWS CodeCommit 基于身份的策略示例

使用身份进行身份验证

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

您可以使用通过身份源提供的凭据以 AWS 联合身份登录。 AWS IAM Identity Center （IAM身份中心）用户、贵公司的单点登录身份验证以及您的 Google 或 Facebook 凭据就是联合身份的示例。当您以联合身份登录时，您的管理员之前使用IAM角色设置了联合身份。当你使用联合访问 AWS 时，你就是在间接扮演一个角色。

根据您的用户类型，您可以登录 AWS Management Console 或 AWS 访问门户。有关登录的更多信息 AWS，请参阅《AWS 登录 用户指南》中的如何登录到您 AWS 账户的。

如果您 AWS 以编程方式访问，则会 AWS 提供软件开发套件 (SDK) 和命令行接口 (CLI)，以便使用您的凭据对请求进行加密签名。如果您不使用 AWS 工具，则必须自己签署请求。有关使用推荐的方法自行签署请求的更多信息，请参阅《IAM用户指南》中的API请求AWS 签名版本 4。

无论使用何种身份验证方法，您可能需要提供其他安全信息。例如， AWS 建议您使用多重身份验证 (MFA) 来提高账户的安全性。要了解更多信息，请参阅用户指南中的多因素身份验证和AWS IAM Identity Center 用户指南IAM中的AWS 多因素身份验证。IAM

AWS 账户 root 用户

创建时 AWS 账户，首先要有一个登录身份，该身份可以完全访问账户中的所有资源 AWS 服务 和资源。此身份被称为 AWS 账户 root 用户，使用您创建帐户时使用的电子邮件地址和密码登录即可访问该身份。强烈建议您不要使用根用户执行日常任务。保护好根用户凭证，并使用这些凭证来执行仅根用户可以执行的任务。有关需要您以 root 用户身份登录的任务的完整列表，请参阅《用户指南》中的 “需要根用户凭据的IAM任务”。

IAM 用户和组

IAM用户是您内部 AWS 账户 对个人或应用程序具有特定权限的身份。在可能的情况下，我们建议使用临时证书，而不是创建拥有密码和访问密钥等长期凭证的IAM用户。但是，如果您有需要IAM用户长期凭证的特定用例，我们建议您轮换访问密钥。有关更多信息，请参阅《IAM用户指南》中的定期轮换需要长期凭证的用例的访问密钥。

IAM群组是指定IAM用户集合的身份。您不能使用组的身份登录。您可以使用组来一次性为多个用户指定权限。如果有大量用户，使用组可以更轻松地管理用户权限。例如，您可以拥有一个名为的群组，IAMAdmins并授予该群组管理IAM资源的权限。

用户与角色不同。用户唯一地与某个人员或应用程序关联，而角色旨在让需要它的任何人代入。用户具有永久的长期凭证，而角色提供临时凭证。要了解更多信息，请参阅《IAM用户指南》中的IAM用户用例。

IAM角色

IAM角色是您内部具有特定权限 AWS 账户 的身份。它与IAM用户类似，但与特定人员无关。要在中临时扮IAM演角色 AWS Management Console，可以从用户切换到IAM角色（控制台）。您可以通过调用 AWS CLI 或 AWS API操作或使用自定义操作来代入角色URL。有关使用角色的方法的更多信息，请参阅《IAM用户指南》中的代入角色的方法。

IAM具有临时证书的角色在以下情况下很有用：

使用策略管理访问

您可以 AWS 通过创建策略并将其附加到 AWS 身份或资源来控制中的访问权限。策略是其中的一个对象 AWS ，当与身份或资源关联时，它会定义其权限。 AWS 在委托人（用户、root 用户或角色会话）发出请求时评估这些策略。策略中的权限确定是允许还是拒绝请求。大多数策略都以JSON文档的 AWS 形式存储在中。有关JSON策略文档结构和内容的更多信息，请参阅《IAM用户指南》中的JSON策略概述。

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

默认情况下，用户和角色没有权限。要授予用户对其所需资源执行操作的权限，IAM管理员可以创建IAM策略。然后，管理员可以将IAM策略添加到角色中，用户可以代入这些角色。

IAM无论您使用何种方法执行操作，策略都会定义该操作的权限。例如，假设您有一个允许 iam:GetRole 操作的策略。拥有该策略的用户可以从 AWS Management Console AWS CLI、或获取角色信息 AWS API。

基于身份的策略

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

基于身份的策略可以进一步归类为内联策略或托管策略。内联策略直接嵌入单个用户、组或角色中。托管策略是独立的策略，您可以将其附加到中的多个用户、群组和角色 AWS 账户。托管策略包括 AWS 托管策略和客户托管策略。要了解如何在托管策略或内联策略之间进行选择，请参阅《IAM用户指南》中的在托管策略和内联策略之间进行选择。

基于资源的策略

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

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

访问控制列表 (ACLs)

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

Amazon S3 AWS WAF、和亚马逊VPC就是支持的服务示例ACLs。要了解更多信息ACLs，请参阅《亚马逊简单存储服务开发者指南》中的访问控制列表 (ACL) 概述。

其他策略类型

AWS 支持其他不太常见的策略类型。这些策略类型可以设置更常用的策略类型向您授予的最大权限。

多个策略类型

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

CodeCommit 基于资源的策略

CodeCommit 不支持基于资源的策略。

基于 CodeCommit 标签的授权

您可以为 CodeCommit 资源附加标签或在请求中传递标签 CodeCommit。要基于标签控制访问，您需要使用 codecommit:ResourceTag/key-name、aws:RequestTag/key-name 或 aws:TagKeys 条件键在策略的条件元素中提供标签信息。有关为 CodeCommit 资源添加标签的更多信息，请参阅示例 5：使用标签拒绝或允许对存储库执行操作。有关标记策略的更多信息，请参阅为资源添加标签。 AWS

CodeCommit 还支持基于会话标签的策略。有关更多信息，请参阅会话标签。

使用标签在中提供身份信息 CodeCommit

CodeCommit 支持使用会话标签，这些标签是您在代入IAM角色、使用临时证书或在 () 中 AWS Security Token Service 联合用户时传递的键值对属性。AWS STS您也可以将标签与IAM用户关联。您可以使用这些标签中提供的信息来更轻松地识别谁进行了更改或导致了事件。 CodeCommit 包括 CodeCommit 事件中具有以下键名的标签的值：

如果提供了此信息，则将其 CodeCommit 包含在发送给亚马逊的活动 EventBridge 和亚马逊 CloudWatch 活动中。有关更多信息，请参阅 在 Amazon EventBridge 和 Amazon CloudWatch Events 中监控 CodeCommit 事件。

要使用会话标记，角色必须具有包含设置为 Allow 的 sts:TagSession 权限的策略。如果使用联合访问，则可以在设置过程中配置显示名称和电子邮件标签信息。例如，如果您使用的是 Azure Active Directory，则可能会提供以下声明信息：

您可以使用 AWS CLI 来传递displayName和emailAddress使用的会话标签AssumeRole。例如，想要担任名为的角色的用户 Developer 谁想关联她的名字 Mary Major 可能会使用类似于以下内容的assume-role命令：

aws sts assume-role \
--role-arn arn:aws:iam::123456789012:role/Developer \
--role-session-name Mary-Major \
–-tags Key=displayName,Value="Mary Major" Key=emailAddress,Value="mary_major@example.com" \
--external-id Example987

有关更多信息，请参阅AssumeRole。

您可以使用 AssumeRoleWithSAML 操作返回包含 displayName 和 emailAddress 标签的一组临时凭证。您可以在访问 CodeCommit存储库时使用这些标签。这要求您的公司或集团已将您的第三方SAML解决方案与集成 AWS。如果是，则可以将SAML属性作为会话标签传递。例如，如果您想为名为的用户传递显示名称和电子邮件地址的身份属性 Saanvi Sarkar 作为会话标签：

<Attribute Name="https://aws.amazon.com/SAML/Attributes/PrincipalTag:displayName">
  <AttributeValue>Saanvi Sarkar</AttributeValue>
</Attribute>
<Attribute Name="https://aws.amazon.com/SAML/Attributes/PrincipalTag:emailAddress">
  <AttributeValue>saanvi_sarkar@example.com</AttributeValue>
</Attribute>

有关更多信息，请参阅使用传递会话标签 AssumeRoleWithSAML。

您可以使用 AssumeRoleWithIdentity 操作返回包含 displayName 和 emailAddress 标签的一组临时凭证。您可以在访问 CodeCommit存储库时使用这些标签。要从 OpenID Connect (OIDC) 传递会话标签，必须在 JSON Web 令牌 (JWT) 中包含会话标签。例如，用于调用的解码JWP令牌AssumeRoleWithWebIdentity，其中包含名为的用户的displayName和emailAddress会话标签 Li Juan:

{
    "sub": "lijuan",
    "aud": "ac_oic_client",
    "jti": "ZYUCeREXAMPLE",
    "iss": "https://xyz.com",
    "iat": 1566583294,
    "exp": 1566583354,
    "auth_time": 1566583292,
    "https://aws.amazon.com/tags": {
        "principal_tags": {
            "displayName": ["Li Juan"],
            "emailAddress": ["li_juan@example.com"],
        },
        "transitive_tag_keys": [
            "displayName",
            "emailAddress"
        ]
    }
}

有关更多信息，请参阅使用传递会话标签 AssumeRoleWithWebIdentity。

您可以使用 GetFederationToken 操作返回包含 displayName 和 emailAddress 标签的一组临时凭证。您可以在访问 CodeCommit存储库时使用这些标签。例如，要使用获取包含displayName和emailAddress标签的联合令牌，请执行以下操作： AWS CLI

aws sts get-federation-token \
--name my-federated-user \
–-tags key=displayName,value="Nikhil Jayashankar" key=emailAddress,value=nikhil_jayashankar@example.com

有关更多信息，请参阅使用传递会话标签 GetFederationToken。

CodeCommit IAM角色

IAM角色是指您的亚马逊 Web Services 账户中具有特定权限的实体。

将临时证书与 CodeCommit

您可以使用临时证书通过联合身份登录、代入IAM角色或担任跨账户角色。您可以通过调用AssumeRole或之类的 AWS STS API操作来获取临时安全证书GetFederationToken。

CodeCommit 支持使用临时证书。有关更多信息，请参阅 使用轮换凭证连接到 AWS CodeCommit 存储库。

服务相关角色

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

CodeCommit 不使用与服务相关的角色。

服务角色

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

CodeCommit 不使用服务角色。

AWS CodeCommit 基于身份的策略示例

默认情况下，IAM用户和角色无权创建或修改 CodeCommit 资源。他们也无法使用 AWS Management Console AWS CLI、或执行任务 AWS API。IAM管理员必须创建IAM策略，授予用户和角色对其所需的指定资源执行特定API操作的权限。然后，管理员必须将这些策略附加到需要这些权限的IAM用户或群组。

有关策略示例，请参阅以下主题：

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

策略最佳实践

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

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

使用控制 CodeCommit 台

要访问 AWS CodeCommit 控制台，您必须拥有一组最低权限。这些权限必须允许您列出和查看有关您的 Amazon Web Services 账户中 CodeCommit 资源的详细信息。如果您创建的基于身份的策略比所需的最低权限更严格，则控制台将无法按预期运行，适用于使用该策略的实体（IAM用户或角色）。

为确保这些实体仍然可以使用 CodeCommit 控制台，还要将以下 AWS 托管策略附加到这些实体。有关更多信息，请参阅《用户指南》中的向IAM用户添加权限：

有关更多信息，请参阅 使用基于身份的策略（IAM策略） CodeCommit。

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

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

此示例说明如何创建允许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": "*"
        }
    ]
}

正在查看 CodeCommit repositories 基于标签

您可以使用基于身份的策略中的条件根据标签控制对 CodeCommit 资源的访问权限。有关演示如何执行此操作的示例策略，请参阅示例 5：使用标签拒绝或允许对存储库执行操作。

有关更多信息，请参阅《IAM用户指南》中的 “IAMJSON策略元素：条件”。

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

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

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

如果 AWS Management Console 告诉您您无权执行某项操作，则必须联系管理员寻求帮助。管理员是向您提供登录凭证的人。

有关更多信息，请参阅 使用 CodeCommit 控制台所需的权限

我无权执行 iam：PassRole

如果您收到错误消息，提示您无权执行iam:PassRole操作，则必须更新您的策略以允许您将角色传递给 CodeCommit。

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

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

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

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

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

我想要查看我的访问密钥

创建IAM用户访问密钥后，您可以随时查看您的访问密钥 ID。但是，您无法再查看您的秘密访问密钥。如果您丢失了私有密钥，则必须创建一个新的访问密钥对。

访问密钥包含两部分：访问密钥 ID（例如 AKIAIOSFODNN7EXAMPLE）和秘密访问密钥（例如 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY）。与用户名和密码一样，您必须同时使用访问密钥 ID 和秘密访问密钥对请求执行身份验证。像对用户名和密码一样，安全地管理访问密钥。

当您创建访问密钥对时，系统会提示您将访问密钥 ID 和秘密访问密钥保存在一个安全位置。秘密访问密钥仅在您创建它时可用。如果您丢失了私有访问密钥，则必须向IAM用户添加新的访问密钥。您最多可拥有两个访问密钥。如果您已有两个密钥，则必须删除一个密钥对，然后再创建新的密钥。要查看说明，请参阅IAM用户指南中的管理访问密钥。

我是一名管理员，想允许其他人访问 CodeCommit

要允许其他人访问 CodeCommit，您必须向需要访问的人员或应用程序授予权限。如果使用 AWS IAM Identity Center 管理人员和应用程序，则可以向用户或组分配权限集以定义其访问级别。权限集会自动创建IAM策略并将其分配给与个人或应用程序关联的IAM角色。有关更多信息，请参阅《AWS IAM Identity Center User Guide》中的 Permission sets。

如果您不使用 Ident IAM ity Center，则必须为需要访问权限的人员或应用程序创建IAM实体（用户或角色）。然后，您必须将策略附加到授予他们在中的正确权限的实体 CodeCommit。授予权限后，向用户或应用程序开发人员提供凭证。他们将使用这些凭证访问 AWS。要了解有关创建IAM用户、群组、策略和权限的更多信息，请参阅IAM用户指南IAM中的IAM身份、策略和权限。

我想允许我的亚马逊 Web Services 账户之外的人访问我的 CodeCommit 资源

有关更多信息，请参阅 使用角色配置对 AWS CodeCommit 仓库的跨账户访问权限。