的身分型政策範例 AWS CodeArtifact - 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 帳戶產生費用。當您建立或編輯身分型政策時,請遵循下列準則及建議事項:

  • 開始使用 AWS 受管政策並邁向最低權限許可 – 若要開始將許可授予您的使用者和工作負載,請使用 AWS 受管政策,將許可授予許多常見使用案例。它們可在您的 中使用 AWS 帳戶。建議您定義特定於使用案例 AWS 的客戶受管政策,以進一步減少許可。如需詳細資訊,請參閱 IAM 使用者指南 中的 AWS 受管政策AWS 受管政策。

  • 套用最低權限許可 – 當您使用IAM政策設定許可時, 只會授予執行任務所需的許可。為實現此目的,您可以定義在特定條件下可以對特定資源採取的動作,這也稱為最低權限許可。如需使用 IAM 套用許可的詳細資訊,請參閱 IAM 使用者指南 中的政策和許可IAM

  • 使用IAM政策中的條件來進一步限制存取:您可以將條件新增至政策,以限制對動作和資源的存取。例如,您可以撰寫政策條件來指定所有請求都必須使用 傳送SSL。如果透過特定 使用服務動作,例如 AWS 服務,您也可以使用 條件來授予其存取權 AWS CloudFormation。如需詳細資訊,請參閱 IAM 使用者指南 中的IAMJSON政策元素:條件

  • 使用 IAM Access Analyzer 驗證您的IAM政策以確保安全且功能許可 – IAM Access Analyzer 會驗證新的和現有的政策,讓政策遵循IAM政策語言 (JSON) 和IAM最佳實務。IAM Access Analyzer 提供超過 100 個政策檢查和可操作的建議,協助您撰寫安全且實用的政策。如需詳細資訊,請參閱 IAM 使用者指南 中的使用 IAM Access Analyzer 驗證政策

  • 需要多因素身分驗證 (MFA) – 如果您有需要IAM使用者或 根使用者的案例 AWS 帳戶,請開啟 MFA 以獲得額外的安全性。若要在呼叫API操作MFA時要求 ,請將MFA條件新增至您的政策。如需詳細資訊,請參閱 IAM 使用者指南 中的使用 安全API存取MFA

如需 中最佳實務的詳細資訊IAM,請參閱 IAM 使用者指南 中的安全最佳實務IAM

使用 CodeArtifact 主控台

若要存取 AWS CodeArtifact 主控台,您必須具有一組最低許可。這些許可必須允許您列出和檢視 中 CodeArtifact 資源的詳細資訊 AWS 帳戶。如果您建立比最基本必要許可更嚴格的身分型政策,則對於具有該政策的實體 (使用者或角色) 而言,主控台就無法如預期運作。

對於僅對 AWS CLI 或 進行呼叫的使用者,您不需要允許最低主控台許可 AWS API。相反地,僅允許存取與其嘗試執行API的操作相符的動作。

為了確保使用者和角色仍然可以使用 CodeArtifact 主控台,也請將 AWSCodeArtifactAdminAccessAWSCodeArtifactReadOnlyAccess 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

您也可以建立自己的自訂IAM政策,以允許動作和資源的 CodeArtifact許可。您可以將這些自訂政策連接至需要這些許可IAM的使用者或群組。

允許使用者檢視自己的許可

此範例示範如何建立政策,允許使用者IAM檢視連接至其使用者身分的內嵌和受管政策。此政策包含在主控台上完成此動作或使用 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:ReadFromRepository許可,允許主體從 CodeArtifact 儲存庫擷取套件。它不允許建立新的網域或儲存庫,也不允許發佈新的套件。

呼叫 需要 codeartifact:GetAuthorizationTokenGetAuthorizationToken sts:GetServiceBearerToken許可API。

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

允許使用者取得特定網域的相關資訊

以下顯示許可政策的範例,允許使用者只列出以名稱 開頭的任何網域的 us-east-2 區域中123456789012的網域my

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "codeartifact:ListDomains", "Resource": "arn:aws:codeartifact:us-east-2:123456789012:domain/my*" } ] }

允許使用者取得特定儲存庫的相關資訊

以下顯示許可政策的範例,允許使用者取得以 結尾的儲存庫相關資訊test,包括其中套件的相關資訊。使用者將無法發佈、建立或刪除資源。

呼叫 需要 codeartifact:GetAuthorizationTokenGetAuthorizationToken sts:GetServiceBearerToken許可API。

{ "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 小時 (43200 秒)

使用此政策,使用者只能建立生命週期為 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" } } } ] }