# mikoiv/azuresentinel-awsguardduty architecture

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

- Interactive diagram: https://gitdiagram.com/mikoiv/azuresentinel-awsguardduty
- Repository: https://github.com/mikoiv/azuresentinel-awsguardduty

## Overview

##### Project type and purpose
- This is not a traditional “code-only” repo but a reference integration solution: it shows how to pipe AWS GuardDuty findings into Azure Sentinel via S3 and Logstash.
- Purpose: enable security teams to export GuardDuty JSON findings from AWS into an Azure Log Analytics (Sentinel) workspace for querying, hunting and alerting.

##### File structure
- Top-level files:
- README.md – contains all the documentation and logical flow of the solution
- LICENSE – standard open-source license
- There is no “code” directory; the deliverable is a configuration / deployment design and instructions.

##### Key insights from the README
- Components: AWS GuardDuty → S3 export → Logstash input plugin → Logstash output plugin → Azure Sentinel (Log Analytics)
- AWS IAM (S3 read) and Azure Sentinel workspace credentials
- Optional security-hardening steps around Logstash secrets
- Basic Kusto query examples and workbook screenshots

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "AWS Cloud"
        AWSGuardDuty["AWS GuardDuty"]:::aws
        S3Bucket["S3 Bucket<br/>(GuardDuty Export)"]:::aws
        IAMRoles["IAM Roles<br/>(S3 Read)"]:::security
    end

    subgraph "Logstash Server<br/>(EC2 or Azure VM)"
        Logstash["Logstash Pipeline<br/>(input { s3 {} } → filters → output { azure_loganalytics {} })"]:::logstash
    end

    subgraph "Azure Cloud"
        AzureSentinel["Azure Sentinel<br/>(Log Analytics Workspace)"]:::azure
    end

    subgraph "Security Operations"
        Analysts["Security Analysts"]:::analyst
    end

    AWSGuardDuty -->|"Export JSON (15-360 min)"| S3Bucket
    S3Bucket -->|"S3 API / Logstash S3 Input"| Logstash
    IAMRoles -.->|"Auth (least privilege)"| Logstash
    Logstash -->|"Azure Log Analytics Output"| AzureSentinel
    AzureSentinel -->|"Query, Hunting, Dashboards"| Analysts

    click AWSGuardDuty "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/README.md"
    click S3Bucket "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/README.md"
    click IAMRoles "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/README.md"
    click Logstash "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/README.md"
    click AzureSentinel "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/README.md"
    click AWSGuardDuty "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/architecture_overview_v2.drawio"
    click S3Bucket "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/architecture_overview_v2.drawio"
    click IAMRoles "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/architecture_overview_v2.drawio"
    click Logstash "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/architecture_overview_v2.drawio"
    click AzureSentinel "https://github.com/mikoiv/azuresentinel-awsguardduty/blob/master/architecture_overview_v2.drawio"

    classDef aws fill:#F58536,stroke:#333,stroke-width:1px,color:#000
    classDef logstash fill:#DDDDDD,stroke:#333,stroke-width:1px,color:#000
    classDef azure fill:#2C9AB7,stroke:#333,stroke-width:1px,color:#fff
    classDef security fill:#CCCCCC,stroke:#333,stroke-width:1px,color:#000
    classDef analyst fill:#8FBAC8,stroke:#333,stroke-width:1px,color:#000
```
