Subchapter 41.3
references/detective.mdMarkdown3 KBView on GitHub
Amazon Detective helps investigate security findings by building behavior graphs from CloudTrail management events, VPC Flow Logs, GuardDuty findings, EKS audit logs, and Security Hub CSPM findings. It does not generate findings — it provides investigation context through entity profiles, finding groups, and automated investigations. Detective does NOT support S3 data events. Detective uses AWS Security Finding Format (ASFF) for ingestion. It does not produce findings — it produces investigations.
graph LR
CT[CloudTrail Mgmt Events] --> DET[Detective]
VPC[VPC Flow Logs] --> DET
GDF[GuardDuty Findings] --> DET
EKS[EKS Audit Logs] --> DET
SHF[Security Hub CSPM Findings] --> DET
DET -->|builds| BG[Behavior Graphs / Investigations]| API | Purpose |
|---|---|
detective:ListGraphs | Discover behavior graphs |
detective:ListDatasourcePackages | Check enabled data source packages |
detective:ListMembers | List graph members |
detective:ListInvitations | Check pending invitations |
detective:ListOrganizationAdminAccounts | Identify delegated admin |
detective:DescribeOrganizationConfiguration | Get org auto-enable settings |
detective:ListInvestigations | List investigations with filters |
detective:GetInvestigation | Get investigation details |
detective:ListIndicators | List indicators for an investigation |
Detective investigations use a severity score:
| Level | Description |
|---|---|
| INFORMATIONAL | Investigation found no notable indicators |
| LOW | Minor anomalies detected |
| MEDIUM | Notable behavioral deviations |
| HIGH | Significant threat indicators |
| CRITICAL | Strong evidence of compromise |
Key notes:
Documentation: https://docs.aws.amazon.com/detective/latest/userguide/detective-investigations.html (opens in a new tab)
Detective investigation details (GetInvestigation, ListIndicators) contain:
Present investigation status/severity summary first. Offer full indicator details on request.