Skip to content

RedColours is a small RedTeam lab mimicking an AWS infra and Privilege Escalation example for students

License

Notifications You must be signed in to change notification settings

securityjoes/RedColours

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

RedColors - Cloud Attack Simulator

RedColors Logo

A comprehensive local cloud attack simulator for red-team training and blue-team education. RedColors simulates realistic cloud attack chains with Metasploit-style CLI output, MITRE ATT&CK mappings, and comprehensive reporting.

🎯 Overview

RedColors is designed to help security professionals understand cloud attack techniques through safe, local simulation. It provides:

  • Red Team Tools: Attack simulation with realistic progression
  • Blue Team Tools: Security analysis and reporting
  • Educational Value: MITRE ATT&CK mappings and detailed explanations
  • Safety First: All operations are local-only with fake credentials

πŸ—οΈ Architecture

Core Modules

Module Purpose Type
IAM Parser Parse and validate IAM configurations Foundation
Vulnerable Lab Simulate vulnerable cloud services Red Team
IAM Analyzer Analyze trust relationships and escalation paths Blue Team
Attack Engine Simulate attack chains with CLI output Red Team
Report Generator Create comprehensive security reports Blue Team
CLI Interface Orchestrate all modules Interface

πŸš€ Quick Start

Prerequisites

  • Python 3.8+
  • pip

Installation

# Clone the repository git clone https://github.com/yourusername/RedColors.git cd RedColors # Install dependencies pip install -r requirements.txt

Basic Usage

# Run attack simulation with Metasploit-style CLI python examples/usage_attack_engine.py

🎨 Features

Metasploit-Style CLI

  • Colored output with professional styling
  • 1-second delays for dramatic effect
  • MITRE ATT&CK mappings for each technique
  • Real-time attack progression display

Attack Simulation

  • Privilege Escalation via role assumption
  • Data Exfiltration through S3 access
  • Persistence via IAM role creation
  • CloudTrail Events generation
  • SIEM Alerts creation

Security Analysis

  • Trust Graph visualization
  • Risk Assessment with scoring
  • Compliance Status checking
  • Recommendations generation

πŸ“Š Example Output

[*] alice attempting to assume role using sts:AssumeRole MITRE ATT&CK: T1078.004 [+] alice successfully assumed role [!] alice successfully created a Lambda function with Admin role [!] Alert: alice suspected as compromised user [!] Data exfiltration successful: 1024 bytes 

πŸ›‘οΈ Safety Features

  • Local-only operations - No external API calls
  • Fake credentials - All tokens prefixed with "TEMP_"
  • Simulation markers - Clear identification of test data
  • Comprehensive validation - Safety checks at every step

πŸ“ Project Structure

RedColors/ β”œβ”€β”€ src/ # Core modules β”‚ β”œβ”€β”€ iam_parser.py # IAM data parsing β”‚ β”œβ”€β”€ vulnerable_lab.py # Vulnerable API simulation β”‚ β”œβ”€β”€ analyzer.py # IAM analysis (Blue Team) β”‚ β”œβ”€β”€ attack_engine.py # Attack simulation (Red Team) β”‚ └── report_generator.py # Security reporting β”œβ”€β”€ examples/ # Usage examples β”œβ”€β”€ tests/ # Unit tests β”œβ”€β”€ specs/ # Specifications └── templates/ # Report templates 

πŸ§ͺ Testing

# Run all tests python -m pytest tests/ -v # Run specific module tests python -m pytest tests/test_attack_engine.py -v

πŸ“š Documentation

πŸŽ“ Educational Use

RedColors is perfect for:

  • Red Team Training - Understanding attack techniques
  • Blue Team Education - Learning defense strategies
  • Security Awareness - Demonstrating cloud risks
  • Threat Intelligence - MITRE ATT&CK technique mapping

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Submit a pull request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

RedColors is designed for educational and training purposes only. Always ensure you have proper authorization before testing security measures. The authors are not responsible for any misuse of this tool.

πŸ† Acknowledgments

  • MITRE ATT&CK framework for technique classification
  • AWS for cloud security concepts
  • The security community for best practices

Made with ❀️ for the security community

About

RedColours is a small RedTeam lab mimicking an AWS infra and Privilege Escalation example for students

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages