本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon GuardDuty 的身分型政策範例
依預設，使用者和角色不具備建立或修改 GuardDuty 資源的許可。若要授予使用者對其所需資源執行動作的許可，IAM 管理員可以建立 IAM 政策。
如需了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱《*IAM 使用者指南*》中的[建立 IAM 政策 (主控台)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。
如需有關 GuardDuty 定義之動作和資源類型的詳細資訊，包括每種資源類型的 ARN 格式，請參閱《服務授權參考》**中的 [Amazon GuardDuty 的動作、資源和條件鍵](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonguardduty.html)。
**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)
+ [用於授予 GuardDuty 唯讀存取權限的自訂 IAM 政策](#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)** – 如果您的案例需要 IAM 使用者或 中的根使用者 AWS 帳戶，請開啟 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": "*"
}
]
}
```
## 用於授予 GuardDuty 唯讀存取權限的自訂 IAM 政策
若要授予 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 資源的存取權限
若要根據偵測器 ID 定義使用者對 GuardDuty 的存取權限，您可以在自訂 IAM 政策中使用所有 [GuardDuty API 動作](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_Operations.html)，但下列操作**除外**：
+ `guardduty:CreateDetector`
+ `guardduty:DeclineInvitations`
+ `guardduty:DeleteInvitations`
+ `guardduty:GetInvitationsCount`
+ `guardduty:ListDetectors`
+ `guardduty:ListInvitations`
在 IAM 政策中使用下列操作，以根據 IPSet ID 和 ThreatIntelSet ID 定義使用者對 GuardDuty 的存取權限：
+ `guardduty:DeleteIPSet`
+ `guardduty:DeleteThreatIntelSet`
+ `guardduty:GetIPSet`
+ `guardduty:GetThreatIntelSet`
+ `guardduty:UpdateIPSet`
+ `guardduty:UpdateThreatIntelSet`
以下範例說明如何使用一些上述操作來建立政策：
+ 此政策可讓使用者執行 `guardduty:UpdateDetector` 操作，並在 us-east-1 區域中使用偵測器 ID 1234567：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"guardduty:UpdateDetector"
],
"Resource": "arn:aws:guardduty:us-east-1:123456789012:detector/1234567"
}
]
}
```
------
+ 此政策可讓使用者執行 `guardduty:UpdateIPSet` 操作，並在 us-east-1 區域中使用偵測器 ID 1234567 和 IPSet ID 000000：
**注意**
請確保使用者擁有所需許可，以在 GuardDuty 中存取信任 IP 清單和威脅清單。如需詳細資訊，請參閱[設定實體清單和 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"
}
]
}
```
------
+ 此政策可讓使用者執行 `guardduty:UpdateIPSet` 操作，並在 us-east-1 區域中使用任何偵測器 ID 和 IPSet ID 000000：
**注意**
請確保使用者擁有所需許可，以在 GuardDuty 中存取信任 IP 清單和威脅清單。如需詳細資訊，請參閱[設定實體清單和 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"
}
]
}
```
------
+ 此政策可讓使用者執行 `guardduty:UpdateIPSet` 操作，並在 us-east-1 區域中使用其偵測器 ID 和任何 IPSet ID：
**注意**
請確保使用者擁有所需許可，以在 GuardDuty 中存取信任 IP 清單和威脅清單。如需詳細資訊，請參閱[設定實體清單和 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/*"
}
]
}
```
------