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

# 使用策略管理对 Amazon Q 的访问
<a name="security_iam_manage-access-with-policies"></a>

**注意**  
此页面上的信息与访问 Amazon Q 开发者版有关。有关管理亚马逊 Q 企业版访问权限的信息，请参阅《亚马逊 Q 企业*用户指南》中的 Amazon Q Business Identity-based* [政策示例](https://docs.aws.amazon.com/amazonq/latest/business-use-dg/security_iam_id-based-policy-examples.html)。  
本主题中的政策和示例特定于 AWS 管理控制台、 AWS Console Mobile Application AWS Documentation、 AWS 网站和聊天应用程序中的 Amazon Q。与 Amazon Q 集成的其他服务可能需要不同的策略或设置。第三方 IDE 中的 Amazon Q 的最终用户无需使用 IAM 策略。有关更多信息，请参阅包含 Amazon Q 功能或集成的服务的文档。

默认情况下，用户和角色无权使用 Amazon Q。IAM 管理员可以通过向 IAM 身份授予权限，管理对 Amazon Q 开发者版及其功能的访问。

管理员向用户授予访问权限的最快方法是通过 AWS 托管策略。该 `AmazonQFullAccess` 政策可以附加到 IAM 身份，以授予对 Amazon Q 开发者版及其功能的完全访问权限。有关此策略的更多信息，请参阅“[AWS 适用于 Amazon Q 开发者的托管政策](managed-policy.md)”。

要管理 IAM 身份可以通过 Amazon Q 开发者版执行的特定操作，管理员可以创建自定义策略来定义用户、组或角色拥有的权限。您还可以使用服务控制策略（SCP）控制可以在组织内使用的 Amazon Q 功能。

有关您可以通过策略控制的所有 Amazon Q 权限的列表，请参阅 [Amazon Q 开发者版权限参考](security_iam_permissions.md)。

**Topics**
+ [策略最佳实践](#security_iam_policy-best-practices)
+ [分配权限](#setting-up-assign-permissions)
+ [使用服务控制策略（SCP）管理访问](#service-control-policies)
+ [Identity-based Amazon Q 开发者的政策示例](security_iam_id-based-policy-examples.md)

## 策略最佳实践
<a name="security_iam_policy-best-practices"></a>

Identity-based 策略决定了是否有人可以在您的账户中创建、访问或删除 Amazon Q 开发者资源。这些操作可能会使 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="setting-up-assign-permissions"></a>

要提供访问权限，请为您的用户、组或角色添加权限：
+ 中的用户和群组 AWS IAM Identity Center：

  创建权限集合。按照《AWS IAM Identity Center 用户指南》**中[创建权限集](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html)的说明进行操作。
+ 通过身份提供者在 IAM 中托管的用户：

  创建适用于身份联合验证的角色。按照《IAM 用户指南》**中[针对第三方身份提供者创建角色（联合身份验证）](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html)的说明进行操作。
+ IAM 用户：
  + 创建您的用户可以担任的角色。按照《IAM 用户指南》**中[为 IAM 用户创建角色](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html)的说明进行操作。
  + （不推荐使用）将策略直接附加到用户或将用户添加到用户组。按照《IAM 用户指南》**中[向用户添加权限（控制台）](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)中的说明进行操作。

## 使用服务控制策略（SCP）管理访问
<a name="service-control-policies"></a>

服务控制策略（SCP）是一种组织策略，可用于管理组织中的权限。您可以通过创建指定部分或全部 Amazon Q 操作权限的 SCP，控制可以在组织中使用的 Amazon Q 开发者版功能。

有关使用 SCP 控制组织中访问权限的更多信息，请参阅《AWS Organizations 用户指南》**中的 [Creating, updating, and deleting service control policies](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps_create.html) 以及 [Attaching and detaching service control policies](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps_attach.html)。

### 示例 SCP：拒绝在欧盟区域以外访问 Amazon Q
<a name="example-scp-deny-q-outside-eu"></a>

以下 SCP 拒绝在欧洲地区（法兰克福）区域（eu-central-1）以外进行访问来使用 Amazon Q 开发者版。

**注意**  
`codewhisperer` 前缀是与 Amazon Q Developer 合并前的服务的旧名称。有关更多信息，请参阅 [Amazon Q 开发者版重命名：变更摘要](service-rename.md)。

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

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "DenyAmazonQDeveloperOutsideEU",
      "Effect": "Deny",
      "Action": [
         "codewhisperer:GenerateRecommendations",
         "q:SendMessage",
         "q:GenerateCodeFromCommands",
         "sqlworkbench:GetQSqlRecommendations"
         ],
      "Resource": "*",
      "Condition": {
        "StringNotEquals": 
        {"aws:RequestedRegion": [ "eu-central-1"] }
      }
    }
  ]
}
```

------

### 示例 SCP：拒绝访问 Amazon Q
<a name="example-scp-deny-q-access"></a>

以下 SCP 拒绝访问 Amazon Q 开发者版。

**注意**  
拒绝访问 Amazon Q 不会禁用 AWS 控制台、 AWS 网站、 AWS 文档页面或 Amazon Q 图标或聊天面板 AWS Console Mobile Application。

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

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "DenyAmazonQFullAccess",
      "Effect": "Deny",
      "Action": [
        "q:*"
      ],
      "Resource": "*"
    }
  ]
}
```

------