本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Amazon 基于身份的政策示例 GuardDuty
默认情况下，用户和角色没有创建或修改 GuardDuty 资源的权限。要授予用户对所需资源执行操作的权限，IAM 管理员可以创建 IAM 策略。
要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》**中的[创建 IAM 策略（控制台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。
有关由 GuardDuty定义的操作和资源类型（包括每种资源类型的格式）的详细信息，请参阅《*服务授权参考*》 GuardDuty中的 [Amazon 操作、资源和条件密钥](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonguardduty.html)。 ARNs
**Topics**
+ [策略最佳实践](#security_iam_service-with-iam-policy-best-practices)
+ [使用控制 GuardDuty 台](#security_iam_id-based-policy-examples-console)
+ [启用所需的权限 GuardDuty](#guardduty_enable-permissions)
+ [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions)
+ [用于授予只读访问权限的自定义 IAM 策略 GuardDuty](#security_iam_id-based-policy-examples-custom-readonly)
+ [拒绝访问 GuardDuty 调查结果](#security_iam_id-based-policy-examples-deny-findings)
+ [使用自定义 IAM 策略限制对 GuardDuty 资源的访问](#security_iam_id-based-policy-examples-guardduty_restrict_access_to_resources)
## 策略最佳实践
基于身份的策略决定了某人是否可以在您的账户中创建、访问或删除 GuardDuty 资源。这些操作可能会使 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)。
## 使用控制 GuardDuty 台
要访问 Amazon GuardDuty 控制台，您必须拥有一组最低权限。这些权限必须允许您列出和查看有关您的 GuardDuty 资源的详细信息 AWS 账户。如果创建比必需的最低权限更为严格的基于身份的策略，对于附加了该策略的实体（用户或角色），控制台将无法按预期正常运行。
对于仅调用 AWS CLI 或 AWS API 的用户，您无需为其设置最低控制台权限。相反，只允许访问与其尝试执行的 API 操作相匹配的操作。
为确保用户和角色仍然可以使用 GuardDuty 控制台，还需要将 GuardDuty `ConsoleAccess`或`ReadOnly` AWS 托管策略附加到实体。有关更多信息，请参阅《IAM 用户指南》**中的[为用户添加权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)。
## 启用所需的权限 GuardDuty
要授予各种 IAM 身份（用户、群组和角色）必须拥有的权限，请附加所需的[AWS 托管策略:AmazonGuardDutyFullAccess\$1v2（推荐）](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGuardDutyFullAccess-v2)策略以启用 GuardDuty。
## 允许用户查看他们自己的权限
该示例说明了您如何创建策略，以允许 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": "*"
}
]
}
```
## 用于授予只读访问权限的自定义 IAM 策略 GuardDuty
要授予只读访问权限， GuardDuty 您可以使用`AmazonGuardDutyReadOnlyAccess`托管策略。
要创建向 IAM 角色、用户或群组授予只读访问权限的自定义策略 GuardDuty，您可以使用以下语句：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"guardduty:ListMembers",
"guardduty:GetMembers",
"guardduty:ListInvitations",
"guardduty:ListDetectors",
"guardduty:GetDetector",
"guardduty:ListFindings",
"guardduty:GetFindings",
"guardduty:ListIPSets",
"guardduty:GetIPSet",
"guardduty:ListThreatIntelSets",
"guardduty:GetThreatIntelSet",
"guardduty:GetMasterAccount",
"guardduty:GetInvitationsCount",
"guardduty:GetFindingsStatistics",
"guardduty:DescribeMalwareScans",
"guardduty:UpdateMalwareScanSettings",
"guardduty:GetMalwareScanSettings"
],
"Resource": "*"
}
]
}
```
------
## 拒绝访问 GuardDuty 调查结果
您可以使用以下策略拒绝 IAM 角色、用户或群组访问 GuardDuty 调查结果。用户无法查看调查结果或有关调查结果的详细信息，但他们可以访问所有其他 GuardDuty 操作：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"guardduty:CreateDetector",
"guardduty:DeleteDetector",
"guardduty:UpdateDetector",
"guardduty:GetDetector",
"guardduty:ListDetectors",
"guardduty:CreateIPSet",
"guardduty:DeleteIPSet",
"guardduty:UpdateIPSet",
"guardduty:GetIPSet",
"guardduty:ListIPSets",
"guardduty:CreateThreatIntelSet",
"guardduty:DeleteThreatIntelSet",
"guardduty:UpdateThreatIntelSet",
"guardduty:GetThreatIntelSet",
"guardduty:ListThreatIntelSets",
"guardduty:ArchiveFindings",
"guardduty:UnarchiveFindings",
"guardduty:CreateSampleFindings",
"guardduty:CreateMembers",
"guardduty:InviteMembers",
"guardduty:GetMembers",
"guardduty:DeleteMembers",
"guardduty:DisassociateMembers",
"guardduty:StartMonitoringMembers",
"guardduty:StopMonitoringMembers",
"guardduty:ListMembers",
"guardduty:GetMasterAccount",
"guardduty:DisassociateFromMasterAccount",
"guardduty:AcceptAdministratorInvitation",
"guardduty:ListInvitations",
"guardduty:GetInvitationsCount",
"guardduty:DeclineInvitations",
"guardduty:DeleteInvitations"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": "arn:aws:iam::123456789012:role/aws-service-role/guardduty.amazonaws.com/AWSServiceRoleForAmazonGuardDuty",
"Condition": {
"StringLike": {
"iam:AWSServiceName": "guardduty.amazonaws.com"
}
}
},
{
"Effect": "Allow",
"Action": [
"iam:PutRolePolicy",
"iam:DeleteRolePolicy"
],
"Resource": "arn:aws:iam::123456789012:role/aws-service-role/guardduty.amazonaws.com/AWSServiceRoleForAmazonGuardDuty"
}
]
}
```
------
## 使用自定义 IAM 策略限制对 GuardDuty 资源的访问
要 GuardDuty 根据检测器 ID 定义用户的访问权限，您可以在自定义 IAM 策略中使用所有 [GuardDutyAPI 操作](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_Operations.html)，**但以下操作除外**：
+ `guardduty:CreateDetector`
+ `guardduty:DeclineInvitations`
+ `guardduty:DeleteInvitations`
+ `guardduty:GetInvitationsCount`
+ `guardduty:ListDetectors`
+ `guardduty:ListInvitations`
在 IAM 策略中使用以下操作 GuardDuty根据 IPSet ID 和 ThreatIntelSet ID 定义用户的访问权限：
+ `guardduty:DeleteIPSet`
+ `guardduty:DeleteThreatIntelSet`
+ `guardduty:GetIPSet`
+ `guardduty:GetThreatIntelSet`
+ `guardduty:UpdateIPSet`
+ `guardduty:UpdateThreatIntelSet`
以下示例说明如何使用之前的一些操作来创建策略：
+ 此策略允许用户在 us-east-1 区域中使用检测器 ID 1234567 运行 `guardduty:UpdateDetector` 操作：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"guardduty:UpdateDetector"
],
"Resource": "arn:aws:guardduty:us-east-1:123456789012:detector/1234567"
}
]
}
```
------
+ 此策略允许用户在 us-east-1 区域中使用探测器 ID 为 1234567 和 000000 的 IPSet ID 来运行`guardduty:UpdateIPSet`操作：
**注意**
确保用户具有访问中可信 IP 列表和威胁列表所需的权限 GuardDuty。有关更多信息，请参阅 [设置实体列表和 IP 地址列表的先决条件](guardduty-lists-prerequisites.md)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"guardduty:UpdateIPSet"
],
"Resource": "arn:aws:guardduty:us-east-1:123456789012:detector/1234567/ipset/000000"
}
]
}
```
------
+ 此策略允许用户在 us-east-1 区域中使用任何探测器 IPSet ID 和 000000 的 ID 来运行`guardduty:UpdateIPSet`操作：
**注意**
确保用户具有访问中可信 IP 列表和威胁列表所需的权限 GuardDuty。有关更多信息，请参阅 [设置实体列表和 IP 地址列表的先决条件](guardduty-lists-prerequisites.md)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"guardduty:UpdateIPSet"
],
"Resource": "arn:aws:guardduty:us-east-1:123456789012:detector/*/ipset/000000"
}
]
}
```
------
+ 此策略允许用户使用其探测器 ID 和 us-east-1 区域中的任何 IPSet ID 运行`guardduty:UpdateIPSet`操作：
**注意**
确保用户具有访问中可信 IP 列表和威胁列表所需的权限 GuardDuty。有关更多信息，请参阅 [设置实体列表和 IP 地址列表的先决条件](guardduty-lists-prerequisites.md)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"guardduty:UpdateIPSet"
],
"Resource": "arn:aws:guardduty:us-east-1:123456789012:detector/1234567/ipset/*"
}
]
}
```
------