

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

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

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

有关 Amazon One Enterprise 定义的操作和资源类型（包括每种资源类型的格式）的详细信息，请参阅*服务授权参考[Amazon One Enterprise 的操作、资源和条件键](actions-resources-contextkeys.md)*中的。 ARNs 

**Topics**
+ [策略最佳实践](#security_iam_service-with-iam-policy-best-practices)
+ [使用 Amazon One 企业版控制台](#security_iam_id-based-policy-examples-console)
+ [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions)
+ [对 Amazon One 企业版的只读访问权限](#read-only-config-permission)
+ [完全访问亚马逊 One Enterprise](#full-config-permission)
+ [Amazon One 企业规则 API 操作支持的资源级权限](#supported-resource-level-permissions)
+ [附加信息](#config-permissions-more-info)

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

基于身份的策略决定了是否有人可以在您的账户中创建、访问或删除亚马逊One Enterprise资源。这些操作可能会使 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)。

## 使用 Amazon One 企业版控制台
<a name="security_iam_id-based-policy-examples-console"></a>

要访问 Amazon One Enterprise 控制台，您必须拥有一组最低权限。这些权限必须允许您列出和查看有关您的 Amazon One Enterprise 资源的详细信息 AWS 账户。如果创建比必需的最低权限更为严格的基于身份的策略，对于附加了该策略的实体（用户或角色），控制台将无法按预期正常运行。

对于仅调用 AWS CLI 或 AWS API 的用户，您无需为其设置最低控制台权限。相反，只允许访问与其尝试执行的 API 操作相匹配的操作。

为确保用户和角色仍然可以使用 Amazon One Enterprise 控制台，还要为实体附加 Amazon One Enterprise `ConsoleAccess` 或`ReadOnly` AWS 托管策略。有关更多信息，请参阅《IAM 用户指南》**中的[为用户添加权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)。

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

## 对 Amazon One 企业版的只读访问权限
<a name="read-only-config-permission"></a>

以下示例显示了一个 AWS 托管策略，`AmazonOneEnterpriseReadOnlyAccess`该策略授予对 Amazon One Enterprise 的只读访问权限。

在这些策略语句中，`Effect` 元素指定是允许还是拒绝操作。`Action` 元素列出了允许用户执行的特定操作。`Resource` 元素列出允许用户对其执行这些操作的 AWS 资源。对于控制对 Amazon One Enterprise 操作的访问权限的策略`*`，`Resource`元素始终设置为，通配符表示 “所有资源”。

`Action`元素中的值对应 APIs 于服务支持的值。这些操作前面加上，表示它们`config:`指的是 Amazon One Enterprise 操作。您可以在 `*` 元素中使用 `Action` 通配符，如以下示例所示：
+ `"Action": ["one:*DeviceInstanceConfiguration"]`

  这允许所有以 “DeviceInstance”（`GetDeviceInstanceConfiguration`，`CreateDeviceInstanceConfiguration`）结尾的 Amazon One Enterprise 操作。
+ `"Action": ["one:*"]`

  这允许所有 Amazon One Enterprise 操作，但不允许对其他 AWS 服务执行操作。
+ `"Action": ["*"]`

  这允许所有 AWS 操作。此权限适用于担任您账户 AWS 管理员的用户。

只读策略不向用户授予执行诸如`CreateDeviceInstance``UpdateDeviceInstance`、和之类的操作的权限`DeleteDeviceInstance`。使用此政策的用户不得创建设备实例、更新设备实例或删除设备实例。有关 Amazon One 企业版操作的列表，请参阅[Amazon One Enterprise 的操作、资源和条件键](actions-resources-contextkeys.md)。

## 完全访问亚马逊 One Enterprise
<a name="full-config-permission"></a>

以下示例显示了一项授予对 Amazon One Enterprise 完全访问权限的策略。它授予用户执行所有 Amazon One Enterprise 操作的权限。

**重要**  
此策略授予广泛的权限。在授予完全访问权限之前，请考虑从最低权限集开始，并根据需要授予其他权限。这样做比起一开始就授予过于宽松的权限而后再尝试收紧权限来说是更好的做法。

## Amazon One 企业规则 API 操作支持的资源级权限
<a name="supported-resource-level-permissions"></a>

*资源级权限*指的是能够指定允许用户对哪些资源执行操作的能力。Amazon One Enterprise 支持某些亚马逊 One Enterprise 规则 API 操作的资源级权限。这意味着，对于某些 Amazon One Enterprise 规则操作，您可以控制何时允许用户使用这些操作的条件。这些条件可以是必须满足的操作，也可以是允许用户使用的特定资源。

下表描述了目前支持资源级权限的 Amazon One Enterprise 规则 API 操作。它还描述了每个操作支持的资源及其 ARNs对应的资源。指定 ARN 时，可以在路径中使用\$1 通配符；例如，当您无法或不想指定确切的资源时。 IDs

**重要**  
如果此表中未列出 Amazon One Enterprise 规则 API 操作，则该操作不支持资源级权限。如果 Amazon One Enterprise 规则操作不支持资源级权限，则可以向用户授予使用该操作的权限，但必须为策略声明的资源元素指定\$1。


****  

| API 操作 | 资源 | 
| --- | --- | 
| CreateDeviceInstance | 设备实例 arn: aws: one:: device-instance/ *region:accountID* *deviceInstanceId* | 
| GetDeviceInstance | 设备实例 arn: aws: one:: device-instance/ *region:accountID* *deviceInstanceId* | 
| UpdateDeviceInstance | 设备实例 arn: aws: one:: device-instance/ *region:accountID* *deviceInstanceId* | 
| DeleteDeviceInstance | 设备实例 arn: aws: one:: device-instance/ *region:accountID* *deviceInstanceId* | 
| CreateDeviceActivationQrCode | 设备实例 arn: aws: one:: device-instance/ *region:accountID* *deviceInstanceId* | 
| DeleteAssociatedDevice | 设备实例 arn: aws: one:: device-instance/ *region:accountID* *deviceInstanceId* | 
| RebootDevice | 设备实例 arn: aws: one:: device-instance/ *region:accountID* *deviceInstanceId* | 
| CreateDeviceInstanceConfiguration | 设备实例配置 arn: aws: one:: device-instance/ /configuration/ *region:accountID* *deviceInstanceId* *version* | 
| GetDeviceInstanceConfiguration | 设备实例配置 arn: aws: one:: device-instance/ /configuration/ *region:accountID* *deviceInstanceId* *version* | 
| CreateSite | Site arn: aws: one:: site/ *region:accountID* *siteId* | 
| DeleteSite | Site arn: aws: one:: site/ *region:accountID* *siteId* | 
| GetSiteAddress | Site arn: aws: one:: site/ *region:accountID* *siteId* | 
| UpdateSite | Site arn: aws: one:: site/ *region:accountID* *siteId* | 
| UpdateSiteAddress | Site arn: aws: one:: site/ *region:accountID* *siteId* | 
| CreateDeviceConfigurationTemplate | 设备配置模板 arn: aws: one::/*region:accountID*device-configuration-template*templateId* | 
| DeleteDeviceConfigurationTemplate | 设备配置模板 arn: aws: one::/*region:accountID*device-configuration-template*templateId* | 
| GetDeviceConfigurationTemplate | 设备配置模板 arn: aws: one::/*region:accountID*device-configuration-template*templateId* | 
| UpdateDeviceConfigurationTemplate | 设备配置模板 arn: aws: one::/*region:accountID*device-configuration-template*templateId* | 

例如，您希望允许特定用户对特定规则进行的读访问，但拒绝特定用户对特定规则进行的写访问。

在第一个策略中，您可以允许 AWS Config 规则读取操作，例如`GetSite`对指定规则的读取操作。

在第二项策略中，您拒绝对特定规则执行 Amazon One Enterprise 规则的写入操作。

借助资源级权限，您可以允许读取权限和拒绝写入权限，以便对 Amazon One Enterprise 规则 API 操作执行特定操作。

## 附加信息
<a name="config-permissions-more-info"></a>

 要了解有关创建 IAM 用户、组、策略和权限的更多信息，请参阅 *IAM 用户指南*中的[创建您的第一个 IAM 用户和管理员组](https://docs.aws.amazon.com/IAM/latest/UserGuide/GSGHowToCreateAdminsGroup.html)和[访问控制](https://docs.aws.amazon.com/IAM/latest/UserGuide/PermissionsAndPolicies.html)。