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

# AWS CodeDeploy 身分型政策範例
<a name="security_iam_id-based-policy-examples"></a>

根據預設，使用者沒有建立或修改 CodeDeploy 資源的許可。他們也無法使用 AWS 管理主控台 AWS CLI或 AWS API 執行任務。您必須建立 IAM 政策，授予 IAM 角色對所需指定資源執行 API 操作的許可。然後，您必須將這些 IAM 角色連接到需要這些許可的使用者或群組。

若要了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱《IAM 使用者指南》中的[在 JSON 標籤上建立政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)。

在 CodeDeploy 中，身分型政策用於管理與部署程序相關的各種資源的許可。您可以控制下列資源類型的存取：
+ 應用程式與應用程式修訂。
+ 部署。
+ 部署組態。
+ 執行個體與內部部署執行個體。

資源政策控制的功能會因資源類型而有所不同，如下表所述：


****  

|  資源類型  |  功能  | 
| --- | --- | 
|  全部  |  檢視及列出資源的詳細資訊  | 
|  應用程式 部署組態 部署群組  |  建立 資源 刪除資源  | 
|  部署  |  建立部署 停止部署  | 
|  應用程式修訂  |  註冊應用程式修訂  | 
|  應用程式 部署群組  |  更新資源  | 
|  現場部署執行個體  |  為執行個體新增標籤 從執行個體移除標籤 註冊執行個體 取消註冊執行個體  | 

以下範例顯示的許可政策，允許使用者刪除 **us-west-2** 區域內與名為 **WordPress\$1App** 應用程式建立關聯，且名為 **WordPress\$1DepGroup** 的部署群組。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:DeleteDeploymentGroup"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:111122223333:deploymentgroup:WordPress_App/WordPress_DepGroup"
      ]
    }
  ]
}
```

------

**Topics**
+ [客戶受管政策範例](#customer-managed-policies)
+ [政策最佳實務](#security_iam_service-with-iam-policy-best-practices)
+ [使用 CodeDeploy 主控台](#security_iam_id-based-policy-examples-console)
+ [允許使用者檢視他們自己的許可](#security_iam_id-based-policy-examples-view-own-permissions)

## 客戶受管政策範例
<a name="customer-managed-policies"></a>

在本節中，您可以找到授予各種 CodeDeploy 動作許可的範例政策。當您使用 CodeDeploy API、 AWS SDKs 或 時，這些政策即可運作 AWS CLI。您必須為在主控台中執行的動作授與其他許可。若要進一步了解如何授與主控台許可，請參閱 [使用 CodeDeploy 主控台](#security_iam_id-based-policy-examples-console)。



**注意**  
所有範例皆使用美國西部 (奧勒岡) 區域 (`us-west-2`) 及虛構帳戶 ID。

 **範例**
+ [範例 1：允許在單一區域中執行 CodeDeploy 操作的許可](#identity-based-policies-example-1)
+ [範例 2：允許為單一應用程式註冊修訂的許可](#identity-based-policies-example-2)
+ [範例 3：允許為單一部署群組建立部署的許可](#identity-based-policies-example-3)

### 範例 1：允許在單一區域中執行 CodeDeploy 操作的許可
<a name="identity-based-policies-example-1"></a>

下列範例僅授予在 **us-west-2**區域中執行 CodeDeploy 操作的許可：

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:*"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:111122223333:*"
      ]
    }
  ]
}
```

------

### 範例 2：允許為單一應用程式註冊修訂的許可
<a name="identity-based-policies-example-2"></a>

以下範例會授予許可，註冊 **us-west-2** 區域內所有開頭為 **Test** 應用程式的應用程式修訂：

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:RegisterApplicationRevision"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:111122223333:application:Test*"
      ]
    }
  ]
}
```

------

### 範例 3：允許為單一部署群組建立部署的許可
<a name="identity-based-policies-example-3"></a>

下列範例允許 為名為 之應用程式**WordPress\$1DepGroup**相關聯的部署群組**WordPress\$1App**、名為 的自訂部署組態**ThreeQuartersHealthy**，以及與名為 之應用程式相關聯的任何應用程式修訂版建立部署的許可**WordPress\$1App**。所有這些資源都位於 **us-west-2** 區域。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:CreateDeployment"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:111122223333:deploymentgroup:WordPress_App/WordPress_DepGroup"
      ]
    },
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:GetDeploymentConfig"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:111122223333:deploymentconfig:ThreeQuartersHealthy"
      ]
    },
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:GetApplicationRevision"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:111122223333:application:WordPress_App"
      ]
    }
  ]
}
```

------

## 政策最佳實務
<a name="security_iam_service-with-iam-policy-best-practices"></a>

身分型政策會判斷您帳戶中的某人是否可以建立、存取或刪除 CodeDeploy 資源。這些動作可能會讓您的 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)。

## 使用 CodeDeploy 主控台
<a name="security_iam_id-based-policy-examples-console"></a>

如果您使用 CodeDeploy 主控台，您必須擁有一組最低許可，允許您描述 AWS 帳戶的其他 AWS 資源。若要在 CodeDeploy 主控台中使用 CodeDeploy，您必須擁有下列服務的許可：
+ Amazon EC2 Auto Scaling
+ AWS CodeDeploy
+ Amazon Elastic Compute Cloud
+ Elastic Load Balancing
+ AWS Identity and Access Management
+ Amazon Simple Storage Service
+ Amazon Simple Notification Service
+ Amazon CloudWatch

如果您建立比最低必要許可更嚴格的 IAM 政策，對於具有該 IAM 政策角色的使用者，主控台將無法如預期運作。為了確保這些使用者仍然可以使用 CodeDeploy 主控台，也請將 `AWSCodeDeployReadOnlyAccess`受管政策連接至指派給使用者的角色，如中所述[AWS CodeDeploy 的受管 （預先定義） 政策](managed-policies.md)。

對於僅呼叫 AWS CLI 或 CodeDeploy API 的使用者，您不需要允許最低主控台許可。

## 允許使用者檢視他們自己的許可
<a name="security_iam_id-based-policy-examples-view-own-permissions"></a>

此範例會示範如何建立政策，允許 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": "*"
        }
    ]
}
```