本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS CodePipeline 如何使用 IAM
<a name="security_iam_service-with-iam"></a>

在您使用 IAM 管理 CodePipeline 的存取權之前，您應該了解哪些 IAM 功能可與 CodePipeline 搭配使用。若要全面了解 CodePipeline 和其他 AWS 服務 如何與 IAM 搭配使用，請參閱《[AWS 服務 IAM 使用者指南》中的 與 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 身分型政策，您可以指定允許或拒絕的動作和資源，以及在何種條件下允許或拒絕動作。CodePipeline 支援特定動作、資源和條件索引鍵。若要了解您在 JSON 政策中使用的所有元素，請參閱 *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)。

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

管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。

`Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。若動作不支援資源層級許可，使用萬用字元 (\$1) 表示該陳述式適用於所有資源。

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



#### 資源和操作
<a name="ACP_ARN_Format"></a>

在 中，主要資源是管道。在政策中，您會使用 Amazon Resource Name (ARN) 識別政策適用的資源。 支援可搭配主要資源使用的其他資源，例如階段、動作和自訂動作。這些資源稱為「子資源」。這些資源和子資源各與唯一的 Amazon Resource Name (ARN) 相關聯。如需 ARNs 的詳細資訊，請參閱《》中的 [Amazon Resource Names (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*  | 
| Action |  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  | 

**注意**  
中的大多數服務 AWS 會將冒號 (：) 或正斜線 (/) 視為 ARNs中的相同字元。但是， 會在事件模式和規則中使用精確比對。在建立事件模式時，請務必使用正確的 ARN 字元，使這些字元符合您要匹配管道中的 ARN 語法。

在 中，有些 API 呼叫支援資源層級許可。資源層級許可表示 API 呼叫是否能指定資源 ARN，或是 API 呼叫是否可以使用萬用字元指定所有資源。[許可參考](permissions-reference.md) 如需資源層級許可的詳細說明，以及支援資源層級許可的 CodePipeline API 呼叫清單，請參閱 。

例如，您可以指出您陳述式中的特定管道 (*myPipeline*) 其他使用其 ARN：

```
"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` 元素會根據定義的條件，指定陳述式的執行時機。您可以建立使用[條件運算子](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 支援服務角色。