受众使用身份进行身份验证使用策略管理访问 CodeCommit 基于资源的策略基于 CodeCommit 标签的授权 CodeCommit IAM 角色基于身份的策略示例故障排除

适用于 Amazon CodeCommit 的 Identity and Access Management

Amazon Identity and Access Management（IAM）是一项 Amazon Web Services 服务，可以帮助管理员安全地控制对 Amazon 资源的访问。IAM 管理员控制可以通过身份验证（登录）和授权（具有权限）使用 CodeCommit 资源的人员。IAM 是一项无需额外费用即可使用的 Amazon Web Services 服务。

主题

受众
使用身份进行身份验证
使用策略管理访问
适用于 Amazon CodeCommit 的身份验证和访问控制
Amazon CodeCommit 如何与 IAM 协同工作
CodeCommit 基于资源的策略
基于 CodeCommit 标签的授权
CodeCommit IAM 角色
Amazon CodeCommit 基于身份的策略示例
排查 Amazon CodeCommit 身份和访问问题

受众

您使用 Amazon Identity and Access Management（IAM）的方式因您的角色而异：

服务用户：如果您无法访问功能，请从管理员处请求权限（请参阅排查 Amazon CodeCommit 身份和访问问题）
服务管理员：确定用户访问权限并提交权限请求（请参阅 Amazon CodeCommit 如何与 IAM 协同工作）
IAM 管理员：编写用于管理访问权限的策略（请参阅 Amazon CodeCommit 基于身份的策略示例）

使用身份进行身份验证

身份验证是您使用身份凭证登录 Amazon 的方法。您必须作为 Amazon Web Services 账户根用户、IAM 用户或通过代入 IAM 角色进行身份验证。

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

Amazon Web Services 账户根用户

当您创建 Amazon Web Services 账户时，最初使用的是一个对所有 Amazon Web Services 服务和资源拥有完全访问权限的登录身份（称为 Amazon Web Services 账户根用户）。强烈建议您不要使用根用户执行日常任务。有关需要根用户凭证的任务，请参阅《IAM 用户指南》中的需要根用户凭证的任务。

IAM 用户和群组

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

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

IAM 角色

IAM 角色是具有特定权限的身份，可提供临时凭证。您可以通过从用户切换到 IAM 角色（控制台）或调用 Amazon CLI 或 Amazon API 操作来代入角色。有关更多信息，请参阅《IAM 用户指南》中的担任角色的方法。

IAM 角色对于联合用户访问、临时 IAM 用户权限、跨账户访问、跨服务访问以及在 Amazon EC2 上运行的应用程序非常有用。有关更多信息，请参阅《IAM 用户指南》中的 IAM 中的跨账户资源访问。

使用策略管理访问

您将创建策略并将其附加到 Amazon 身份或资源，以控制 Amazon 中的访问。策略定义与身份或资源关联时的权限。当主体发出请求时，Amazon 将评估这些策略。大多数策略在 Amazon 中存储为 JSON 文档。有关 JSON 策略文档的更多信息，请参阅《IAM 用户指南》中的 JSON 策略概述。

管理员使用策略，通过定义哪个主体可以对什么资源以及在什么条件下执行操作，来指定谁有权访问什么内容。

默认情况下，用户和角色没有权限。IAM 管理员创建 IAM 策略并将其添加到角色中，然后用户可以代入这些角色。IAM 策略定义权限，而不考虑您使用哪种方法来执行操作。

基于身份的策略

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

基于身份的策略可以是内联策略（直接嵌入到单个身份中）或托管式策略（附加到多个身份的独立策略）。要了解如何在托管式策略和内联策略之间进行选择，请参阅《IAM 用户指南》中的在托管式策略与内联策略之间进行选择。

基于资源的策略

基于资源的策略是附加到资源的 JSON 策略文档。示例包括 IAM 角色信任策略和 Amazon S3 存储桶策略。在支持基于资源的策略的服务中，服务管理员可以使用它们来控制对特定资源的访问。您必须在基于资源的策略中指定主体。

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

访问控制列表（ACL）

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

Amazon S3、Amazon WAF 和 Amazon VPC 是支持 ACL 的服务示例。要了解有关 ACL 的更多信息，请参阅《Amazon Simple Storage Service 开发人员指南》中的访问控制列表（ACL）概览。

其他策略类型

Amazon 支持额外的策略类型，这些策略类型可以设置由更常用的策略类型授予的最大权限：

权限边界：设置基于身份的策略可以授予 IAM 实体的最大权限。有关更多信息，请参阅《IAM 用户指南》中的 IAM 实体的权限边界。
服务控制策略（SCP）：指定 Amazon Organizations 中组织或组织单元的最大权限。有关更多信息，请参阅《Amazon Organizations 用户指南》中的服务控制策略。
资源控制策略（RCP）：设置对账户中资源的最大可用权限。有关更多信息，请参阅《Amazon Organizations User Guide》中的 Resource control policies (RCPs)。
会话策略：在为角色或联合用户创建临时会话时，作为参数传递的高级策略。有关更多信息，请参阅《IAM 用户指南》中的会话策略。

多个策略类型

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

CodeCommit 基于资源的策略

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

