{"id":27644735,"url":"https://github.com/sudo0xn14r/nexussync","last_synced_at":"2026-04-19T03:03:23.884Z","repository":{"id":288579610,"uuid":"968569202","full_name":"sudo0xn14r/NexusSync","owner":"sudo0xn14r","description":"NexusSync is a Flask-based Super Admin Portal for managing system configs, monitoring, and threat intelligence — built to be the foundation for any scalable web app.","archived":false,"fork":false,"pushed_at":"2025-04-18T12:46:58.000Z","size":40532,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-16T11:58:25.802Z","etag":null,"topics":["admin-dashboard","configuration-management","flask","flask-admin","flask-admin-template","infrastructure-monitoring","portal","security","superadmin","threat-intelligence","webapp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sudo0xn14r.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-18T10:15:22.000Z","updated_at":"2025-04-18T12:47:02.000Z","dependencies_parsed_at":"2025-04-19T00:27:22.263Z","dependency_job_id":null,"html_url":"https://github.com/sudo0xn14r/NexusSync","commit_stats":null,"previous_names":["sudo0xn14r/nexussync"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sudo0xn14r/NexusSync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo0xn14r%2FNexusSync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo0xn14r%2FNexusSync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo0xn14r%2FNexusSync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo0xn14r%2FNexusSync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudo0xn14r","download_url":"https://codeload.github.com/sudo0xn14r/NexusSync/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo0xn14r%2FNexusSync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31992822,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin-dashboard","configuration-management","flask","flask-admin","flask-admin-template","infrastructure-monitoring","portal","security","superadmin","threat-intelligence","webapp"],"created_at":"2025-04-24T00:58:38.660Z","updated_at":"2026-04-19T03:03:23.858Z","avatar_url":"https://github.com/sudo0xn14r.png","language":"Python","readme":"# NexusSync\n\nNexusSync is a powerful, secure, and modular Flask-based super admin portal designed to make managing infrastructure, monitoring system performance, and staying ahead of security threats much easier. It’s built with scalability and security at its core, giving super administrators all the tools they need to configure, monitor, and audit their systems with confidence.\nMore than just an admin panel, NexusSync is meant to be the starting point for any Flask web application. Whether you're working on a CRM, ERP, ecommerce platform, or any other enterprise-level project, NexusSync lays down a solid foundation you can build on — with the structure, flexibility, and features to grow as your application does.\n\n---\n\n## 🚀 Features\n\n- 🧩 **Core Functionalities**\n  - Centralized system configuration.\n  - Key x Value entries for a friendly setup.\n  - Necessary fallbacks. (Temporary until project completion).\n  - Change superadmin password.\n  - All actions are logged via a centralized logger.\n  - Audit log viewing, filtering, exporting, and wiping.\n\n- 🛢️ **Database Tools**\n  - Health check \u0026 diagnostics.\n  - Export and import database backups.\n  - Run custom SQL queries safely inside the web app.\n  - Basic and extended database configuration management.\n\n- 🌐 **IP Management**\n  - IP whitelist and blacklist configuration.\n  - Manual banning of IPs or ranges.\n  - Integration with Spamhaus DROP list.\n  - Integration with AbuseIPDB for risk scoring.\n\n- 🧠 **Threat Intelligence** (EXPERIMENTAL AT THIS STAGE)\n  - Early warning system with port scanning and honeypot correlation.\n  - Threat scoring from local + external sources.\n  - GeoIP and ASN analysis for context.\n  - Partially working advanced correlation engine (in progress).\n\n- 📊 **System Monitoring**\n  - Real-time CPU, memory, disk, and DB metrics.\n  - Historical monitoring with timeline graphing.\n  - Wipe metric history.\n  - Export metrics as PNG or CSV.\n  - Anomaly detection based on metrics (Coming Soon).\n\n- 📬 **Email \u0026 Notifications**\n  - Email server setup and test tool (Partially implemented).\n  - SMTP configuration UI.\n  - Editable email templates in the UI (Coming Soon).\n  - Email contacts lists and broadcast system (Coming Soon).\n\n- ⚙️ **System Configuration**\n  - Live-editable config values stored in the database.\n  - Startup Config Defaults.\n  - Add/edit environment variables from the admin UI (Partially implemented).\n  - \n- 🛡️ **Security \u0026 Logging**\n  - OWASP Secure Coding Practices (Planned).\n  - Role-based access control.\n  - CSP \u0026 HTTPS enforcement. (HTTPS is currently experimental)\n  - SIEM export in CEF, LEEF, JSON, and syslog formats (Under Development).\n\n---\n\n## 🖼️ Screenshots\n\n### 🏠 Landing Page\n![Landing Page](docs/screenshots/Screenshot%202025-04-18%20122452.png)\n\n### 🔐 Login Portal\n![Login Portal](docs/screenshots/Screenshot%202025-04-18%20122537.png)\n\n### 🧑‍💼 Super Admin Dashboard\n![Super Admin Dashboard](docs/screenshots/Screenshot%202025-04-18%20122625.png)\n\n### ⚙️ System Configuration\n![System Configuration](docs/screenshots/Screenshot%202025-04-18%20122700.png)\n\n### 🌐 IP \u0026 Threat Intelligence Management\n![IP \u0026 Threat Intelligence Management](docs/screenshots/Screenshot%202025-04-18%20122911.png)\n\n### 📈 Monitoring Dashboard\n![Monitoring Dashboard](docs/screenshots/Screenshot%202025-04-18%20122952.png)\n\n### 📝 Audit Logs\n![Audit Logs](docs/screenshots/Screenshot%202025-04-18%20123032.png)\n\n### ✉️ Email Configuration\n![Email Configuration](docs/screenshots/Screenshot%202025-04-18%20123103.png)\n\n## 🏗️ Project Structure\n\n```\nSuperAdminPortal/\n├── app/\n│   ├── __init__.py\n│   ├── extensions.py\n│   ├── blueprints/\n│   │   ├── main/\n│   │   │   ├── __init__.py\n│   │   │   └── views.py\n│   │   ├── filters/\n│   │   │   └── __init__.py\n│   ├── superadmin/\n│   │   ├── __init__.py\n│   │   ├── routes/\n│   │   │   ├── __init__.py\n│   │   │   ├── main.py\n│   │   │   ├── audit_logs.py\n│   │   │   ├── cli_config.py\n│   │   │   ├── config_keys.py\n│   │   │   ├── decorators.py\n│   │   │   ├── geoip.py\n│   │   │   ├── logger.py\n│   │   │   └── *.py\n│   │   ├── models/\n│   │   │   └── *.py\n│   │   ├── forms.py\n│   ├── core/\n│   │   ├── cookies.py\n│   │   ├── error_handlers.py\n│   │   ├── forms_shared.py\n│   │   ├── location.py\n│   │   ├── rate_limits.py\n│   │   ├── security.py\n│   ├── models/\n│   │   ├── __init__.py\n│   │   └── *.py\n│   ├── intelligence/\n│   │   ├── __init__.py\n│   │   ├── behavioral.py\n│   │   ├── blocklist.py\n│   │   ├── constants.py\n│   │   ├── correlation.py\n│   │   ├── geoip.py\n│   │   ├── scanning.py\n│   │   ├── siem.py\n│   │   ├── spamhaus.py\n│   ├── templates/\n│   │   ├── base.html\n│   │   ├── includes/\n│   │   │   └── alerts.html\n│   │   ├── errors/\n│   │   │   └── 404.html, 500.html, ...\n│   │   ├── main/\n│   │   │   └── index.html\n│   │   ├── superadmin/\n│   │       └── *.html\n│   ├── static/\n│   │   ├── css/\n│   │   │   └── style.css\n│   │   ├── js/\n│   │       └── script.js\n├── static/\n│   ├── css/\n│   └── js/\n├── instance/\n│   ├── app.db\n│   ├── GeoLite2-*.mmdb\n│   └── superadmin_audit.log\n├── requirements.txt\n├── README.md\n├── main.py\n└── project_tree.py\n```\n---\n\n⚙️ Setup\n✅ Prerequisites\n\nMake sure you have the following installed:\n\n    Python 3.10+\n\n    pip\n\n    git\n\n    A terminal or command prompt\n    \n### Installation\n\n🪟 Windows Installation\n\n# Clone the repository\ngit clone https://github.com/sudo0xn14r/NexusSync.git\ncd NexusSync\n\n# Create a virtual environment\npython -m venv venv\n\n# Activate the environment\nvenv\\Scripts\\activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run the app\npython main.py\n\n🐧 Linux/macOS Installation\n\n# Clone the repository\ngit clone https://github.com/sudo0xn14r/NexusSync.git\ncd NexusSync\n\n# Create a virtual environment\npython3 -m venv venv\n\n# Activate the environment\nsource venv/bin/activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run the app\npython3 main.py\n---\n\n🔐 Configuration\n🔑 Default Credentials\n\nYou can log in using the built-in superadmin account:\n\n    Username: superadmin\n\n    Password: iamthesuperadmin123!\n\n🔧 Optional .env File\n\nYou can also create a .env file for easier configuration:\n\nSECRET_KEY=your-secret-key\nFLASK_ENV=development\nSQLALCHEMY_DATABASE_URI=sqlite:///instance/app.db\nABUSEIPDB_API_KEY=your-api-key\n\nAlternatively, all of this can be configured directly from the SuperAdmin dashboard.\n\n---\n\n## 🔗 Application Entry Points\n\n- **Main Landing Page:** [http://127.0.0.1:5000/](http://127.0.0.1:5000/)\n- **Superadmin Login:** [http://127.0.0.1:5000/superadmin/login](http://127.0.0.1:5000/superadmin/login)\n- **Superadmin Dashboard:** [http://127.0.0.1:5000/superadmin/dashboard](http://127.0.0.1:5000/superadmin/dashboard)\n\n---\n\n## 🧭 Roadmap\n\n### 🚧 In Progress\n- Enhance in-app database CLI capabilities for executing and managing SQL operations with improved usability and safety\n- Extend email functionality with editable templates:\n  - User registration confirmation\n  - Two-factor authentication prompts\n  - Critical system notifications\n- Add startup and periodic health checks for system diagnostics\n- Introduce privacy tooling to manage and audit personally identifiable information (PIIs)\n- Enhance the Threat Intelligence Hub and correlation engine\n\n### 🗓️ Planned\n- Integration of Redis for request rate limiting and abuse protection\n- Expand database management to support multiple DB instances (local/cloud):\n  - View, modify, and alter external databases\n- Implement full data retention policies for logs and metrics\n- Enhance security configuration section to align with OWASP's latest web application security recommendations\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudo0xn14r%2Fnexussync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudo0xn14r%2Fnexussync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudo0xn14r%2Fnexussync/lists"}