Amazon Elastic Container Registry가 IAM과 작동하는 방식

IAM을 사용하여 Amazon ECR에 대한 액세스를 관리하기 전에 Amazon ECR에서 사용할 수 있는 IAM 기능을 이해해야 합니다. Amazon ECR 및 기타 AWS 서비스가 IAM과 어떻게 연동되는지 자세히 알아보려면 IAM 사용 설명서의 IAM과 연동되는AWS 서비스를 참조하십시오.

Amazon ECR 자격 증명 기반 정책

IAM 자격 증명 기반 정책을 사용하면 허용되거나 거부되는 작업와 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. Amazon ECR은 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 IAM 사용 설명서의 IAM JSON 정책 요소 참조를 참조하세요.

작업

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 보안 주체가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는 지를 지정할 수 있습니다.

JSON 정책의 Action요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 태스크를 설명합니다. 정책 작업은 일반적으로 관련 AWS API 작업과 이름이 같습니다. 일치하는 API 작업이 없는 권한 전용 작업 같은 몇 가지 예외도 있습니다. 정책에서 여러 작업이 필요한 몇 가지 작업도 있습니다. 이러한 추가 작업을 종속 작업이라고 합니다.

연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하십시오.

Amazon ECR의 정책 작업은 작업 앞에 다음 접두사를 사용합니다 ecr:. 예를 들어 Amazon ECR CreateRepository API 작업으로 Amazon ECR 리포지토리를 생성할 수 있는 권한을 누군가에게 부여하려면 해당 정책에 ecr:CreateRepository 작업을 포함합니다. 정책 문에는 Action 또는 NotAction 요소가 포함되어야 합니다. Amazon ECR은 이 서비스로 수행할 수 있는 태스크를 설명하는 고유한 작업 집합을 정의합니다.

명령문 하나에 여러 태스크를 지정하려면 다음과 같이 쉼표로 구분합니다.

