AWS CodeArtifact 的身分型政策範例 - CodeArtifact
政策最佳實務使用主控台AWS CodeArtifact 的 AWS 受管 （預先定義） 政策允許使用者檢視自己的許可允許使用者取得儲存庫和網域的相關資訊允許使用者取得特定網域的相關資訊允許使用者取得特定儲存庫的相關資訊限制授權字符持續時間

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

AWS CodeArtifact 的身分型政策範例

根據預設，使用者和角色沒有建立或修改 CodeArtifact 資源的許可。若要授予使用者對其所需資源執行動作的許可，IAM 管理員可以建立 IAM 政策。

如需了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱 IAM 使用者指南中的建立 IAM 政策 (主控台)。

如需 CodeArtifact 定義的動作和資源類型的詳細資訊，包括每種資源類型的 ARNs 格式，請參閱《服務授權參考》中的AWS CodeArtifact 的動作、資源和條件索引鍵。

政策最佳實務

身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除 CodeArtifact 資源。這些動作可能會讓您的 AWS 帳戶產生費用。當您建立或編輯身分型政策時，請遵循下列準則及建議事項：

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

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

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

  • 使用 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 使用者指南中的透過 MFA 的安全 API 存取。

如需 IAM 中最佳實務的相關資訊，請參閱 IAM 使用者指南中的 IAM 安全最佳實務。

使用 CodeArtifact 主控台

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

對於僅呼叫 AWS CLI 或 AWS API 的使用者，您不需要允許最低主控台許可。反之，只需允許存取符合他們嘗試執行之 API 操作的動作就可以了。

為了確保使用者和角色仍然可以使用 CodeArtifact 主控台，請將 AWSCodeArtifactAdminAccess或 AWSCodeArtifactReadOnlyAccess AWS 受管政策連接到實體。如需詳細資訊，請參閱 IAM 使用者指南中的新增許可到使用者。

AWS CodeArtifact 的 AWS 受管 （預先定義） 政策

AWS 透過提供由 建立和管理的獨立 IAM 政策，解決許多常見的使用案例 AWS。這些 AWS 受管政策會授予常見使用案例的必要許可，因此您可以避免調查需要哪些許可。如需詳細資訊，請參閱《IAM 使用者指南》中的 AWS Managed Policies (AWS 受管政策)。

下列 AWS 受管政策是 AWS CodeArtifact 特有的，您可以連接到您帳戶中的使用者。

  • AWSCodeArtifactAdminAccess – 提供 CodeArtifact 的完整存取權，包括管理 CodeArtifact 網域的許可。

    JSON
    {
   "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 的唯讀存取權。

    JSON
    {
   "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 儲存庫擷取套件。它不允許建立新的網域或儲存庫，也不允許發佈新的套件。

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

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

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

以下顯示許可政策的範例，允許使用者僅列出名稱為 123456789012的任何網域的 us-east-2 區域中的網域my。

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

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

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

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

JSON
{
   "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 小時的授權字符。

JSON
{
    "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。

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