# nattomr/malware-analysis-reverse-engineering-lab architecture

> Architecture diagram of the GitHub repository nattomr/malware-analysis-reverse-engineering-lab, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nattomr/malware-analysis-reverse-engineering-lab
- Repository: https://github.com/nattomr/malware-analysis-reverse-engineering-lab

## Overview

This repository is a defensive malware-analysis lab and methodology, not a single automated analysis pipeline. Its documented workflow takes unknown samples through static and dynamic analysis, behavior profiling, reverse engineering, detection engineering, and reporting. The sampled Python tools implement hashing, PE inspection, string/IOC extraction, and YARA validation; other major stages are documented but their implementations are not sampled. Workflow links use the README’s explicit phase sequence, so they describe the methodology rather than verified runtime calls.

Main entry points: [`dynamic-analysis`](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/dynamic-analysis) (Dynamic Monitoring), [`scripts/hash_calculator.py`](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/scripts/hash_calculator.py) (Hash Calculator), [`behavior-profiling`](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/behavior-profiling) (Behavior Profiling), [`mitre`](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/mitre) (ATT&CK Mapping)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_triage["Static Triage"]
  node_hash["Hash Calculator<br/>[hash_calculator.py]"]
  node_catalog["Sample Hash Catalog<br/>[sample_hashes.json]"]
  node_pe["PE Inspector<br/>[pe_inspector.py]"]
  node_strings["String &amp; IOC Extraction"]
end

subgraph group_analysis["Behavior Analysis"]
  node_dynamic["Dynamic Monitoring"]
  node_profiling["Behavior Profiling"]
  node_mitre["ATT&amp;CK Mapping"]
  node_reverse["Reverse Engineering"]
end

subgraph group_detection["Detection Engineering"]
  node_rules["YARA Rules"]
  node_validator["YARA Validator<br/>[yara_validator.py]"]
end

subgraph group_intel["Intelligence &amp; Safety"]
  node_reports["Analysis Reports"]
  node_containment["Lab Safety Controls<br/>[safety-protocol.md]"]
end

node_sample(("Unknown Sample"))
node_defense(("Actionable Defense"))

node_sample -->|"hashes"| node_hash
node_hash -->|"records hashes"| node_catalog
node_sample -->|"inspects"| node_pe
node_sample -->|"extracts IOCs"| node_strings
node_sample -->|"observed during execution"| node_dynamic
node_dynamic -->|"informs"| node_profiling
node_profiling -->|"maps behavior"| node_mitre
node_mitre -->|"workflow continues"| node_reverse
node_reverse -->|"informs detection"| node_rules
node_rules -->|"validated by"| node_validator
node_validator -->|"validation results"| node_reports
node_reports -->|"communicates findings"| node_defense
node_containment -.->|"constrains analysis"| node_dynamic

click node_hash "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/scripts/hash_calculator.py"
click node_catalog "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/samples/sample_hashes.json"
click node_pe "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/scripts/pe_inspector.py"
click node_strings "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/static-analysis/string-ioc-extractor.py"
click node_dynamic "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/dynamic-analysis"
click node_profiling "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/behavior-profiling"
click node_mitre "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/mitre"
click node_reverse "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/reverse-engineering"
click node_rules "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/yara/rules"
click node_validator "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/scripts/yara_validator.py"
click node_reports "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/reports"
click node_containment "https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/docs/safety-protocol.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_hash,node_catalog,node_pe,node_strings toneBlue
class node_dynamic,node_profiling,node_mitre,node_reverse toneAmber
class node_rules,node_validator toneMint
class node_reports,node_containment toneRose
class node_sample,node_defense toneIndigo
```

## Components

### Static Triage

- [Hash Calculator](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/scripts/hash_calculator.py): `scripts/hash_calculator.py`
- [Sample Hash Catalog](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/samples/sample_hashes.json): `samples/sample_hashes.json`
- [PE Inspector](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/scripts/pe_inspector.py): `scripts/pe_inspector.py`
- [String & IOC Extraction](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/static-analysis/string-ioc-extractor.py): `static-analysis/string-ioc-extractor.py`

### Behavior Analysis

- [Dynamic Monitoring](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/dynamic-analysis): `dynamic-analysis`
- [Behavior Profiling](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/behavior-profiling): `behavior-profiling`
- [ATT&CK Mapping](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/mitre): `mitre`
- [Reverse Engineering](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/reverse-engineering): `reverse-engineering`

### Detection Engineering

- [YARA Rules](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/yara/rules): `yara/rules`
- [YARA Validator](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/scripts/yara_validator.py): `scripts/yara_validator.py`

### Intelligence & Safety

- [Analysis Reports](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/tree/main/reports): `reports`
- [Lab Safety Controls](https://github.com/nattomr/malware-analysis-reverse-engineering-lab/blob/main/docs/safety-protocol.md): `docs/safety-protocol.md`

### Other components

- **Unknown Sample**
- **Actionable Defense**

## Connections

- Unknown Sample → Hash Calculator: hashes (evidence: `README.md`)
- Hash Calculator → Sample Hash Catalog: records hashes (evidence: `README.md`)
- Unknown Sample → PE Inspector: inspects (evidence: `README.md`)
- Unknown Sample → String & IOC Extraction: extracts IOCs (evidence: `README.md`)
- Unknown Sample → Dynamic Monitoring: observed during execution (evidence: `README.md`)
- Dynamic Monitoring → Behavior Profiling: informs (evidence: `README.md`)
- Behavior Profiling → ATT&CK Mapping: maps behavior (evidence: `README.md`)
- ATT&CK Mapping → Reverse Engineering: workflow continues (evidence: `README.md`)
- Reverse Engineering → YARA Rules: informs detection (evidence: `README.md`)
- YARA Rules → YARA Validator: validated by (evidence: `README.md`)
- YARA Validator → Analysis Reports: validation results (evidence: `README.md`)
- Analysis Reports → Actionable Defense: communicates findings (evidence: `README.md`)
- Lab Safety Controls → Dynamic Monitoring: constrains analysis (evidence: `README.md`)
