AI-Powered Network Defense. Enterprise-Grade Intelligence. Global-Scale Operations.
SecureNet is an AI-powered cybersecurity platform delivers autonomous threat detection, predictive risk assessment, and intelligent security operations management. It empowers organizations to efficiently manage network security, detect threats, and protect against cyber attacks, ensuring a secure and resilient network environment.
⭐ Star this repo • 📖 View Documentation • 🚀 System Status • 🎯 Launch Roadmap • 👥 Customer Onboarding
- 📖 Installation Guide - Complete setup instructions
- ⚡ Quick Start - Direct startup methods
- 🔧 Production Setup - Production deployment
- 🐳 Docker Setup - Containerized deployment
- 🏆 Enterprise Certification - Official certification
- 👥 User Management - RBAC and user administration
- 💰 Customer Onboarding - Subscription and billing
- 📋 Production Launch - Go/No-Go validation
- 🔒 Security Features - AI/ML threat detection capabilities
- 📋 Compliance Frameworks - SOC 2, ISO 27001, GDPR
- 📊 Security Hardening - Security configuration
- 🔍 Audit Reports - Security audit results
- 🏗️ System Architecture - Technical architecture
- 📡 API Reference - Complete API documentation
- 🎨 Frontend Architecture - React/TypeScript structure
- 🔧 Integration Guides - Library and tool integration
- 📊 System Status - Operational metrics and health
- 🧪 Testing Framework - Testing procedures and tools
- 📈 Performance Tuning - System optimization
- 🔍 Monitoring Setup - Monitoring and alerting
- 🎯 Production Roadmap - Strategic development plan
- 📅 Sprint Planning - Development sprints
- 📋 Project Governance - Development processes
- 📝 Release Notes - Latest updates
- 🤝 Contributing Guidelines - Development workflow
- 📖 Documentation Hub - Complete documentation index
- 🐛 Issue Reporting - Bug reports and feedback
- 💬 Community Discussions - Community support
|
|
Enterprise-Grade Security Operations Center Interface
| Dashboard Overview | Log Management | Security Management |
|---|---|---|
 |
 |
 |
| Network Monitoring | Anomaly Detection | System Configuration |
|---|---|---|
 |
 |
 |
