本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS CodeArtifact 的身分型政策範例
根據預設，使用者和角色沒有建立或修改 CodeArtifact 資源的許可。若要授予使用者對其所需資源執行動作的許可，IAM 管理員可以建立 IAM 政策。
如需了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱《*IAM 使用者指南*》中的[建立 IAM 政策 (主控台)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。
如需 CodeArtifact 定義的動作和資源類型的詳細資訊，包括每種資源類型的 ARNs 格式，請參閱*《服務授權參考*》中的[AWS CodeArtifact 的動作、資源和條件索引鍵](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awscodeartifact.html)。
**Topics**
+ [政策最佳實務](#security_iam_service-with-iam-policy-best-practices)
+ [使用 CodeArtifact 主控台](#security_iam_id-based-policy-examples-console)
+ [適用於 AWS CodeArtifact 的 AWS 受管 （預先定義） 政策](#managed-policies)
+ [允許使用者檢視自己的許可](#security_iam_id-based-policy-examples-view-own-permissions)
+ [允許使用者取得儲存庫和網域的相關資訊](#security_iam_id-based-policy-examples-repos-and-domains)
+ [允許使用者取得特定網域的相關資訊](#security_iam_id-based-policy-examples-specific-domains)
+ [允許使用者取得特定儲存庫的相關資訊](#security_iam_id-based-policy-examples-specific-repos)
+ [限制授權字符持續時間](#limit-token-duration)
## 政策最佳實務
身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除 CodeArtifact 資源。這些動作可能會讓您的 AWS 帳戶產生費用。當您建立或編輯身分型政策時，請遵循下列準則及建議事項：
+ **開始使用 AWS 受管政策並邁向最低權限許可** – 若要開始將許可授予您的使用者和工作負載，請使用將許可授予許多常見使用案例的 *AWS 受管政策*。它們可在您的 中使用 AWS 帳戶。我們建議您定義特定於使用案例 AWS 的客戶受管政策，以進一步減少許可。如需更多資訊，請參閱《*IAM 使用者指南*》中的 [AWS 受管政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)或[任務職能的AWS 受管政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)。
+ **套用最低權限許可** – 設定 IAM 政策的許可時，請僅授予執行任務所需的許可。為實現此目的，您可以定義在特定條件下可以對特定資源採取的動作，這也稱為*最低權限許可*。如需使用 IAM 套用許可的更多相關資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的政策和許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
+ **使用 IAM 政策中的條件進一步限制存取權** – 您可以將條件新增至政策，以限制動作和資源的存取。例如，您可以撰寫政策條件，指定必須使用 SSL 傳送所有請求。如果透過特定 例如 使用服務動作 AWS 服務，您也可以使用條件來授予其存取權 CloudFormation。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [IAM JSON 政策元素：條件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)。
+ **使用 IAM Access Analyzer 驗證 IAM 政策，確保許可安全且可正常運作** – IAM Access Analyzer 驗證新政策和現有政策，確保這些政策遵從 IAM 政策語言 (JSON) 和 IAM 最佳實務。IAM Access Analyzer 提供 100 多項政策檢查及切實可行的建議，可協助您撰寫安全且實用的政策。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[使用 IAM Access Analyzer 驗證政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。
+ **需要多重要素驗證 (MFA)** – 如果您的案例需要 IAM 使用者或 中的根使用者 AWS 帳戶，請開啟 MFA 以提高安全性。如需在呼叫 API 操作時請求 MFA，請將 MFA 條件新增至您的政策。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[透過 MFA 的安全 API 存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)。
如需 IAM 中最佳實務的相關資訊，請參閱《*IAM 使用者指南*》中的 [IAM 安全最佳實務](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)。
## 使用 CodeArtifact 主控台
若要存取 AWS CodeArtifact 主控台，您必須擁有一組最低許可。這些許可必須允許您列出和檢視 中 CodeArtifact 資源的詳細資訊 AWS 帳戶。如果您建立比最基本必要許可更嚴格的身分型政策，則對於具有該政策的實體 (使用者或角色) 而言，主控台就無法如預期運作。
對於僅呼叫 AWS CLI 或 AWS API 的使用者，您不需要允許最低主控台許可。反之，只需允許存取符合他們嘗試執行之 API 操作的動作就可以了。
為了確保使用者和角色仍然可以使用 CodeArtifact 主控台，請將 `AWSCodeArtifactAdminAccess`或 `AWSCodeArtifactReadOnlyAccess` AWS 受管政策連接到實體。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[新增許可到使用者](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)。
## 適用於 AWS CodeArtifact 的 AWS 受管 （預先定義） 政策
AWS 透過提供由 建立和管理的獨立 IAM 政策，解決許多常見的使用案例 AWS。這些 AWS 受管政策會授予常見使用案例的必要許可，因此您可以避免調查需要哪些許可。如需詳細資訊，請參閱《[IAM 使用者指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)》中的 *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 身分驗證和字符](tokens-authentication.md)。
擷取字符時，使用者可以設定字符的生命週期。授權字符生命週期的有效值為 `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"
}
}
}
]
}
```
------