에 대한 자격 증명 기반 정책 예제 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에서 정의한 작업 및 리소스 유형에 ARNs 대한 자세한 내용은 서비스 승인 참조의 에 대한 작업, 리소스 및 조건 키를 AWS CodeArtifact 참조하세요.

정책 모범 사례

자격 증명 기반 정책은 계정에서 CodeArtifact 리소스를 생성, 액세스 또는 삭제할 수 있는지 여부를 결정합니다. 이 작업으로 인해 AWS 계정에 비용이 발생할 수 있습니다. ID 기반 정책을 생성하거나 편집할 때는 다음 지침과 권장 사항을 따릅니다.

  • AWS 관리형 정책을 시작하고 최소 권한 권한으로 전환 - 사용자 및 워크로드에 권한 부여를 시작하려면 많은 일반적인 사용 사례에 대한 권한을 부여하는 AWS 관리형 정책을 사용합니다. 에서 사용할 수 있습니다 AWS 계정. 사용 사례에 맞는 AWS 고객 관리형 정책을 정의하여 권한을 추가로 줄이는 것이 좋습니다. 자세한 내용은 IAM 사용 설명서의 관리AWS 형 정책 또는 AWS 작업 함수에 대한 관리형 정책을 참조하세요.

  • 최소 권한 적용 - IAM 정책으로 권한을 설정할 때 작업을 수행하는 데 필요한 권한만 부여합니다. 이렇게 하려면 최소 권한으로 알려진 특정 조건에서 특정 리소스에 대해 수행할 수 있는 작업을 정의합니다. 를 사용하여 권한을 적용하는 IAM 방법에 대한 자세한 내용은 IAM 사용 설명서의 에서 정책 및 권한을 IAM 참조하세요.

  • IAM 정책의 조건을 사용하여 액세스를 추가로 제한합니다. - 정책에 조건을 추가하여 작업 및 리소스에 대한 액세스를 제한할 수 있습니다. 예를 들어 정책 조건을 작성하여 를 사용하여 모든 요청을 전송하도록 지정할 수 있습니다SSL. AWS 서비스와 같은 특정 를 통해 서비스 작업을 사용하는 경우 조건을 사용하여 서비스 작업에 대한 액세스 권한을 부여할 수도 있습니다 AWS CloudFormation. 자세한 내용은 IAM 사용 설명서의 IAM JSON 정책 요소: 조건을 참조하세요.

  • IAM Access Analyzer를 사용하여 IAM 정책을 검증하여 안전하고 기능적인 권한을 보장합니다. IAM Access Analyzer는 정책이 정책 언어(JSON) 및 IAM 모범 사례를 준수하도록 새 정책 및 기존 IAM 정책을 검증합니다. IAM Access Analyzer는 안전하고 기능적인 정책을 작성하는 데 도움이 되는 100개 이상의 정책 확인 및 실행 가능한 권장 사항을 제공합니다. 자세한 내용은 IAM 사용 설명서의 IAM Access Analyzer를 사용한 정책 검증을 참조하세요.

  • 다중 인증 필요(MFA) - 에 IAM 사용자 또는 루트 사용자가 필요한 시나리오가 있는 경우 추가 보안을 MFA 위해 를 AWS 계정켭니다. API 작업을 호출할 MFA 때 를 요구하려면 정책에 MFA 조건을 추가합니다. 자세한 내용은 IAM 사용 설명서의 를 사용한 보안 API 액세스를 MFA 참조하세요.

의 모범 사례에 대한 자세한 내용은 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.

작업 및 리소스에 대한 CodeArtifact 권한을 허용하는 사용자 지정 IAM 정책을 생성할 수도 있습니다. 이러한 권한이 필요한 IAM 사용자 또는 그룹에 이러한 사용자 지정 정책을 연결할 수 있습니다.

사용자가 자신의 권한을 볼 수 있도록 허용

이 예제에서는 IAM 사용자가 사용자 ID에 연결된 인라인 및 관리형 정책을 볼 수 있도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이 정책에는 콘솔에서 또는 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 리포지토리에서 패키지를 가져올 수 있는 codeArtifact:ReadFromRepository 권한도 포함되어 있습니다. 새 도메인이나 리포지토리를 생성할 수 없으며 새 패키지를 게시하는 것도 허용되지 않습니다.

를 호출하려면 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"
            }
         }
      }
   ]
}

사용자가 특정 도메인에 대한 정보를 가져올 수 있도록 허용

다음은 my라는 이름으로 시작하는 모든 도메인에 대해 사용자가 123456789012 계정의 us-east-2 리전에 있는 도메인만 나열할 수 있도록 허용하는 권한 정책의 예입니다.

{
   "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시간(43,200초)으로 제한

이 정책을 사용하면 사용자는 수명이 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시간 기간 동안만 유효한 토큰을 생성할 수 있습니다. 또한 사용자는 0 및 --durationSeconds를 지정하여 역할의 임시 보안 인증 기간 동안 지속되는 토큰을 생성할 수 있습니다.

{
    "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"
                }
            }
        }
    ]
}