AWS CodePipeline 如何使用 IAM - AWS CodePipeline

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

AWS CodePipeline 如何使用 IAM

使用 IAM 管理對 的存取之前 CodePipeline,您應該了解哪些IAM功能可與 搭配使用 CodePipeline。若要取得如何使用 CodePipeline 和其他 AWS 服務 的高階檢視IAM,請參閱 IAM 使用者指南 中的 AWS 服務 與 搭配使用IAM

CodePipeline 身分型政策

透過身分IAM型政策,您可以指定允許或拒絕的動作和資源,以及允許或拒絕動作的條件。 CodePipeline 支援特定動作、資源和條件索引鍵。若要了解您在JSON政策中使用的所有元素,請參閱 IAM 使用者指南 中的IAMJSON政策元素參考

動作

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

JSON 政策的 Action元素說明您可以用來允許或拒絕政策中存取的動作。政策動作通常具有與相關聯 AWS API操作相同的名稱。有一些例外狀況,例如沒有相符API操作的僅限許可動作。也有一些作業需要政策中的多個動作。這些額外的動作稱為相依動作

政策會使用動作來授予執行相關聯動作的許可。

中的政策動作在動作之前 CodePipeline 使用下列字首:codepipeline:

例如,若要准許某人檢視帳戶中現有的管道,您需要在其政策中加入 codepipeline:GetPipeline 動作。政策陳述式必須包含 ActionNotAction element。 CodePipeline 定義自己的動作集,描述您可以使用此服務執行的任務。

若要在單一陳述式中指定多個動作,請用逗號分隔,如下所示:

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

您也可以使用萬用字元 (*) 來指定多個動作。例如,若要指定開頭是 Get 文字的所有動作,請包含以下動作:

"Action": "codepipeline:Get*"

如需 CodePipeline 動作清單,請參閱 IAM 使用者指南 中的 定義的動作 AWS CodePipeline

資源

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

Resource JSON 政策元素會指定動作套用的物件。陳述式必須包含 ResourceNotResource 元素。最佳實務是使用其 Amazon Resource Name (ARN) 指定資源。您可以針對支援特定資源類型的動作 (稱為資源層級許可) 來這麼做。

對於不支援資源層級許可的動作 (例如列出操作),請使用萬用字元 (*) 來表示陳述式適用於所有資源。

"Resource": "*"

CodePipeline 資源和操作

在 中 CodePipeline,主要資源是管道。在政策中,您可以使用 Amazon Resource Name (ARN) 來識別政策適用的資源。 CodePipeline 支援可與主要資源搭配使用的其他資源,例如階段、動作和自訂動作。這些資源稱為「子資源」。這些資源和子資源具有與其相關聯的唯一 Amazon Resource Name (ARNs)。如需 的詳細資訊ARNs,請參閱 中的 Amazon Resource Names (ARN) 和 AWS 服務 命名空間Amazon Web Services 一般參考。若要取得與管道ARN相關聯的管道,您可以在主控台的設定ARN下找到管道。如需詳細資訊,請參閱檢視管道ARN和服務角色 ARN(主控台)

資源類型 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:動作類型:owner/category/provider/version

所有 CodePipeline 資源

arn:aws:codepipeline:*

指定區域中指定帳戶擁有的所有 CodePipeline 資源

arn:aws:codepipeline:region:account:*

注意

中的大多數服務將冒號 (:) 或正斜線 (/) AWS 視為 中的相同字元ARNs。不過, CodePipeline 會在事件模式和規則中使用完全相符的項目。建立事件模式時,請務必使用正確的ARN字元,以便它們與您要比對的管道中的ARN語法相符。

在 中 CodePipeline,有 API呼叫支援資源層級許可。資源層級許可指示API呼叫是否可以指定資源 ARN,或API呼叫是否只能指定使用萬用字元的所有資源。CodePipeline 許可參考 如需資源層級許可的詳細說明,以及支援資源層級許可的 CodePipeline API通話清單,請參閱 。

例如,您可以指示特定管道 (myPipeline),ARN如下所示:

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

您也可以透過使用 (*) 萬用字元指定所有屬於特定帳戶的管道,如下所示:

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

