# 适用于 Amazon CloudFront 的基于身份的策略示例
<a name="security_iam_id-based-policy-examples"></a>

默认情况下，用户和角色没有创建或修改 CloudFront 资源的权限。要授予用户对所需资源执行操作的权限，IAM 管理员可以创建 IAM 策略。

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》**中的[创建 IAM 策略（控制台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。

有关 CloudFront 定义的操作和资源类型的详细信息，包括每种资源类型的 ARN 格式，请参阅《服务授权参考》**中的 [Amazon CloudFront 的操作、资源和条件键](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazoncloudfront.html)。

**Topics**
+ [策略最佳实践](#security_iam_service-with-iam-policy-best-practices)
+ [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions)
+ [以编程方式访问 CloudFront 的权限](#security_iam_id-based-policy-examples-programmatic-access-all)
+ [使用 CloudFront 控制台所需的权限](#security_iam_id-based-policy-examples-console-required-permissions)
+ [客户管理的策略示例](#security_iam_id-based-policy-examples-sdk-cli)

## 策略最佳实践
<a name="security_iam_service-with-iam-policy-best-practices"></a>

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 CloudFront 资源。这些操作可能会使 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）**：如果您所处的场景要求您的 AWS 账户 中有 IAM 用户或根用户，请启用 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)。

## 允许用户查看他们自己的权限
<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": "*"
        }
    ]
}
```

## 以编程方式访问 CloudFront 的权限
<a name="security_iam_id-based-policy-examples-programmatic-access-all"></a>

下面显示了一个权限策略。`Sid` 或语句 ID 是可选的。

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

****  

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement": [
      {
         "Sid": "AllowAllCloudFrontPermissions",
         "Effect": "Allow",
         "Action": ["cloudfront:*"],
         "Resource": "*"
      }
   ]
}
```

------

该策略授予执行所有 CloudFront 操作的权限，这足以通过编程方式访问 CloudFront。如果您使用控制台访问 CloudFront，请参阅[使用 CloudFront 控制台所需的权限](#security_iam_id-based-policy-examples-console-required-permissions)。

有关您为授予或拒绝使用每项操作的权限而指定的操作和 ARN 的列表，请参阅《服务授权参考》**中的 [Amazon CloudFront 的操作、资源和条件键](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazoncloudfront.html)。

## 使用 CloudFront 控制台所需的权限
<a name="security_iam_id-based-policy-examples-console-required-permissions"></a>

要授予对 CloudFront 控制台的完全访问权，您可以在以下权限策略中授予权限：

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

****  

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "acm:ListCertificates", 
            "cloudfront:*", 
            "cloudwatch:DescribeAlarms",
            "cloudwatch:PutMetricAlarm",
            "cloudwatch:GetMetricStatistics",
            "elasticloadbalancing:DescribeLoadBalancers",
            "iam:ListServerCertificates",
            "sns:ListSubscriptionsByTopic",
            "sns:ListTopics",
            "waf:GetWebACL",
            "waf:ListWebACLs"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:ListAllMyBuckets",
            "s3:PutBucketPolicy"
         ],
         "Resource":"arn:aws:s3:::*"
      }
   ]
}
```

------

下面是需要权限的原因：

**`acm:ListCertificates`**  
如果您使用 CloudFront 控制台创建和更新分配，并且希望配置 CloudFront 以要求在查看器与 CloudFront 之间或 CloudFront 与源之间使用 HTTPS，则可查看 ACM 证书的列表。  
如果您未使用 CloudFront 控制台，则不需要此权限。

**`cloudfront:*`**  
允许您执行所有 CloudFront 操作。

**`cloudwatch:DescribeAlarms` 和 `cloudwatch:PutMetricAlarm`**  
允许您在 CloudFront 控制台中创建和查看 CloudWatch 警报。另请参阅 `sns:ListSubscriptionsByTopic` 和 `sns:ListTopics`。  
如果您未使用 CloudFront 控制台，则不需要这些权限。

**`cloudwatch:GetMetricStatistics`**  
允许 CloudFront 在 CloudFront 控制台中呈现 CloudWatch 指标。  
如果您未使用 CloudFront 控制台，则不需要此权限。

**`elasticloadbalancing:DescribeLoadBalancers`**  
在创建和更新分配时，您可以查看可用源列表中的 Elastic Load Balancing 负载均衡器的列表。  
如果您未使用 CloudFront 控制台，则不需要此权限。

**`iam:ListServerCertificates`**  
如果您使用 CloudFront 控制台创建和更新分配，并且希望配置 CloudFront 以要求在查看器与 CloudFront 之间或 CloudFront 与源之间使用 HTTPS，则可查看 IAM 证书存储中的证书列表。  
如果您未使用 CloudFront 控制台，则不需要此权限。

**`s3:ListAllMyBuckets`**  
当您创建和更新分配时，您可以执行以下操作：  
+ 在可用源列表中查看 S3 存储桶的列表
+ 查看可将访问日志保存到的 S3 存储桶的列表
如果您未使用 CloudFront 控制台，则不需要此权限。

**`S3:PutBucketPolicy`**  
当您创建或更新将限制对 S3 存储桶的访问的分配时，用户可以更新存储桶策略以授予对 CloudFront 源访问身份的访问权。有关更多信息，请参阅 [使用源访问身份（旧版，不推荐）](private-content-restricting-access-to-s3.md#private-content-restricting-access-to-s3-oai)。  
如果您未使用 CloudFront 控制台，则不需要此权限。

**`sns:ListSubscriptionsByTopic` 和 `sns:ListTopics`**  
当您在 CloudFront 控制台中创建 CloudWatch 警报时，可以为通知选择 SNS 主题。  
如果您未使用 CloudFront 控制台，则不需要这些权限。

**`waf:GetWebACL` 和 `waf:ListWebACLs`**  
允许您在 CloudFront 控制台中查看 AWS WAF Web ACL 的列表。  
如果您未使用 CloudFront 控制台，则不需要这些权限。

### CloudFront 控制台中需要权限的操作
<a name="console-only-actions"></a>

您可以在 [CloudFront 安全防御节省套餐](https://console.aws.amazon.com//cloudfront/v3/home#/savings-bundle/overview)页面上执行以下 CloudFront 操作。以下 API 操作不应由您的代码调用，并且不包含在 AWS CLI 和 AWS SDK 中。


****  

| Action | 说明 | 
| --- | --- | 
|  `CreateSavingsPlan`  |  授予权限以创建新的节省计划。  | 
|   `GetSavingsPlan`   |  授予权限以获取节省计划。  | 
|  `ListRateCards`  |  授予权限以列出账户的 CloudFront 速率卡。  | 
|   `ListSavingsPlans`   |  授予权限以列出账户中的节省计划。  | 
|   `ListUsages`   |  授予权限以列出 CloudFront 使用情况。  | 
|   `UpdateSavingsPlan`   |  授予权限以更新节省计划。  | 

**备注**  
有关 CloudFront 节省计划的更多信息，请参阅 [Amazon CloudFront 常见问题解答](https://aws.amazon.com/cloudfront/faqs/)中的“CloudFront 安全防御节省套餐”部分。
如果您为 CloudFront 创建了节省计划，但想稍后将其删除，请联系 [AWS 支持](https://console.aws.amazon.com/support/home#/case/create?issueType=customer-service)。

## 客户管理的策略示例
<a name="security_iam_id-based-policy-examples-sdk-cli"></a>

您可以创建自己的自定义 IAM 策略，以授予执行 CloudFront API 操作的相关权限。您可以将这些自定义策略附加到需要指定权限的 IAM 用户或组。当您使用 CloudFront API、AWS 开发工具包或 AWS CLI 时，可以使用这些策略。以下示例显示了几个常见使用案例的权限。有关向用户授予对 CloudFront 的完全访问权限的策略，请参阅[使用 CloudFront 控制台所需的权限](#security_iam_id-based-policy-examples-console-required-permissions)。

**Topics**
+ [示例 1：允许对所有分配进行读访问](#security_iam_id-based-policy-examples-allow-read-all-distributions)
+ [示例 2：允许创建、更新和删除分配](#security_iam_id-based-policy-examples-allow-create-update-delete-distributions)
+ [示例 3：允许创建和列出失效](#security_iam_id-based-policy-examples-allow-create-list-invalidations)
+ [示例 4：允许创建分配](#create-distribution-iam-policy)

### 示例 1：允许对所有分配进行读访问
<a name="security_iam_id-based-policy-examples-allow-read-all-distributions"></a>

以下权限策略向用户授予在 CloudFront 控制台中查看所有分配的权限：

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

****  

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "acm:ListCertificates", 
            "cloudfront:GetDistribution",
            "cloudfront:GetDistributionConfig",
            "cloudfront:ListDistributions",
            "cloudfront:ListCloudFrontOriginAccessIdentities",
            "elasticloadbalancing:DescribeLoadBalancers",
            "iam:ListServerCertificates",
            "sns:ListSubscriptionsByTopic",
            "sns:ListTopics",
            "waf:GetWebACL",
            "waf:ListWebACLs"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:ListAllMyBuckets"
         ],
         "Resource":"arn:aws:s3:::*"
      }
   ]
}
```