"Action": [
      "ecr:action1",
      "ecr:action2"

와일드카드(*)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, Describe라는 단어로 시작하는 모든 태스크를 지정하려면 다음 태스크를 포함합니다.

"Action": "ecr:Describe*"

Amazon ECR 작업 목록을 보려면 IAM 사용 설명서의 Amazon Elastic Container Registry에 사용되는 작업, 리소스 및 조건 키를 참조하십시오.

리소스

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 보안 주체가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.

Resource JSON 정책 요소는 작업이 적용되는 하나 이상의 개체를 지정합니다. 문장에는 Resource또는 NotResource요소가 반드시 추가되어야 합니다. 모범 사례에 따라 리소스 이름(ARN)을 사용하여 리소스를 지정합니다. 리소스 수준 권한이라고 하는 특정 리소스 유형을 지원하는 작업에 대해 이 작업을 수행할 수 있습니다.

작업 나열과 같이 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(*)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.

"Resource": "*"

Amazon ECR 리포지토리 리소스에는 다음의 ARN이 있습니다.

arn:${Partition}:ecr:${Region}:${Account}:repository/${Repository-name}

ARN 형식에 대한 자세한 내용은 Amazon 리소스 이름 (ARN) 및 AWS 서비스 네임스페이스를 참조하십시오.

예를 들어 문에서 us-east-1 리전의 my-repo 리포지토리를 지정하려면 다음 ARN을 사용하십시오.

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/my-repo"

특정 계정에 속한 모든 리포지토리를 지정하려면 와일드카드(*)를 사용합니다.

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/*"

단일 문에서 여러 리소스를 지정하려면 ARN을 쉼표로 구분합니다.

"Resource": [
      "resource1",
      "resource2"

Amazon ECR 리소스 유형 및 해당 ARN의 목록을 보려면 IAM 사용 설명서의 Amazon Elastic Container Registry에서 정의한 리소스를 참조하십시오. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 Amazon Elastic Container Registry에서 정의한 작업을 참조하세요.

조건 키

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 보안 주체가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.

Condition 요소(또는 Condition블록)를 사용하면 정책이 발효되는 조건을 지정할 수 있습니다. Condition 요소는 옵션입니다. 같거나 작음과 같은 조건 연산자를 사용하여 정책의 조건을 요청의 값과 일치시키는 조건식을 생성할 수 있습니다.

한 문에서 여러 Condition요소를 지정하거나 단일 Condition요소에서 여러 키를 지정하는 경우 AWS 는 논리적 AND태스크를 사용하여 평가합니다. 단일 조건 키에 여러 값을 지정하는 경우 는 논리적 OR 연산을 사용하여 조건을 AWS 평가합니다. 명문의 권한을 부여하기 전에 모든 조건을 충족해야 합니다.

조건을 지정할 때 자리 표시자 변수를 사용할 수도 있습니다. 예를 들어, IAM 사용자에게 IAM 사용자 이름으로 태그가 지정된 경우에만 리소스에 액세스할 수 있는 권한을 부여할 수 있습니다. 자세한 정보는 IAM 사용자 설명서의 IAM 정책 요소: 변수 및 태그를 참조하세요.

AWS 글로벌 조건 키 및 서비스별 조건 키를 지원합니다. 모든 AWS 글로벌 조건 키를 보려면 IAM 사용 AWS 설명서의 글로벌 조건 컨텍스트 키를 참조하십시오.

Amazon ECR은 자체 조건 키 집합을 정의하며 일부 전역 조건 키 사용도 지원합니다. 모든 AWS 글로벌 조건 키를 보려면 IAM 사용 설명서의AWS 글로벌 조건 컨텍스트 키를 참조하십시오.

대부분의 Amazon ECR 작업에서는 aws:ResourceTag 및 ecr:ResourceTag 조건 키를 지원합니다. 자세한 정보는 태그 기반 액세스 제어 사용을 참조하세요.

Amazon ECR 조건 키 목록은 IAM 사용 설명서의 Amazon Elastic Container Registry에서 정의한 조건 키를 참조하십시오. 조건 키를 사용할 수 있는 작업과 리소스를 알아보려면 Amazon Elastic Container Registry에서 정의한 작업을 참조하세요.

예제

Amazon ECR 자격 증명 기반 정책 예제를 보려면 Amazon Elastic Container Registry 자격 증명 기반 정책 예제을(를) 참조하세요.

Amazon ECR 리소스 기반 정책

리소스 기반 정책은 지정된 주체가 Amazon ECR 리소스에 대해 수행할 수 있는 작업 및 관련 조건을 지정하는 JSON 정책 문서입니다. Amazon ECR은 Amazon ECR 리포지토리에 대한 리소스 기반 권한 정책을 지원합니다. 리소스 기반 정책을 사용하여 리소스별로 다른 계정에 사용 권한을 부여할 수 있습니다. 또한 리소스 기반 정책을 사용하여 AWS 서비스가 Amazon ECR 리포지토리에 액세스하도록 허용할 수 있습니다.

크로스 계정 액세스를 활성화하려는 경우, 전체 계정이나 다른 계정의 IAM 엔터티를 리소스 기반 정책의 보안 주체로 지정할 수 있습니다. 리소스 기반 정책에 크로스 계정 보안 주체를 추가하는 것은 신뢰 관계 설정의 절반밖에 되지 않습니다. 보안 주체와 리소스가 서로 다른 AWS 계정에 있는 경우 보안 주체 엔티티에 리소스에 액세스할 수 있는 권한도 부여해야 합니다. 엔터티에 보안 인증 기반 정책을 연결하여 권한을 부여합니다. 하지만 리소스 기반 정책이 동일 계정의 보안 주체에 액세스를 부여하는 경우 추가 자격 증명 기반 정책이 필요하지 않습니다. 자세한 내용은 IAM 사용자 설명서의 IAM 역할과 리소스 기반 정책의 차이를 참조합니다.

Amazon ECR 서비스는 리소스 기반 정책 중 한 가지 유형만 지원하는데, 이 정책 유형은 리포지토리 정책이라고 하며 리포지토리에 연결되어 있습니다. 이 정책은 리포지토리에서 작업을 수행할 수 있는 주체 엔터티(계정, 사용자, 역할 및 페더레이션 사용자)를 정의합니다. 리포지토리에 리소스 기반 정책을 연결하는 방법은 프라이빗 리포지토리 정책 단원을 참조하십시오.

참고

Amazon ECR 리포지토리 정책에서 정책 요소 Sid는 IAM 정책에서 지원되지 않는 추가 문자 및 공백을 지원합니다.

예제

Amazon ECR 리소스 기반 정책의 예를 보려면 프라이빗 리포지토리 정책 예제을(를) 참조하십시오,

Amazon ECR 태그 기반 권한 부여

Amazon ECR 리소스에 태그를 연결하거나 Amazon ECR에 대한 요청에서 태그를 전달할 수 있습니다. 태그를 기반으로 액세스를 제어하려면 ecr:ResourceTag/key-name, aws:RequestTag/key-name 또는 aws:TagKeys 조건 키를 사용하여 정책의 조건 요소에 태그 정보를 제공합니다. Amazon ECR 리소스 태깅에 대한 자세한 내용은 프라이빗 리포지토리 태깅을(를) 참조하세요.

리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예제는 태그 기반 액세스 제어 사용 섹션에서 확인할 수 있습니다.

Amazon ECR IAM 역할

IAM 역할은 AWS 계정 내에서 특정 권한을 가진 엔티티입니다.

Amazon ECR에서 임시 자격 증명 사용

임시 보안 인증을 사용하여 연동을 통해 로그인하거나, IAM 역할을 맡거나, 교차 계정 역할을 맡을 수 있습니다. AssumeRole또는 GetFederationToken같은 AWS STS API 작업을 호출하여 임시 보안 자격 증명을 얻습니다.

Amazon ECR은 임시 자격 증명 사용을 지원합니다.

서비스 연결 역할

서비스 연결 역할을 사용하면 AWS 서비스가 다른 서비스의 리소스에 액세스하여 사용자를 대신하여 작업을 완료할 수 있습니다. 서비스 연결 역할은 IAM 계정에 나타나고 서비스가 소유합니다. IAM 관리자는 서비스 연결 역할의 권한을 볼 수 있지만 편집할 수 없습니다.

Amazon ECR은 서비스 연결 역할을 지원합니다. 자세한 정보는 Amazon ECR에 대한 서비스 연결 역할 사용을 참조하세요.