基于身份的策略示例 AWS CodeArtifact - CodeArtifact
策略最佳实践使用控制台AWS的托管（预定义）策略 AWS CodeArtifact允许用户查看他们自己的权限允许用户获取有关存储库和域的信息允许用户获取有关特定域的信息允许用户获取有关特定存储库的信息限制授权令牌持续时间

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

基于身份的策略示例 AWS CodeArtifact

默认情况下，用户和角色无权创建或修改 CodeArtifact资源。他们也无法使用 AWS Management Console、 AWS Command Line Interface (AWS CLI) 或来执行任务 AWS API。要授予用户对其所需资源执行操作的权限，IAM管理员可以创建IAM策略。然后，管理员可以将IAM策略添加到角色中，用户可以代入这些角色。

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

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

策略最佳实践

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

  • 开始使用 AWS 托管策略并转向最低权限权限 — 要开始向用户和工作负载授予权限，请使用为许多常见用例授予权限的AWS 托管策略。它们在你的版本中可用 AWS 账户。我们建议您通过定义针对您的用例的 AWS 客户托管策略来进一步减少权限。有关更多信息，请参阅《IAM用户指南》中的AWS 托AWS 管策略或工作职能托管策略。

  • 应用最低权限权限-使用IAM策略设置权限时，仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为最低权限许可。有关使用应用权限IAM的更多信息，请参阅《IAM用户指南》IAM中的策略和权限。

  • 使用IAM策略中的条件进一步限制访问权限-您可以在策略中添加条件以限制对操作和资源的访问权限。例如，您可以编写一个策略条件来指定所有请求都必须使用发送SSL。如果服务操作是通过特定 AWS 服务的（例如）使用的，则也可以使用条件来授予对服务操作的访问权限 AWS CloudFormation。有关更多信息，请参阅《IAM用户指南》中的IAMJSON策略元素：条件。

  • 使用 A IAM ccess Analyzer 验证您的IAM策略以确保权限的安全性和功能性 — A IAM ccess Analyzer 会验证新的和现有的策略，以便策略符合IAM策略语言 (JSON) 和IAM最佳实践。IAMAccess Analyzer 提供了 100 多项策略检查和可行的建议，可帮助您制定安全和实用的策略。有关更多信息，请参阅《IAM用户指南》中的 IAMAccess Analyzer 策略验证。

  • 需要多重身份验证 (MFA)-如果您的场景需要IAM用户或 root 用户 AWS 账户，请打开MFA以提高安全性。要要求MFA何时调用API操作，请在策略中添加MFA条件。有关更多信息，请参阅《IAM用户指南》中的配置MFA受保护的API访问权限。

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

使用控制 CodeArtifact台

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

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

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

AWS的托管（预定义）策略 AWS CodeArtifact

AWS 通过提供由创建和管理的独立IAM策略来解决许多常见用例 AWS。这些 AWS 托管策略为常见用例授予必要的权限，因此您可以不必调查需要哪些权限。有关更多信息，请参阅《IAM用户指南》中的AWS托管策略。

以下 AWS 托管策略是特定的，您可以将其附加到账户中的用户 AWS CodeArtifact。

  • AWSCodeArtifactAdminAccess— 提供对域名的完全访问权限， CodeArtifact 包括管理 CodeArtifact 域的权限。

    {
   "Version": "2012-10-17",
   "Statement": [
      {
         "Action": [
            "codeartifact:*"
         ],
         "Effect": "Allow",
         "Resource": "*"
      },
      {
         "Effect": "Allow",
         "Action": "sts:GetServiceBearerToken",
         "Resource": "*",
         "Condition": {
            "StringEquals": {
               "sts:AWSServiceName": "codeartifact.amazonaws.com"
            }
         }
      }
   ]
}

  • AWSCodeArtifactReadOnlyAccess— 提供对的只读访问权限 CodeArtifact。

    {
   "Version": "2012-10-17",
   "Statement": [
      {
         "Action": [
            "codeartifact:Describe*",
            "codeartifact:Get*",
            "codeartifact:List*",
            "codeartifact:ReadFromRepository"
         ],
         "Effect": "Allow",
         "Resource": "*"
      },
      {
         "Effect": "Allow",
         "Action": "sts:GetServiceBearerToken",
         "Resource": "*",
         "Condition": {
            "StringEquals": {
               "sts:AWSServiceName": "codeartifact.amazonaws.com"
            }
         }
      }  
   ]
}

要创建和管理 CodeArtifact 服务角色，还必须附加名为的 AWS 托管策略IAMFullAccess。

您也可以创建自己的自定义IAM策略，以授予 CodeArtifact操作和资源的权限。您可以将这些自定义策略附加到需要这些权限的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": "*"
        }
    ]
}

允许用户获取有关存储库和域的信息