若要指定所有資源,或如果特定API動作不支援 ARNs,請使用 Resource 元素中的 (*) 萬用字元,如下所示:

"Resource": "*"
注意

建立IAM政策時,請遵循授予最低權限的標準安全建議,也就是僅授予執行任務所需的許可。如果API呼叫支援 ARNs,則支援資源層級許可,且您不需要使用 (*) 萬用字元。

有些 CodePipeline API呼叫接受多個資源 (例如 GetPipeline)。若要在單一陳述式中指定多個資源,ARNs請以逗號分隔它們,如下所示:

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

CodePipeline 提供一組操作來使用 CodePipeline 資源。如需可用操作的清單,請參閱 CodePipeline 許可參考

條件索引鍵

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

Condition 元素 (或 Condition 區塊) 可讓您指定使陳述式生效的條件。Condition 元素是選用項目。您可以建立使用條件運算子的條件運算式 (例如等於或小於),來比對政策中的條件和請求中的值。

若您在陳述式中指定多個 Condition 元素,或是在單一 Condition 元素中指定多個索引鍵, AWS 會使用邏輯 AND 操作評估他們。如果您為單一條件索引鍵指定多個值, 會使用邏輯OR操作 AWS 評估條件。必須符合所有條件,才會授與陳述式的許可。

您也可以在指定條件時使用預留位置變數。例如,只有在使用者使用其IAM使用者名稱加上標籤時,您才能授予IAM使用者存取資源的許可。如需詳細資訊,請參閱 IAM 使用者指南 中的IAM政策元素:變數和標籤

AWS 支援全域條件索引鍵和服務特定條件索引鍵。若要查看所有 AWS 全域條件索引鍵,請參閱 IAM 使用者指南 中的AWS 全域條件內容索引鍵

CodePipeline 會定義自己的一組條件金鑰,也支援使用某些全域條件金鑰。若要查看所有 AWS 全域條件索引鍵,請參閱 IAM 使用者指南 中的AWS 全域條件內容索引鍵

所有 Amazon EC2動作都支援 aws:RequestedRegionec2:Region 條件金鑰。如需詳細資訊,請參閱範例:將存取限制在特定區域

若要查看 CodePipeline 條件金鑰清單,請參閱 IAM 使用者指南 中的 的條件金鑰 AWS CodePipeline。若要了解您可以使用條件金鑰的動作和資源,請參閱 定義的動作 AWS CodePipeline

範例

若要檢視 CodePipeline 身分型政策的範例,請參閱 AWS CodePipeline 身分型政策範例

CodePipeline 資源型政策

CodePipeline 不支援資源型政策。不過, CodePipeline 會提供 相關 S3 服務的資源型政策範例。

範例

若要檢視 CodePipeline 資源型政策的範例,請參閱 AWS CodePipeline 資源型政策範例

以 CodePipeline 標籤為基礎的授權

您可以將標籤連接至 CodePipeline 資源,或將請求中的標籤傳遞至 CodePipeline。如需根據標籤控制存取,請使用 codepipeline:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 條件索引鍵,在政策的條件元素中,提供標籤資訊。如需標記 CodePipeline 資源的詳細資訊,請參閱 標記 資源

若要檢視身分型政策範例,以根據該資源上的標籤來限制存取資源,請參閱使用標籤控制對資源的 CodePipeline存取

CodePipeline IAM 角色

IAM 角色是您 AWS 帳戶中具有特定許可的實體。

搭配 使用臨時憑證 CodePipeline

您可以使用臨時憑證來登入聯合、擔任IAM角色或擔任跨帳戶角色。您可以透過呼叫 AWS STS API AssumeRole或 等操作來取得臨時安全憑證GetFederationToken

CodePipeline 支援使用臨時憑證。

服務角色

CodePipeline 允許服務代表您擔任服務角色。此角色可讓服務存取其他服務中的資源,以代表您完成動作。服務角色會顯示在您的帳戶中IAM,並由 帳戶擁有。這表示IAM管理員可以變更此角色的許可。不過,這樣可能會破壞此服務的功能。

CodePipeline 支援服務角色。