dcalle44/AegisCore
GitHub: dcalle44/AegisCore
Stars: 1 | Forks: 0
# AegisCore
A cybersecurity detection and analysis platform that automates threat intelligence enrichment, alert correlation, risk scoring, MITRE ATT&CK mapping, and incident reporting for security operations workflows.
## Key Features
- Correlates repeated security events by source IP to reduce alert noise
- Builds attacker profiles from aggregated activity and threat intelligence
- Enriches indicators using AbuseIPDB and VirusTotal
- Maps detections to MITRE ATT&CK techniques
- Calculates risk scores based on event severity, frequency, and threat intelligence
- Generates executive-ready HTML incident reports
- Integrates with Wazuh SIEM and Cowrie honeypot telemetry
### OpenSearch Integration
- Connects directly to the Wazuh OpenSearch API
- Executes custom queries against security event indices
- Retrieves real-world security telemetry from SIEM data stores
- Processes JSON alert data for enrichment and analysis
- Supports automated ingestion of attacker activity from monitored environments
### Alert Correlation
- Aggregates repeated events from the same source IP
- Correlates multiple security events into attacker profiles
- Reduces duplicate alert noise
- Prioritizes attackers based on activity and threat intelligence
### Risk Scoring Engine
- Calculates threat scores using:
- Event frequency
- Rule severity
- AbuseIPDB reputation
- VirusTotal detections
- Contextual attack information
- Assigns severity classifications:
- Critical
- High
- Medium
- Low
### MITRE ATT&CK Mapping
- Maps observed attacker behavior to MITRE ATT&CK techniques
- Provides contextual understanding of adversary tactics and techniques
- Supports analyst investigation workflows
### Executive Reporting
- Generates professional HTML reports
- Summarizes attack activity and threat intelligence findings
- Displays attacker information in an easily consumable format
- Supports both technical and non-technical audiences
## System Architecture
AegisCore operates through the following workflow:
Internet Attackers
↓
Cowrie Honeypot
↓
Wazuh SIEM
↓
OpenSearch API
↓
AegisCore
↙ ↓ ↘
AbuseIPDB MITRE VirusTotal
↓
Risk Scoring Engine
↓
HTML Incident Report
## Example Workflow
1. Wazuh detects suspicious activity.
2. Alert data is collected and processed by AegisCore.
3. Source IP addresses are extracted.
4. Threat intelligence enrichment is performed using:
- AbuseIPDB
- VirusTotal
- Geolocation data
5. Related events are correlated into attacker profiles.
6. MITRE ATT&CK techniques are assigned.
7. Risk scores are calculated.
8. A professional HTML report is generated.
## Technologies Used
### Programming
- Python
### Security Platforms
- Wazuh SIEM
- Cowrie Honeypot
### Threat Intelligence
- AbuseIPDB API
- VirusTotal API
### Frameworks & Libraries
- Requests
- JSON
- HTML
- CSS
- JavaScript
### Security Frameworks
- MITRE ATT&CK
## Screenshots
### Architecture Diagram
### Wazuh Alert Monitoring
Security events collected from the Cowrie honeypot and ingested into Wazuh SIEM for analysis and enrichment.
### Wazuh Alert Expanded
### Generated Incident Report
## Installation
### Clone Repository
git clone https://github.com/dcalle44/AegisCore.git
cd AegisCore
### Install Dependencies
pip install -r requirements.txt
### Configure Environment Variables
Create a `.env` file and configure the following:
ABUSEIPDB_API_KEY=YOUR_KEY
VT_API_KEY=YOUR_KEY
GEOLOCATION_API_KEY=YOUR_KEY
### Run AegisCore
python main.py
## Example Output
Generated reports contain:
- Source IP
- Event Type
- Threat Score
- Severity Classification
- AbuseIPDB Reputation
- VirusTotal Results
- Country
- ISP
- Reasoning
- MITRE ATT&CK Mapping
## Lessons Learned
This project provided hands-on experience with:
- Security Operations Center (SOC) workflows
- Threat intelligence enrichment
- Alert triage and prioritization
- Detection engineering concepts
- MITRE ATT&CK mapping
- API integration
- Data correlation
- Security reporting automation
- SIEM integration
- Honeypot telemetry analysis
## Future Improvements
Planned enhancements include:
- Flask web application interface
- User authentication and role-based access control
- Live dashboard monitoring
- Threat intelligence caching improvements
- Additional threat intelligence providers
- Automated IOC export
- Historical trend analysis
- Email alerting
- REST API support
- Multi-tenant architecture
## Disclaimer
This project was developed for educational, research, and defensive cybersecurity purposes. All testing was performed within controlled environments using authorized systems and security monitoring platforms.
### Wazuh Alert Monitoring
Security events collected from the Cowrie honeypot and ingested into Wazuh SIEM for analysis and enrichment.
标签:后端开发