以下策略允许IAM用户或角色列出和描述任何类型的 CodeArtifact 资源，包括域、存储库、包和资产。该策略还包括codeArtifact:ReadFromRepository权限，允许委托人从 CodeArtifact 存储库中获取软件包。该策略不允许创建新域或存储库，也不允许发布新的程序包。

需要codeartifact:GetAuthorizationToken和sts:GetServiceBearerToken权限才能调用GetAuthorizationTokenAPI。

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": [
            "codeartifact:List*",
            "codeartifact:Describe*",
            "codeartifact:Get*",
            "codeartifact:Read*"
         ],
         "Resource": "*"      
      },
      {
         "Effect": "Allow",
         "Action": "sts:GetServiceBearerToken",
         "Resource": "*",
         "Condition": {
            "StringEquals": {
               "sts:AWSServiceName": "codeartifact.amazonaws.com"
            }
         }
      }
   ]
}

允许用户获取有关特定域的信息

以下是一个权限策略示例，仅允许用户列出位于账户 123456789012 的 us-east-2 区域中名称以 my 开头的任何域。

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": "codeartifact:ListDomains",
         "Resource": "arn:aws:codeartifact:us-east-2:123456789012:domain/my*"      
      }
   ]
}

允许用户获取有关特定存储库的信息

以下是一个权限策略的示例，允许用户获取有关以 test 结尾的存储库的信息，包括有关存储库中的程序包的信息。用户将无法发布、创建或删除资源。

需要codeartifact:GetAuthorizationToken和sts:GetServiceBearerToken权限才能调用GetAuthorizationTokenAPI。

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": [
            "codeartifact:List*",
            "codeartifact:Describe*",
            "codeartifact:Get*",
            "codeartifact:Read*"
         ],
         "Resource": "arn:aws:codeartifact:*:*:repository/*/*test"      
      },
      {
         "Effect": "Allow",
         "Action": [
            "codeartifact:List*",
            "codeartifact:Describe*"
         ],
         "Resource": "arn:aws:codeartifact:*:*:package/*/*test/*/*/*"   
      },
      {
         "Effect": "Allow",
         "Action": "sts:GetServiceBearerToken",
         "Resource": "*",
         "Condition": {
            "StringEquals": {
               "sts:AWSServiceName": "codeartifact.amazonaws.com"
            }
         }
      },
      {
         "Effect": "Allow",
         "Action": "codeartifact:GetAuthorizationToken",
         "Resource": "*"
      }
   ]
}

限制授权令牌持续时间

用户必须使用授权令牌进行身份验证才能 CodeArtifact 发布或使用软件包版本。授权令牌仅在其配置的有效期限内有效。令牌的默认有效期限为 12 小时。有关授权令牌的更多信息，请参阅AWS CodeArtifact 身份验证和令牌。

提取令牌时，用户可以配置令牌的有效期限。授权令牌有效期限的有效值为 0，以及介于 900（15 分钟）和 43200（12 小时）之间的任意数字。如果值为 0，则会创建一个持续时间与用户角色的临时凭证相等的令牌。

管理员可以使用附加到用户或组的权限策略中的 sts:DurationSeconds 条件键来限制授权令牌有效期限的有效值。如果用户尝试创建有效期限超出有效值的授权令牌，则令牌创建会失败。

以下示例策略限制了 CodeArtifact 用户创建的授权令牌可能的持续时间。

示例策略：将令牌有效期限限制为正好 12 小时（43200 秒）

使用此策略，用户只能创建有效期限为 12 小时的授权令牌。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "codeartifact:*",
            "Resource": "*"
        },
        {
            "Sid": "sts",
            "Effect": "Allow",
            "Action": "sts:GetServiceBearerToken",
            "Resource": "*",
            "Condition": {
                "NumericEquals": {
                    "sts:DurationSeconds": 43200
                },
                "StringEquals": {
                    "sts:AWSServiceName": "codeartifact.amazonaws.com"
                }
            }
        }
    ]
}

策略示例：将令牌的有效期限制在 15 分钟至 1 小时之间，或者等于用户的临时凭证期限

通过此策略，用户将能够创建有效期为 15 分钟至 1 小时的令牌。用户还可以通过将 --durationSeconds 指定为 0，从而创建持续时间与其角色的临时凭证持续时间相等的令牌。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "codeartifact:*",
            "Resource": "*"
        },
        {
            "Sid": "sts",
            "Effect": "Allow",
            "Action": "sts:GetServiceBearerToken",
            "Resource": "*",
            "Condition": {
                "NumericLessThanEquals": {
                    "sts:DurationSeconds": 3600
                },
                "StringEquals": {
                    "sts:AWSServiceName": "codeartifact.amazonaws.com"
                }
            }
        }
    ]
}