# joukar4/azure_telemetry_sdk architecture

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

- Interactive diagram: https://gitdiagram.com/joukar4/azure_telemetry_sdk
- Repository: https://github.com/joukar4/azure_telemetry_sdk

## Overview

##### Project type and purpose
- This is a security-assessment toolkit for Microsoft 365, Azure, Active Directory, and related services.
- It orchestrates data collection via inspectors, analyzes risks and threats, and produces multi-format reports.
- It offers both CLI and GUI launchers and can be driven by PowerShell.

##### File structure
- Top-level modules:
- analyzers: risk, threat, compliance, ML, MITRE mapping
- core: authentication, service connectors, orchestration engine, PowerShell modules
- inspectors: AD, Azure, M365, compliance inspectors
- launcher: CLI, GUI, PowerShell bridge
- logging: audit, ECS, performance, structured
- reporting: CSV, HTML, JSON, PDF, dashboard generation
- utils: helpers for data validation, encryption, networking, PowerShell
- config: YAML configs (default, production, compliance frameworks, inspector configs)
- Workflow definitions in .github/workflows (CI/CD, tests).

##### README
- (Empty README—no architecture section provided.)

##### Detail without over-splitting
- Of the seven major layers: UI, Orchestrator, Auth, Connectors, Inspectors, Analyzers, Reporting.
- Config and Logging as background services.
- Detail one or two example inspectors/analyzers but group the rest as “other inspectors/analyzers” to avoid clutter.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "User Interface"
        CLI["CLI Launcher"]:::ui
        GUI["GUI Launcher"]:::ui
        PS["PowerShell Bridge"]:::ui
    end

    subgraph "Orchestration"
        MO["Main Orchestrator"]:::orch
        TS["Task Scheduler"]:::orch
        DM["Dependency Manager"]:::orch
    end

    subgraph "Authentication Service"
        AM["Auth Manager"]:::cross
        IA["Interactive Auth Adapter"]:::cross
        SP["Service Principal Adapter"]:::cross
        CA["Certificate Auth Adapter"]:::cross
    end

    subgraph "Connectors"
        AZC["Azure Connector"]:::conn
        GC["Graph Connector"]:::conn
        M5C["M365 Connector"]:::conn
        SC["Security Connector"]:::conn
        SPC["SharePoint Connector"]:::conn
        TC["Teams Connector"]:::conn
    end

    subgraph "Inspectors"
        subgraph "AD Inspectors"
            DI["Domain Inspector"]:::insp
        end
        subgraph "Azure Inspectors"
            ACI["Compute Inspector"]:::insp
        end
        subgraph "M365 Inspectors"
            EI["Exchange Inspector"]:::insp
        end
        OI["Other Inspectors"]:::insp
    end

    subgraph "Analyzers"
        TA["Threat Analyzer"]:::an
        CA2["Compliance Analyzer"]:::an
        MLA["ML Analyzer"]:::an
        OA["Other Analyzers"]:::an
    end

    subgraph "Reporting"
        RE["Reporting Engine"]:::rep
        HR["HTML Reporter"]:::rep
        CR["CSV Reporter"]:::rep
        JR["JSON Reporter"]:::rep
        PR["PDF Reporter"]:::rep
        DG["Dashboard Generator"]:::rep
    end

    ConfigFile["Configuration Store"]:::cross
    LoggingLayer["Logging Layer"]:::cross

    %% Flows
    CLI -->|launch| MO
    GUI -->|launch| MO
    PS -->|invoke| MO

    MO -->|uses| ConfigFile
    MO -->|coordinates| TS
    MO -->|auth request| AM

    AM -->|provides creds| AZC
    AM -->|provides creds| GC
    AM -->|provides creds| M5C
    AM -->|provides creds| SC
    AM -->|provides creds| SPC
    AM -->|provides creds| TC

    TS -->|schedule| DI
    TS -->|schedule| ACI
    TS -->|schedule| EI
    TS -->|schedule| OI

    DI -->|artifact| TA
    ACI -->|artifact| CA2
    EI -->|artifact| MLA
    OI -->|artifact| OA

    TA -->|results| RE
    CA2 -->|results| RE
    MLA -->|results| RE
    OA -->|results| RE

    RE -->|output| HR
    RE -->|output| CR
    RE -->|output| JR
    RE -->|output| PR
    RE -->|output| DG

    %% Cross-cutting Logging
    MO -.-> LoggingLayer
    AM -.-> LoggingLayer
    AZC -.-> LoggingLayer
    TS -.-> LoggingLayer
    DI -.-> LoggingLayer
    TA -.-> LoggingLayer
    RE -.-> LoggingLayer

    %% Click Events
    click CLI "https://github.com/joukar4/azure_telemetry_sdk/blob/main/launcher/cli_launcher.py"
    click GUI "https://github.com/joukar4/azure_telemetry_sdk/blob/main/launcher/gui_launcher.py"
    click PS "https://github.com/joukar4/azure_telemetry_sdk/blob/main/launcher/powershell_bridge.py"
    click MO "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/orchestrator/main_orchestrator.py"
    click TS "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/orchestrator/task_scheduler.py"
    click DM "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/orchestrator/dependency_manager.py"
    click AM "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/authentication/auth_manager.py"
    click IA "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/authentication/interactive_auth.py"
    click SP "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/authentication/service_principal.py"
    click CA "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/authentication/certificate_auth.py"
    click AZC "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/connectors/azure_connector.py"
    click GC "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/connectors/graph_connector.py"
    click M5C "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/connectors/m265_connector.py"
    click SC "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/connectors/security_connector.py"
    click SPC "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/connectors/sharepoint_connector.py"
    click TC "https://github.com/joukar4/azure_telemetry_sdk/blob/main/core/connectors/teams_connector.py"
    click DI "https://github.com/joukar4/azure_telemetry_sdk/blob/main/inspectors/ad_inspectors/domain_inspector.py"
    click ACI "https://github.com/joukar4/azure_telemetry_sdk/blob/main/inspectors/azure_inspectors/compute_inspector.py"
    click EI "https://github.com/joukar4/azure_telemetry_sdk/blob/main/inspectors/m365_inspectors/exchange_inspector.py"
    click TA "https://github.com/joukar4/azure_telemetry_sdk/blob/main/analyzers/threat_analyzer.py"
    click CA2 "https://github.com/joukar4/azure_telemetry_sdk/blob/main/analyzers/compliance_analyzer.py"
    click MLA "https://github.com/joukar4/azure_telemetry_sdk/blob/main/analyzers/ml_analyzer.py"
    click RE "https://github.com/joukar4/azure_telemetry_sdk/blob/main/reporting/report_engine.py"
    click HR "https://github.com/joukar4/azure_telemetry_sdk/blob/main/reporting/html_reporter.py"
    click CR "https://github.com/joukar4/azure_telemetry_sdk/blob/main/reporting/csv_reporter.py"
    click JR "https://github.com/joukar4/azure_telemetry_sdk/blob/main/reporting/json_reporter.py"
    click PR "https://github.com/joukar4/azure_telemetry_sdk/blob/main/reporting/pdf_reporter.py"
    click DG "https://github.com/joukar4/azure_telemetry_sdk/blob/main/reporting/dashboard_generator.py"
    click ConfigFile "https://github.com/joukar4/azure_telemetry_sdk/blob/main/config/default_config.yaml"
    click LoggingLayer "https://github.com/joukar4/azure_telemetry_sdk/blob/main/logging/structured_logger.py"

    %% Styles
    classDef ui fill:#D0E6FF,stroke:#024B8A,color:#024B8A
    classDef orch fill:#DFF2BF,stroke:#4F8A10,color:#4F8A10
    classDef conn fill:#FFE2A3,stroke:#FF8C00,color:#FF8C00
    classDef insp fill:#FFD1DC,stroke:#FF1493,color:#FF1493
    classDef an fill:#FFCCCC,stroke:#FF0000,color:#8B0000
    classDef rep fill:#E6CCFF,stroke:#800080,color:#4B0082
    classDef cross fill:#F0F0F0,stroke:#888888,color:#333333
```
