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 AegisCore_Architecture (1) (1) drawio ### Wazuh Alert Monitoring Security events collected from the Cowrie honeypot and ingested into Wazuh SIEM for analysis and enrichment. Screenshot 2026-05-20 191649 ### Wazuh Alert Expanded Screenshot 2026-05-29 123315 Screenshot 2026-05-29 123347 ### Generated Incident Report Screenshot 2026-05-28 231130 Screenshot 2026-05-28 231114 Screenshot 2026-05-28 231102 Screenshot 2026-05-28 231050 Screenshot 2026-05-28 231033 Screenshot 2026-05-28 231010 Screenshot 2026-05-28 230944 ## 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.
标签:后端开发