Note: Screenshots demonstrate production-ready interface with enterprise security features. For complete visual documentation, see Screenshots Guide.
SecureNet Enterprise implements a robust 3-tier RBAC system with enterprise-grade user management:
| Role | Position | Responsibilities | Access Level |
|---|---|---|---|
| 🏢 Platform Owner | Chief Information Security Officer (CISO) | Strategic oversight, compliance management, global tenant administration | Full enterprise access, audit trails, financial reporting |
| 🛡️ Security Admin | Security Operations Manager | SOC management, user provisioning, security policy enforcement | Organization administration, user management, security controls |
| 🔍 SOC Analyst | Tier 1/2/3 Security Analyst | Threat monitoring, incident response, security event analysis | Dashboard access, alert management, reporting tools |
- Multi-Factor Authentication (MFA) - Required for all enterprise accounts
- Role-Based Permissions - Granular access control with principle of least privilege
- Session Management - Advanced session tracking and timeout controls
- Audit Logging - Comprehensive audit trails for all user activities
- Enterprise Email Integration - Corporate email domain validation
- Password Policies - Enterprise-grade password complexity requirements
🏢 Enterprise Deployment: Contact SecureNet Enterprise Support for LDAP/AD integration, SSO configuration, and custom role mappings.
Pierre Mvita - Founder, CEO & Chief Technology Officer
Founder Privileges:
- ✅ Complete Financial Control - All billing, revenue, subscription management
- ✅ Strategic Business Intelligence - Company-wide analytics, performance metrics
- ✅ God-Mode System Access - Complete database access, system configuration
- ✅ Multi-Tenant Management - Create, modify, delete any organization
- ✅ Emergency Override - Bypass all authentication for system recovery
- ✅ Compliance Authority - Override compliance settings for business requirements
📋 Documentation: Founder Access Guide - Complete founder access documentation
📋 Documentation: Founder Implementation Summary - Complete founder implementation documentation
- Python 3.8+ with pip
- Node.js 16+ with npm
- PostgreSQL 13+ (for enterprise features) or SQLite (development)
- Redis (for enhanced features)
- Git
git clone https://github.com/pmvita/securenet.git
cd SecureNet
# Create virtual environment
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# Install dependencies
# For development (SQLite):
pip install -r requirements.txt
# For enterprise (PostgreSQL + full features):
pip install -r requirements-enterprise.txt# Install PostgreSQL (macOS)
brew install postgresql
brew services start postgresql
# Install and setup PostgreSQL
brew install postgresql # macOS
sudo apt-get install postgresql # Ubuntu/Debian
brew services start postgresql # macOS
sudo systemctl start postgresql # Linux
# Create database and user
createdb securenet
createuser -s securenet
psql -c "ALTER USER securenet PASSWORD 'securenet';"
# Run migration to PostgreSQL
python scripts/migrate_to_postgresql.py# SQLite database will be created automatically at data/securenet.db
# No additional setup required# Official SecureNet Enterprise startup entrypoint
python start_enterprise.py # Full enterprise production startup
python start_enterprise.py --check # Validation only
python start_enterprise.py --validate-roles # Role validation
python start_enterprise.py --health-check # System health check
# Complete enterprise environment
./start_enterprise.sh # Full enterprise setup with security checks
# Complete production environment (legacy compatibility)
./start_production.sh # Full production setup with security checksSecureNet provides comprehensive production startup capabilities with enterprise-grade validation, health monitoring, and CI/CD integration for seamless deployment automation.
# Comprehensive enterprise production boot test
python scripts/ops/test_production_boot.py # Full test suite
python scripts/ops/test_production_boot.py --quick # Skip server startup
python scripts/ops/test_production_boot.py --enterprise-only # Enterprise tests only
# Expected output: ✅ ALL ENTERPRISE VALIDATION CHECKS PASSEDSecureNet includes comprehensive CI/CD validation pipelines with automated testing, deployment verification, and production readiness assessments for enterprise-grade continuous integration and deployment workflows.
# API health monitoring
curl http://localhost:8000/api/health # System health status
curl http://localhost:8000/api/system/status # Detailed system information
# Exit codes for CI/CD integration:
# 0 = All validations passed (production ready)
# 1 = Validation failures detected (deployment blocked)SecureNet provides comprehensive Health check endpoints for monitoring system status, component health, and production readiness validation with detailed metrics and status reporting for enterprise monitoring systems.
SecureNet supports enterprise deployment scenarios including on-premise installations, cloud deployments, hybrid architectures, and multi-tenant SaaS configurations with comprehensive security, compliance, and scalability features.
- 📚 Complete Setup: See Startup Guide for comprehensive deployment instructions
- 🏢 Enterprise Deployment: See Production Configuration for enterprise environment setup
- 🔧 Enhanced Features: See Enhanced Version Guide for advanced monitoring & ML capabilities
# New terminal window
cd frontend
npm install
# Build for production
npm run build
# Start production preview
npm run preview
# Alternative: Development mode with mock data
npm run dev# Access the application
# Frontend: http://localhost:5173
# Backend: http://localhost:8000# Deploy to AWS cloud infrastructure
cd terraform
./deploy.sh
# Access your production application
# Load Balancer: http://[your-load-balancer-url]
# Estimated cost: ~$90/month📖 Phase 2 Quick Start Guide 📚 Full Cloud Deployment Guide
- 🎯 Dashboard: http://localhost:5173
- 🔧 API: http://localhost:8000
- 📚 API Docs: http://localhost:8000/docs
- 📊 Enhanced Metrics: http://localhost:8000/system/health (enhanced version only)
Backend: FastAPI • PostgreSQL/SQLite • WebSockets • JWT Auth • Pydantic • Asyncio
Frontend: React 18 • TypeScript • Vite • Tailwind CSS • Heroicons • Axios
AI/ML: Custom algorithms • Scikit-learn • MLflow • Pattern recognition • Behavioral analytics
Enhanced: Redis • RQ • Sentry • Prometheus • Structured logging • Cryptography
Infrastructure: Docker • Kubernetes • Multi-tenant SaaS • Stripe billing • Real-time processing
- ✅ Role-Based Access Control — 3-tier security model (Platform Owner → Security Admin → SOC Analyst)
- ✅ CVE Integration — Real-time NIST NVD API with CISA KEV tracking
- ✅ SaaS Billing — Stripe integration with subscription management
- ✅ Audit Logging — Comprehensive activity tracking and compliance
- ✅ Predictive Analytics — AI-driven threat detection and risk assessment
- ✅ Multi-Tenant Architecture — Organization isolation and management
- ✅ Real-Time Monitoring — WebSocket alerts and live data streaming
- ✅ API-First Design — RESTful endpoints with comprehensive documentation
- ✅ Docker Support — Containerized deployment and scaling
- ✅ Security Hardening — JWT authentication, API keys, session management
SecureNet now offers two deployment options to meet different operational needs:
- ✅ Production-ready and battle-tested
- ✅ Full feature set with real-time monitoring
- ✅ Stable architecture for enterprise deployment
- ✅ Compatible with existing frontend and workflows
- ✅ All original features PLUS advanced capabilities
- 📊 Prometheus metrics and structured logging
- 🔍 Sentry error monitoring and distributed tracing
- 🤖 MLflow experiment tracking and model management
- ⚡ Redis task queues for background processing
- 🔐 Advanced cryptography and security services
Seamless Migration: Both versions use the same database and frontend - switch anytime!
- 🚀 Startup Guide - Complete setup instructions for both versions
- 🔧 Production Configuration - Environment setup template
- 🔒 Production Setup - Production mode configuration and security
- ⚡ Production Quick Reference - Fast production deployment commands
- Phase 1: Observability - Monitoring and logging
- Phase 2: Developer Experience - Testing and ML tools
- Phase 3: Advanced Tooling - Cryptography and task queues
- 🎨 Frontend Integration Hub - frontend enhancement roadmap
- ✅ 🚀 Phase 1: Immediate Enhancements - COMPLETE - Performance & reliability improvements
- ✅ 📊 Phase 2: UI & Visualization - COMPLETE - Advanced analytics & user experience
- ✅ 🏢 Phase 3: Enterprise Components - COMPLETE - Enterprise-grade development tools
docs/
├── 📖 README.md # Documentation hub and index
├── 🏆 certification/ # Official certification documents
├── 📋 audit/ # Audit reports and validation
├── 🚀 release/ # Release notes and summaries
├── 🏢 enterprise/ # Enterprise-specific documentation
├── 🗄️ migration/ # Database migration guides
├── 📦 setup/ # Installation and setup guides
├── 🏗️ architecture/ # System architecture documentation
├── 📡 api/ # API reference and guides
├── 🛡️ features/ # Feature documentation
├── 🔒 compliance/ # Security and compliance guides
├── 📊 system/ # System status and monitoring
├── 🧪 testing/ # Testing procedures and guides
├── 🤝 contributing/ # Contribution guidelines
├── 📋 project/ # Project management, governance, and launch planning
├── 📚 reference/ # Reference documentation and user management
└── 🔧 integration/ # Integration guides and tooling
💡 Tip: Start with the Documentation Hub for a complete overview of all available documentation.
SecureNet is organized into logical directories for better maintainability and development workflow:
SecureNet/
├── 🚀 src/ # Application source code
│ └── apps/ # Main application implementations
│ ├── app.py # Primary FastAPI application (119KB)
│ ├── enterprise_app.py # Enterprise-specific features (22KB)
│ ├── app_enhanced.py # Enhanced application features (13KB)
│ └── setup_enhanced.py # Advanced configuration management (15KB)
│
├── 📡 api/ # API layer organization
│ ├── endpoints/ # RESTful API endpoint implementations
│ │ ├── api_admin.py # Admin management endpoints (21KB)
│ │ ├── api_billing.py # Billing and subscription endpoints (10KB)
│ │ ├── api_insights.py # Analytics and insights endpoints (21KB)
│ │ ├── api_metrics.py # Performance metrics endpoints (14KB)
│ │ └── api_user_groups.py # User groups management endpoints (5KB)
│ ├── services/ # Business logic services
│ └── middleware/ # API middleware components
│
├── 🗃️ database/ # Database layer organization
│ ├── database.py # Main database implementation (213KB)
│ ├── database_postgresql.py # PostgreSQL-specific adapter (44KB)
│ ├── database_factory.py # Database factory pattern (2.8KB)
│ ├── models.py # Core data models (15KB)
│ ├── enterprise_models.py # Enterprise-specific models (20KB)
│ └── postgresql_adapter.py # PostgreSQL connection adapter (26KB)
│
├── 🔒 security/ # Security and scanning components
│ ├── cve_integration.py # CVE intelligence integration (27KB)
│ ├── network_scanner.py # Network device scanning (15KB)
│ └── secrets_management.py # Secrets and encryption management (18KB)
│
├── 🧪 tests/ # Testing framework
│ ├── unit/ # Unit tests
│ └── integration/ # Integration tests
│
├── 📊 reports/ # Generated reports and analytics
│ ├── validation/ # Sprint validation results
│ ├── performance/ # Performance testing results
│ ├── compliance/ # Compliance audit reports
│ └── security/ # Security assessment reports
│
├── 📜 scripts/ # Organized script management
│ ├── validation/ # Sprint validation and testing scripts
│ ├── migrations/ # Database migration scripts
│ ├── deployment/ # Production deployment scripts
│ ├── monitoring/ # System monitoring scripts
│ └── [implementation scripts] # Core feature implementation scripts
│
├── 🌐 frontend/ # React frontend application
│ ├── src/ # Frontend source code
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Application pages and routes
│ │ └── utils/ # Frontend utilities and helpers
│ └── public/ # Static assets and resources
│
├── 📚 docs/ # Comprehensive documentation
│ ├── api/ # API documentation
│ ├── deployment/ # Deployment guides
│ ├── security/ # Security documentation
│ └── [documentation categories] # Complete documentation structure
│
├── ⚙️ config/ # Configuration management
├── 📝 logs/ # Application logs
├── 🔐 auth/ # Authentication services
├── 🔍 monitoring/ # Monitoring and alerting
├── 🐳 k8s/ # Kubernetes deployment configs
├── 🐋 docker-compose.yml # Docker orchestration
├── 📦 requirements.txt # Python dependencies
└── 🚀 start_enterprise.py # Enterprise production startup
- 🔍 Easy Navigation: Logical organization makes finding files intuitive
- 🛠️ Maintainability: Clear separation of concerns reduces complexity
- 👥 Team Collaboration: Consistent structure improves developer productivity
- 📈 Scalability: Organized structure supports project growth
- 🔧 Development Workflow: Streamlined development and testing processes
graph TB
A[🌐 React Frontend] --> B[🔌 FastAPI Backend]
B --> C[🗄️ PostgreSQL/SQLite Database]
B --> D[🤖 AI/ML Engine]
B --> E[🔍 Network Scanner]
B --> F[🛡️ CVE Intelligence]
G[📡 WebSocket] --> A
H[🔔 Real-time Alerts] --> G
I[📊 Threat Analytics] --> D
J[🌍 NIST NVD API] --> F
K[🏢 Multi-tenant SaaS] --> B
Core Components:
- AI-Powered Backend: FastAPI with ML threat detection engine
- Intelligent Frontend: React 18 with TypeScript and real-time updates
- Security Engine: Custom vulnerability assessment and risk scoring
- Network Discovery: Cross-platform device scanning and classification
- SaaS Infrastructure: Multi-tenant architecture with billing integration
SecureNet supports multiple deployment environments to meet diverse organizational requirements:
- Air-gapped environments with complete offline operation
- Classified-ready deployment for government and defense contracts
- SCIF-compatible secure hosting for sensitive compartmented information
- Hardware security module (HSM) integration for cryptographic operations
- Amazon Web Services (AWS) - EC2, ECS, EKS deployment options
- Microsoft Azure - Container Instances, AKS, Virtual Machines
- Google Cloud Platform (GCP) - Compute Engine, GKE, Cloud Run
- Multi-cloud redundancy for high availability and disaster recovery
- Vercel Platform - Static frontend deployment for marketing and user acquisition
- Coming Soon Pages - Early access collection with email signup
- Independent Branch - Separate deployment from main platform
- 📚 Vercel Deployment Guide - Complete setup and branch management
- SOC/Compliance zone support with data residency controls
- Edge deployment for distributed security operations
- Private cloud integration with VMware vSphere, OpenStack
- Seamless data synchronization between on-premise and cloud components
- TS/SCI clearance environment compatibility
- TEMPEST-certified hardware deployment options
- Cross-domain solutions (CDS) integration capability
- FISMA High/Moderate authorization boundary support
| Component | Status | Description |
|---|---|---|
| 🤖 ML Threat Detection | ✅ Production | AI-powered anomaly detection and behavioral analysis |
| 🛡️ Security Intelligence | ✅ Production | CVE integration with NIST NVD and vulnerability scoring |
| 📊 Analytics Dashboard | ✅ Production | Real-time security metrics and threat visualization |
| 🔔 Notification System | ✅ Production | WebSocket alerts with smart categorization |
| 🔒 Enterprise Auth | ✅ Production | JWT + API key authentication with RBAC |
| 📱 Responsive UI | ✅ Production | Modern interface with mobile support |
| 📦 SaaS Infrastructure | ✅ Production | Multi-tenant architecture with billing |
| 📚 Documentation | ✅ Complete | Comprehensive guides and API reference |
We welcome contributions to SecureNet! Here's how to get started:
- 📖 Read: Review our Contributing Guidelines
- 🍴 Fork: Create your feature branch (
git checkout -b feature/ai-enhancement) - 🔨 Develop: Build and test with real network environment
- ✅ Test: Validate AI features and ML model performance
- 📝 Document: Update relevant documentation files
- 🚀 Submit: Push branch and open a Pull Request
See CONTRIBUTING.md for detailed development workflow and coding standards.
- 🚀 Setup Issues: Installation Guide • Quick Start
- 🔧 Configuration: Production Setup • Environment Config
- 🏢 Enterprise: User Management • Customer Onboarding
- 🛡️ Security: Security Features • Compliance
- 📡 API Help: API Reference • Integration Guides
- 📊 System Status: Operational Metrics • Performance Tuning
- Bug Reports: GitHub Issues
- Feature Requests: GitHub Discussions
- Security Issues: Email security@securenet.ai
- Documentation Issues: Documentation Hub
- Discussions: GitHub Discussions
- Development Updates: Production Roadmap • Sprint Planning
- Contributing: Contributing Guidelines • Development Workflow
- Release Notes: Latest Release • Changelog
Copyright (c) 2025 Pierre Mvita. All Rights Reserved.
This software is proprietary and confidential. See the LICENSE.txt file for complete terms and conditions.
🛡️ SecureNet — AI-Powered Network Security Monitoring & Management
Built for cybersecurity professionals, SOC teams, and enterprise security operations
Pierre Mvita • LinkedIn • SecureNet.ai
Transforming cybersecurity through artificial intelligence