基于 CodeCommit 标签的授权

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

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

在 CodeCommit 中使用标签提供标识信息

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

键名称	值
`displayName`	要显示并要与用户关联的便于阅读的名称（例如 Mary Major 或 Saanvi Sarkar）。
`emailAddress`	您希望为用户显示并与用户关联的电子邮件地址（例如 mary_major@example.com 或 saanvi_sarkar@example.com）。

如果提供了这些信息，CodeCommit 会将其包含在发送到 Amazon EventBridge 和 Amazon CloudWatch Events 的事件中。有关更多信息，请参阅在 Amazon EventBridge 和 Amazon CloudWatch Events 中监控 CodeCommit 事件。

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

声明名称	值
`https://aws.amazon.com/SAML/Attributes/PrincipalTag:displayNam`e	`user.displayname`
`https://aws.amazon.com/SAML/Attributes/PrincipalTag:emailAddress`	`user.mail`

您可以使用 Amazon 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 解决方案与 Amazon 集成。如果是这样，则可以将 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) 中包含会话标签。例如，用于调用 AssumeRoleWithWebIdentity 的已解码 JWP 令牌，其中包括名为 Li Juan 的用户的 displayName 和 emailAddress 会话标签：


{
    "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 存储库时使用这些标签。例如，要使用 Amazon CLI 获取包含 displayName 和 emailAddress 标签的联合令牌：


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 角色是 Amazon Web Services 账户中具有特定权限的实体。

在 CodeCommit 中使用临时凭证

可以使用临时凭证进行联合身份验证登录，分派 IAM 角色或分派跨账户角色。可以通过调用 Amazon STS API 操作（如 AssumeRole 或 GetFederationToken）获得临时安全凭证。

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

服务相关角色

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

CodeCommit 不使用服务相关角色。

服务角色

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

CodeCommit 不使用服务角色。

Amazon CodeCommit 基于身份的策略示例

默认情况下，IAM 用户和角色没有创建或修改 CodeCommit 资源的权限。它们还无法使用 Amazon Web Services 管理控制台、Amazon CLI 或 Amazon API 执行任务。IAM 管理员必须创建 IAM 策略，以便为用户和角色授予权限以对所需的指定资源执行特定的 API 操作。然后，管理员必须将这些策略附加到需要这些权限的 IAM 用户或组。

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

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

策略最佳实践

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

Amazon 托管式策略及转向最低权限许可入门 – 要开始向用户和工作负载授予权限，请使用 Amazon 托管式策略来为许多常见使用场景授予权限。您可以在 Amazon Web Services 账户中找到这些策略。我们建议通过定义特定于您的使用场景的 Amazon 客户托管式策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》中的 Amazon 托管式策略或工作职能的 Amazon 托管式策略。
应用最低权限：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为最低权限许可。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》中的 IAM 中的策略和权限。
使用 IAM 策略中的条件进一步限制访问权限：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果通过特定 Amazon Web Services 服务（例如 Amazon CloudFormation）使用服务操作，您还可以使用条件来授予对服务操作的访问权限。有关更多信息，请参阅《IAM 用户指南》中的 IAM JSON 策略元素：条件。
使用 IAM Access Analyzer 验证您的 IAM 策略，以确保权限的安全性和功能性 – IAM Access Analyzer 会验证新策略和现有策略，以确保策略符合 IAM 策略语言（JSON）和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议，以帮助您制定安全且功能性强的策略。有关更多信息，请参阅《IAM 用户指南》中的使用 IAM Access Analyzer 验证策略。
需要多重身份验证（MFA）：如果您所处的场景要求您的 Amazon Web Services 账户中有 IAM 用户或根用户，请启用 MFA 来提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》中的使用 MFA 保护 API 访问。

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

使用 CodeCommit 控制台

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

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

有关更多信息，请参阅将基于身份的策略 (IAM policy) 用于 CodeCommit。

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

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

该示例说明了您如何创建策略，以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上完成此操作或者以编程方式使用 Amazon CLI 或 Amazon 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 `存储库`

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

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

排查 Amazon CodeCommit 身份和访问问题

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

主题

我无权在 CodeCommit 中执行操作
我无权执行 iam:PassRole
我想要查看我的访问密钥
我是管理员并希望允许其他人访问 CodeCommit
我希望允许我的 Amazon Web Services 账户之外的用户访问我的 CodeCommit 资源

我无权在 CodeCommit 中执行操作

如果 Amazon Web Services 管理控制台告诉您，您无权执行某个操作，则必须联系您的管理员寻求帮助。管理员是向您提供登录凭证的人。

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

我无权执行 iam:PassRole

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

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

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


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

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

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

我想要查看我的访问密钥

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

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

重要

请不要向第三方提供访问密钥，即便是为了帮助找到您的规范用户 ID 也不行。如果您这样做，可能会向某人提供对您的 Amazon Web Services 账户账户的永久访问权限。

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

我是管理员并希望允许其他人访问 CodeCommit

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

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

我希望允许我的 Amazon Web Services 账户之外的用户访问我的 CodeCommit 资源

有关更多信息，请参阅使用角色配置对 Amazon CodeCommit 存储库的跨账户访问。

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

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

使用轮换凭证

身份验证和访问控制