本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Direct Connect 基于身份的策略示例
默认情况下，用户和角色没有创建或修改 Direct Connect 资源的权限。要授予用户对所需资源执行操作的权限，IAM 管理员可以创建 IAM 策略。
要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》**中的[创建 IAM 策略（控制台）](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_create-console.html)。
有关 Direct Connect 定义的操作和资源类型（包括每种资源类型的格式）的详细信息，请参阅《*服务授权参考*》中的 Di [rect Connect 的操作、资源和条件密钥](https://docs.amazonaws.cn/IAM/latest/UserGuide/list_awsdirectconnect.html)。 ARNs
**Topics**
+ [策略最佳实践](#security_iam_service-with-iam-policy-best-practices)
+ [操作、资源和条件](#security_iam_service-dx-id-based-policies)
+ [使用控制台](#security_iam_id-based-policy-examples-console)
+ [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions)
+ [只读访问权限 Amazon Direct Connect](#security_iam_id-based-policy-examples-read-access)
+ [完全访问权限 Amazon Direct Connect](#security_iam_id-based-policy-examples-full-access)
+ [基于标签的条件键](security_iam_resource-based-policy-examples.md)
## 策略最佳实践
基于身份的策略决定某人是否可以在您的账户中创建、访问或删除 Direct Connect 资源。这些操作可能会使 Amazon Web Services 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：
+ **开始使用 Amazon 托管策略并转向最低权限权限** — 要开始向用户和工作负载授予权限，请使用为许多常见用例授予权限的*Amazon 托管策略*。它们在你的版本中可用 Amazon Web Services 账户。我们建议您通过定义针对您的用例的 Amazon 客户托管策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》**中的 [Amazon 托管策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)或[工作职能的Amazon 托管策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_job-functions.html)。
+ **应用最低权限**：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为*最低权限许可*。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的策略和权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies.html)。
+ **使用 IAM 策略中的条件进一步限制访问权限**：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定的方式使用的，则也可以使用条件来授予对服务操作的访问权限 Amazon Web Services 服务，例如 Amazon CloudFormation。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素：条件](https://docs.amazonaws.cn/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.amazonaws.cn/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。
+ **需要多重身份验证 (MFA**)-如果 Amazon Web Services 账户您的场景需要 IAM 用户或根用户，请启用 MFA 以提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》**中的[使用 MFA 保护 API 访问](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)。
有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的安全最佳实践](https://docs.amazonaws.cn/IAM/latest/UserGuide/best-practices.html)。
## Direct Connect 的操作、资源和条件
通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。Direct Connect 支持特定的操作、资源和条件键。要了解在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》** 中的 [IAM JSON 策略元素参考](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements.html)。
### 操作
管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。
JSON 策略的 `Action` 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。
Direct Connect 的策略操作在操作前使用以下前缀：`directconnect:`。例如，要授予某人使用 Amazon EC2 `DescribeVpnGateways` API 操作运行 Amazon EC2 实例的权限，您应将 `ec2:DescribeVpnGateways` 操作纳入其策略。策略语句必须包含 `Action` 或 `NotAction` 元素。Direct Connect 定义了一组自己的操作，来描述您可以使用该服务执行的任务。
以下示例策略授予对的读取权限 Amazon Direct Connect。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"directconnect:Describe*",
"ec2:DescribeVpnGateways"
],
"Resource": "*"
}
]
}
```
------
以下示例策略授予对的完全访问权限 Amazon Direct Connect。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"directconnect:*",
"ec2:DescribeVpnGateways"
],
"Resource": "*"
}
]
}
```
------
要查看 Direct Connect 操作列表，请参阅《IAM 用户指南》**中的 [Direct Connect 定义的操作](https://docs.amazonaws.cn/IAM/latest/UserGuide/list_awsdirectconnect.html#awsdirectconnect-actions-as-permissions)。
### 资源
管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。
`Resource` JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 [Amazon 资源名称（ARN）](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference-arns.html)指定资源。对于不支持资源级权限的操作，请使用通配符 (\$1) 指示语句应用于所有资源。
```
"Resource": "*"
```
Direct Connect 使用以下内容 ARNs：
**直接连接资源 ARNs**
| 资源类型 | 进行筛选 |
| --- | --- |
| dxcon | arn:\$1\$1Partition\$1:directconnect:\$1\$1Region\$1:\$1\$1Account\$1:dxcon/\$1\$1ConnectionId\$1 |
| dxlag | arn:\$1\$1Partition\$1:directconnect:\$1\$1Region\$1:\$1\$1Account\$1:dxlag/\$1\$1LagId\$1 |
| dx-vif | arn:\$1\$1Partition\$1:directconnect:\$1\$1Region\$1:\$1\$1Account\$1:dxvif/\$1\$1VirtualInterfaceId\$1 |
| dx-gateway | arn:\$1\$1Partition\$1:directconnect::\$1\$1Account\$1:dx-gateway/\$1\$1DirectConnectGatewayId\$1 |
有关格式的更多信息 ARNs，请参阅 [Amazon 资源名称 (ARNs) 和 Amazon 服务命名空间](https://docs.amazonaws.cn/general/latest/gr/aws-arns-and-namespaces.html)。
例如，要在语句中指定 `dxcon-11aa22bb` 接口，请使用以下 ARN：
```
"Resource": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb
```
要指定属于特定账户的所有虚拟接口，请使用通配符 (\$1)：
```
"Resource": "arn:aws:directconnect:*:*:dxvif/*"
```
无法对特定资源执行某些 Direct Connect 操作，例如，创建资源的操作。在这些情况下，您必须使用通配符（\$1)。
```
"Resource": "*"
```
要查看 Direct Connect 资源类型及其列表 ARNs，请参阅 *IAM 用户指南 Amazon Direct Connect*中[定义的资源类型](https://docs.amazonaws.cn/IAM/latest/UserGuide/list_awsdirectconnect.html#awsdirectconnect-resources-for-iam-policies)。要了解您可以在哪些操作中指定每个资源的 ARN，请参阅 [Direct Connect 定义的操作](https://docs.amazonaws.cn/IAM/latest/UserGuide/list_awsdirectconnect.html#awsdirectconnect-actions-as-permissions)。
如果在、、、或 IAM 策略声明的`Resource`字段中指定了资源 ARN 或资源 ARN 模式以外的`*`资源 ARN 模式 DescribeConnections DescribeVirtualInterfaces DescribeDirectConnectGateways DescribeInterconnects DescribeLags，则除非在 API 调用中还传递了匹配的资源 ID，否则指定的内容`Effect`不会出现。但是，如果您在 IAM 策略声明中提供 `*` 作为资源而不是特定的资源 ID，则指定的 `Effect` 将起作用。
在以下示例中，如果在请求中未传递 `connectionId` 的情况下调用 `DescribeConnections` 操作，则两个指定的 `Effect` 都不会成功。
```
"Statement": [
{
"Effect": "Allow",
"Action": [
"directconnect:DescribeConnections"
],
"Resource": [
"arn:aws:directconnect:*:123456789012:dxcon/*"
]
},
{
"Effect": "Deny",
"Action": [
"directconnect:DescribeConnections"
],
"Resource": [
"arn:aws:directconnect:*:123456789012:dxcon/example1"
]
}
]
```
但是，在以下示例中，无论在请求中是否指定了 `connectionId`，`DescribeConnections` 操作的 `"Effect": "Allow"` 都将成功，这是由于为 IAM 策略声明的 `Resource` 字段提供了 `*`。
```
"Statement": [
{
"Effect": "Allow",
"Action": [
"directconnect:DescribeConnections
],
"Resource": [
"*"
]
}
]
```
### 条件键
管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。
`Condition` 元素根据定义的条件指定语句何时执行。您可以创建使用[条件运算符](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。要查看所有 Amazon 全局条件键，请参阅 *IAM 用户指南*中的[Amazon 全局条件上下文密钥](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html)。
Direct Connect 定义了一组自己的条件键，还支持使用一些全局条件键。要查看所有 Amazon 全局条件键，请参阅 *IAM 用户指南*中的[Amazon 全局条件上下文密钥](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html)。
您可以将条件键与标签资源一起使用。有关更多信息，请参阅[示例：限制对特定区域的访问](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/ExamplePolicies_EC2.html#iam-example-region)。
要查看 Direct Connect 条件键列表，请参阅《IAM 用户指南》**中的 [Direct Connect 条件键](https://docs.amazonaws.cn/IAM/latest/UserGuide/list_awsdirectconnect.html#awsdirectconnect-policy-keys)。要了解您可以对哪些操作和资源使用条件键，请参阅 [Direct Connect 定义的操作](https://docs.amazonaws.cn/IAM/latest/UserGuide/list_awsdirectconnect.html#awsdirectconnect-actions-as-permissions)。
## 使用 Direct Connect 控制台
要访问 Direct Connect 控制台，您必须拥有一组最低权限。这些权限必须允许您列出和查看有关您 Amazon 账户中 Direct Connect 资源的详细信息。如果创建的基于身份的策略比最低权限要求更严格，则对于具有该策略的实体（用户或角色），控制台将无法按预期工作。
为确保这些实体仍然可以使用 Direct Connect 控制台，还需要将以下 Amazon 托管策略附加到这些实体。有关更多信息，请参阅《IAM 用户指南》中的[为用户添加权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)**：
```
directconnect
```
对于仅调用 Amazon CLI 或 Amazon API 的用户，您无需为其设置最低控制台权限。相反，只允许访问与您尝试执行的 API 操作相匹配的操作。
## 允许用户查看他们自己的权限
该示例说明了您如何创建策略，以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用 Amazon CLI 或 Amazon 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": "*"
}
]
}
```
## 只读访问权限 Amazon Direct Connect
以下示例策略授予对的读取权限 Amazon Direct Connect。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"directconnect:Describe*",
"ec2:DescribeVpnGateways"
],
"Resource": "*"
}
]
}
```
------
## 完全访问权限 Amazon Direct Connect
以下示例策略授予对的完全访问权限 Amazon Direct Connect。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"directconnect:*",
"ec2:DescribeVpnGateways"
],
"Resource": "*"
}
]
}
```
------