# aws-samples/aws-incident-response-playbooks architecture

> Architecture diagram of the GitHub repository aws-samples/aws-incident-response-playbooks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-samples/aws-incident-response-playbooks
- Repository: https://github.com/aws-samples/aws-incident-response-playbooks

## Overview

##### Project type and purpose
- This is an open-source, Markdown-based template repository of AWS Incident Response Playbooks.
- Its purpose is to provide security teams with customizable, NIST-compliant guides for handling AWS incidents (e.g., GuardDuty findings, IAM anomalies, malware, DoS, data breaches, ransomware, etc.).

##### File structure
- Top-level entries:
- README.md – high-level overview, usage, licensing
- CONTRIBUTING.md, LICENSE*, LICENSE-SUMMARY – governance, legal
- playbooks/ – all incident-response templates, organized by broad category
- Under playbooks/:
- “Amazon GuardDuty Playbooks” subfolder (further subdivided into EKS, IAM, Malware)
- Stand-alone IRP-*.md files for generic scenarios (CredCompromise, DataAccess, DoS, PersonalDataBreach, Ransomware)

##### README for additional insights
- Confirms Markdown format for easy ingestion into knowledge-management systems
- References NIST SP 800-61r2 framework (Prepare, Detect, Analyze, Contain, Eradicate, Recover, Post-Mortem)
- Encourages customization and GameDay testing in AWS accounts

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Git Repository
    subgraph "Git Repository (Source)"
        repoRoot["Repository Root"]:::repo
        readme["README.md"]:::file
        contrib["CONTRIBUTING.md"]:::file
        lic["LICENSE"]:::file
        licSample["LICENSE-SAMPLECODE"]:::file
        licSum["LICENSE-SUMMARY"]:::file
        playbooksDir["playbooks/"]:::dir
    end

    %% Playbooks Templates
    subgraph "Playbooks Templates"
        guardDutyDir["Amazon GuardDuty Playbooks/"]:::dir
        eksDir["EKS Findings/"]:::dir
        eksFile1["IRP-GD-PrivilegeEscalation-Kubernetes_PrivilegedContainer.md"]:::file
        eksFile2["IRP-GD-SuccessfulAnonymousAccess-Kubernetes.md"]:::file
        iamDir["IAM Findings/"]:::dir
        iamFile["IAMAnomolousBehavior-Impact.md"]:::file
        malwareDir["Malware Findings/"]:::dir
        malFile["EC2MalwareFindings.md"]:::file
        gen1["IRP-CredCompromise.md"]:::file
        gen2["IRP-DataAccess.md"]:::file
        gen3["IRP-DoS.md"]:::file
        gen4["IRP-PersonalDataBreach.md"]:::file
        gen5["IRP-Ransomware.md"]:::file
    end

    %% Roles and Systems
    subgraph "Security Practitioner" 
        user["Security Practitioner"]:::user
    end
    subgraph "AWS Environment"
        aws["AWS Services\n(GuardDuty, EKS, IAM, CloudWatch)"]:::aws
    end
    subgraph "Knowledge Management System"
        kms["Knowledge Management\n(Confluence, SharePoint)"]:::kms
    end
    nist["NIST SP 800-61r2"]:::ext

    %% Connections
    repoRoot --> readme
    repoRoot --> contrib
    repoRoot --> lic
    repoRoot --> licSample
    repoRoot --> licSum
    repoRoot --> playbooksDir

    playbooksDir --> guardDutyDir
    guardDutyDir --> eksDir
    eksDir --> eksFile1
    eksDir --> eksFile2
    guardDutyDir --> iamDir
    iamDir --> iamFile
    guardDutyDir --> malwareDir
    malwareDir --> malFile

    playbooksDir --> gen1
    playbooksDir --> gen2
    playbooksDir --> gen3
    playbooksDir --> gen4
    playbooksDir --> gen5

    repoRoot -->|"clone, edit"| user
    user -->|"test templates"| aws
    aws -->|"provide findings"| user
    user -->|"publish playbooks"| kms

    playbooksDir -->|"structure follows"| nist

    %% Click Events
    click readme "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/README.md"
    click contrib "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/CONTRIBUTING.md"
    click lic "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/LICENSE"
    click licSample "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/LICENSE-SAMPLECODE"
    click licSum "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/LICENSE-SUMMARY"
    click playbooksDir "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/playbooks/"
    click guardDutyDir "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/playbooks/Amazon GuardDuty Playbooks/"
    click eksDir "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/playbooks/Amazon GuardDuty Playbooks/EKS Findings/"
    click eksFile1 "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/Amazon GuardDuty Playbooks/EKS Findings/IRP-GD-PrivilegeEscalation-Kubernetes_PrivilegedContainer.md"
    click eksFile2 "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/Amazon GuardDuty Playbooks/EKS Findings/IRP-GD-SuccessfulAnonymousAccess-Kubernetes.md"
    click iamDir "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/playbooks/Amazon GuardDuty Playbooks/IAM Findings/"
    click iamFile "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/Amazon GuardDuty Playbooks/IAM Findings/IAMAnomolousBehavior-Impact.md"
    click malwareDir "https://github.com/aws-samples/aws-incident-response-playbooks/tree/master/playbooks/Amazon GuardDuty Playbooks/Malware Findings/"
    click malFile "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/Amazon GuardDuty Playbooks/Malware Findings/EC2MalwareFindings.md"
    click gen1 "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/IRP-CredCompromise.md"
    click gen2 "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/IRP-DataAccess.md"
    click gen3 "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/IRP-DoS.md"
    click gen4 "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/IRP-PersonalDataBreach.md"
    click gen5 "https://github.com/aws-samples/aws-incident-response-playbooks/blob/master/playbooks/IRP-Ransomware.md"

    %% Styles
    classDef repo fill:#f2f2f2,stroke:#333,stroke-width:1px
    classDef dir fill:#d9edf7,stroke:#31708f,stroke-width:1px
    classDef file fill:#fcf8e3,stroke:#8a6d3b,stroke-width:1px
    classDef user fill:#dff0d8,stroke:#3c763d,stroke-width:1px
    classDef aws fill:#faebcc,stroke:#8a6d3b,stroke-width:1px
    classDef kms fill:#d9edf7,stroke:#31708f,stroke-width:1px
    classDef ext fill:#f7f7f7,stroke:#666,stroke-dasharray: 2 2,stroke-width:1px
```
