기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS CodePipeline 에서 IAM을 사용하는 방법
<a name="security_iam_service-with-iam"></a>

IAM을 사용하여 CodePipeline에 대한 액세스를 관리하려면 먼저 어떤 IAM 기능을 CodePipeline에 사용할 수 있는지를 이해해야 합니다. CodePipeline 및 IAM으로 작업 AWS 서비스 하는 기타를 전체적으로 알아보려면 *IAM 사용 설명서*의 [AWS 서비스 IAM으로 작업하는](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 섹션을 참조하세요.

**Topics**
+ [

## CodePipeline 자격 증명 기반 정책
](#security_iam_service-with-iam-id-based-policies)
+ [

## CodePipeline 리소스 기반 정책
](#security_iam_service-with-iam-resource-based-policies)
+ [

## CodePipeline 태그 기반 권한 부여
](#security_iam_service-with-iam-tags)
+ [

## CodePipeline IAM 역할
](#security_iam_service-with-iam-roles)

## CodePipeline 자격 증명 기반 정책
<a name="security_iam_service-with-iam-id-based-policies"></a>

IAM ID 기반 정책을 사용하면 허용되거나 거부되는 작업과 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. CodePipeline은 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 *IAM 사용 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요.

### 작업
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

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

JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.

CodePipeline의 정책 작업은 작업 앞에 `codepipeline:` 접두사를 사용합니다.

예를 들어 누군가에게 계정 내에 있는 기존 파이프라인을 볼 수 있는 권한을 부여하려면 정책에 `codepipeline:GetPipeline` 작업을 포함시킵니다. 정책 문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. CodePipeline은 이 서비스로 수행할 수 있는 작업을 설명하는 고유한 작업 세트를 정의합니다.

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

```
"Action": [
      "codepipeline:action1",
      "codepipeline:action2"
```

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

```
"Action": "codepipeline:Get*"
```



CodePipeline 작업 목록에 대해서는 *IAM 사용 설명서*의 [AWS CodePipeline에서 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awscodepipeline.html#awscodepipeline-actions-as-permissions)을 참조하세요.

### 리소스
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

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

`Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\$1)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.

```
"Resource": "*"
```



#### 리소스 및 작업
<a name="ACP_ARN_Format"></a>

에서는 파이프라인이 기본 리소스입니다. 정책에서는 Amazon 리소스 이름(ARN)을 사용하여 정책이 적용되는 리소스를 식별합니다. 는 기본 리소스와 함께 사용할 수 있는 다른 리소스(예: 단계, 작업, 사용자 지정 작업)를 지원합니다. 이러한 리소스를 가리켜 하위 리소스라 합니다. 이러한 리소스와 하위 리소스에는 고유한 Amazon 리소스 이름(ARN)이 연결됩니다. ARNs에 대한 자세한 내용은의 [Amazon 리소스 이름(ARN) 및 AWS 서비스 네임스페이스](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)를 참조하세요*Amazon Web Services 일반 참조*. 파이프라인과 연결된 파이프라인 ARN을 가져오려면 콘솔의 **설정**에서 파이프라인 ARN을 찾을 수 있습니다. 자세한 내용은 [파이프라인 ARN 및 서비스 역할 ARN 보기(콘솔)](pipelines-settings-console.md) 단원을 참조하십시오.


| 리소스 유형 | ARN 형식 | 
| --- | --- | 
|  파이프라인  |  arn:aws:codepipeline:*region*:*account*:*pipeline-name*  | 
| 단계 |  arn:aws:codepipeline:*region*:*account*:*pipeline-name*/*stage-name*  | 
| 작업 |  arn:aws:codepipeline:*region*:*account*:*pipeline-name*/*stage-name*/*action-name*  | 
| 사용자 지정 작업 | arn:aws:codepipeline:region:account:actiontype:owner/category/provider/version | 
|  모든 리소스  |  arn:aws:codepipeline:\$1  | 
|  지정한 리전에서 지정한 계정이 소유한 모든 리소스  |  arn:aws:codepipeline:*region*:*account*:\$1  | 

**참고**  
의 대부분의 서비스는 콜론(:) 또는 슬래시(/)를 ARN에서 동일한 문자로 AWS 취급합니다. ARNs 그러나 는 이벤트 패턴 및 규칙에서 정확히 일치를 사용합니다. 따라서 이벤트 패턴을 만들 때 일치시키려는 파이프라인에서 ARN 구문이 일치하도록 정확한 ARN 문자를 사용해야 합니다.

에는 리소스 수준 권한을 지원하는 API 호출이 있습니다. 리소스 수준 권한은 API 호출이 리소스 ARN을 지정할 수 있는지, 또는 API 호출이 와일드카드를 사용해야만 모든 리소스를 지정할 수 있는지 나타냅니다. 리소스 수준 권한과 리소스 수준 권한을 지원하는 CodePipeline API 직접 호출 목록에 대한 자세한 설명은 [권한 참조](permissions-reference.md) 단원을 참조하세요.

예를 들어 명령문에서 다음과 같이 ARN을 사용하여 특정 파이프라인(*myPipeline*)을 나타낼 수 있습니다.

```
"Resource": "arn:aws:codepipeline:us-east-2:111222333444:myPipeline"
```

다음과 같이 (\$1) 와일드카드 문자를 사용하여 특정 계정에 속하는 모든 파이프라인을 지정할 수도 있습니다.

```
"Resource": "arn:aws:codepipeline:us-east-2:111222333444:*"
```

모든 리소스를 지정해야 하거나 특정 API 작업이 ARN을 지원하지 않는 경우 다음과 같이 `Resource` 요소에 와일드카드 문자(\$1)를 사용합니다.

```
"Resource": "*"
```

**참고**  
IAM 정책을 만들 때 최소 권한 부여의 기본 보안 조언을 따릅니다. 즉, 작업 수행에 필요한 최소한의 권한만 부여합니다. API 호출이 ARN을 지원하는 경우 리소스 수준 권한을 지원하므로 와일드카드 문자(\$1)를 사용할 필요가 없습니다.

일부 API 호출은 여러 리소스(예: `GetPipeline`)를 허용합니다. 명령문 하나에 여러 리소스를 지정하려면 다음과 같이 각 ARN을 쉼표로 구분합니다.

```
"Resource": ["arn1", "arn2"]
```

 는 리소스로 작업할 수 있는 일련의 작업을 제공합니다. 사용 가능한 작업 목록은 [권한 참조](permissions-reference.md) 섹션을 참조하십시오.

### 조건 키
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

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

`Condition` 요소는 정의된 기준에 따라 문이 실행되는 시기를 지정합니다. 같음(equals) 또는 미만(less than)과 같은 [조건 연산자](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)를 사용하여 정책의 조건을 요청의 값과 일치시키는 조건식을 생성할 수 있습니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 참조하세요.

CodePipeline에서는 자체 조건 키 집합을 정의하고 일부 전역 조건 키 사용도 지원합니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html).



 모든 Amazon EC2 작업은 `aws:RequestedRegion` 및 `ec2:Region` 조건 키를 지원합니다. 자세한 내용은 [예제: 특정 리전으로 액세스 제한](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ExamplePolicies_EC2.html#iam-example-region)을 참조하세요.

CodePipeline 조건 키 목록을 보려면 *IAM 사용자 설명서*에서 [AWS CodePipeline에 대한 조건 키](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awscodepipeline.html#awscodepipeline-policy-keys)를 참조하세요. 조건 키를 사용할 수 있는 작업과 리소스를 알아보려면 [에서 정의한 작업을 AWS CodePipeline](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awscodepipeline.html#awscodepipeline-actions-as-permissions) 참조하세요.

### 예제
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



CodePipeline 자격 증명 기반 정책 예제를 보려면 [AWS CodePipeline 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md) 섹션을 참조하세요.

## CodePipeline 리소스 기반 정책
<a name="security_iam_service-with-iam-resource-based-policies"></a>

CodePipeline은 리소스 기반 정책을 지원하지 않습니다. 그러나 CodePipeline과 관련된 S3 서비스에 대한 리소스 기반 정책의 예가 제공됩니다.

### 예제
<a name="security_iam_service-with-iam-resource-based-policies-examples"></a>



CodePipeline 리소스 기반 정책의 예는 [AWS CodePipeline 리소스 기반 정책 예제](security_iam_resource-based-policy-examples.md) 섹션을 참조하세요.

## CodePipeline 태그 기반 권한 부여
<a name="security_iam_service-with-iam-tags"></a>

태그를 CodePipeline 리소스에 연결하거나 요청을 통해 태그를 CodePipeline에 전달할 수 있습니다. 태그에 근거하여 액세스를 제어하려면 `codepipeline:ResourceTag/key-name`, `aws:RequestTag/key-name`또는 `aws:TagKeys`조건 키를 사용하여 정책의 [조건 요소](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)에 태그 정보를 제공합니다. CodePipeline 리소스 태깅에 대한 자세한 내용은 [리소스에 태그 지정](tag-resources.md) 섹션을 참조하세요.

리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예시는 [태그를 사용하여 CodePipeline 리소스에 대한 액세스 통제](tag-based-access-control.md)에서 확인할 수 있습니다.

## CodePipeline IAM 역할
<a name="security_iam_service-with-iam-roles"></a>

[IAM 역할은](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 특정 권한이 있는 AWS 계정의 엔터티입니다.

### CodePipeline에서 임시 자격 증명 사용
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

임시 보안 인증을 사용하여 페더레이션을 통해 로그인하거나, IAM 역할을 맡거나, 교차 계정 역할을 맡을 수 있습니다. [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) 또는 [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)과 같은 AWS STS API 작업을 호출하여 임시 보안 자격 증명을 얻습니다.

CodePipeline에서 임시 자격 증명 사용을 지원합니다.

### 서비스 역할
<a name="security_iam_service-with-iam-roles-service"></a>

CodePipeline을 사용하면 서비스가 사용자를 대신해 [서비스 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)을 맡을 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 IAM 계정에 나타나고, 해당 계정이 소유합니다. 즉, IAM 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다.

CodePipeline은 서비스 역할을 지원합니다.