------

### 示例 2：允许创建、更新和删除分配
<a name="security_iam_id-based-policy-examples-allow-create-update-delete-distributions"></a>

以下权限策略允许用户使用 CloudFront 控制台来创建、更新和删除分配：

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

****  

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "acm:ListCertificates", 
            "cloudfront:CreateDistribution",
            "cloudfront:DeleteDistribution",
            "cloudfront:GetDistribution",
            "cloudfront:GetDistributionConfig",
            "cloudfront:ListDistributions",
            "cloudfront:UpdateDistribution",
            "cloudfront:ListCloudFrontOriginAccessIdentities",
            "elasticloadbalancing:DescribeLoadBalancers",
            "iam:ListServerCertificates",
            "sns:ListSubscriptionsByTopic",
            "sns:ListTopics",
            "waf:GetWebACL",
            "waf:ListWebACLs"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:ListAllMyBuckets",
            "s3:PutBucketPolicy"
         ],
         "Resource":"arn:aws:s3:::*"
      }
   ]
}
```

------

`cloudfront:ListCloudFrontOriginAccessIdentities` 权限允许用户自动向现有的源访问身份授予对 Amazon S3 存储桶中的对象的访问权。如果您还希望用户能够创建源访问身份，则还需要授予 `cloudfront:CreateCloudFrontOriginAccessIdentity` 权限。

### 示例 3：允许创建和列出失效
<a name="security_iam_id-based-policy-examples-allow-create-list-invalidations"></a>

以下权限策略允许用户创建和列出失效。它包括对 CloudFront 分配的读访问权，因为您通过先显示分配的设置来创建和查看失效：

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

****  

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "acm:ListCertificates", 
            "cloudfront:GetDistribution",
            "cloudfront:GetStreamingDistribution",
            "cloudfront:GetDistributionConfig",
            "cloudfront:ListDistributions",
            "cloudfront:ListCloudFrontOriginAccessIdentities",
            "cloudfront:CreateInvalidation",
            "cloudfront:GetInvalidation",
            "cloudfront:ListInvalidations",
            "elasticloadbalancing:DescribeLoadBalancers",
            "iam:ListServerCertificates",
            "sns:ListSubscriptionsByTopic",
            "sns:ListTopics",
            "waf:GetWebACL",
            "waf:ListWebACLs"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:ListAllMyBuckets"
         ],
         "Resource":"arn:aws:s3:::*"
      }
   ]
}
```

------

### 示例 4：允许创建分配
<a name="create-distribution-iam-policy"></a>

以下权限策略向用户授予在 CloudFront 控制台中创建和列出分配的权限：要执行 `CreateDistribution` 操作，请为 `Resource` 指定通配符（\$1），而不是为分配 ARN（`arn:aws:cloudfront::123456789012:distribution/*`）指定通配符。有关 `Resource` 元素的更多信息，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素：资源](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html)。

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "cloudfront:CreateDistribution",
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": "cloudfront:ListDistributions",
            "Resource": "*"
        }
    ]
}
```

------