ShadowSec-Toolkit-Core - Modular security toolkit core for auditing, harden

项目说明

🛡️ ShadowSec Toolkit • Core ©

!OS Compatibility !Android !Python !Architecture !Security !Stability !Use Case !License

Framework Modular de Cibersegurança, para Auditoria, Hardening e Monitoramento local, com foco em arquitetura sólida, extensibilidade e operação controlada.

Autor: Luciano Valadão (Lukk)
Projeto: ShadowSec Offensive & Defensi

Documentação de arquitetura:

docs/ARCHITECTURE.md

Visão Geral

O ShadowSec e de um conjunto de scripts isolados para um framework orientado a módulos (plugin-based), capaz de carregar dinamicamente funcionalidades de segurança sem acoplamento ao núcleo da aplicação.

O projeto foi concebido para:

Analistas de cibersegurança

Profissionais de TI

Administradores de sistemas

Ambientes corporativos ou pessoais

Cenários offline ou restritos

Nenhuma funcionalidade é executada sem contexto explícito.

⚠️ Status do Projeto

O ShadowSec Toolkit encontra-se atualmente em processo de adaptação para este novo Core modular.
Os módulos existentes estão sendo migrados e padronizados gradualmente, respeitando os princípios arquiteturais definidos.

Neste momento, os módulos já adaptados e funcionais são:

Firewall (Audit / Apply – UFW)

Web (Auditorias HTTP específicas)

Objetivos do Core

Padronizar execução e retorno de módulos

Garantir pre e segurança estrutural

Facilitar expansão (CLI, GUI, Mobile, API)

Servir como base profissional para ferramentas ShadowSec

Separar orquestração de lógica de segurança

Princípios Arquiteturais

🔹 Arquitetura orientada a plugins

🔹 Módulos independentes e autocontidos

🔹 Core sem lógica de segurança

🔹 Resultados padronizados (ModuleResult)

🔹 Logs estruturados em JSON (auditáveis / SIEM-ready)

🔹 Nenhuma importação manual de módulos

Estrutura do Projeto

⚙️ Instalação

1️⃣ Clonar o repositório

2️⃣ Criar ambiente

Uso

Execução principal

O Core:

Detecta módulos automaticamente

Filtra por ModuleScope

Exibe menu dinâmico

Executa módulos de forma isolada

Sistema de Módulos

Tipos de módulos

Audit: apenas leitura / ção

Apply: aplicação de mudanças (hardening)

Híbridos (planejado): audit + apply

Módulos atualmente adaptados ao Core

Firewall Hardening (UFW)

Firewall Audit (UFW)

Slow HTTP Audit (RUDY-like)

Cada módulo:

herda de BaseModule

declara name e scope

retorna sempre ModuleResult

gera seus próprios logs

Logs e Auditoria

Logs em formato JSON estruturado

Arquivo único de auditoria

Cada evento possui:

e único

contexto do host

usuário executor

dados do módulo

Pronto para:

SIEM

correlação futura

relatórios automatizados

📚 Documentação

ARCHITECTURE.md — arquitetura e diretrizes

SECURITY_TARGET.md — objetivos de segurança

THREAT_MODEL.md — modelo de ameaças

docs/modules/ — documentação específica de cada módulo

🔐 Segurança e Boas Práticas

Execução mínima como root

Elevação de privilégio apenas quando necessária

Auditorias passivas por padrão

Configurações revertíveis

Compatível com ambientes offline

🧭 Roadmap

Submenus por categoria (Firewall, Web, System)

Relatórios estruturados (HTML / JSON)

Integração futura com CVEs (NVD / )

Interface gráfica (Flutter como frontend)

Execução remota controlada

ShadowSec Cloud Scanner (pesquisa)

🤝 Contribuindo

Fork do projeto

Crie uma branch

Siga as diretrizes arquiteturais

Envie um Pull Request bem documentado

Se quebrar a arquitetura, o PR será recusado.

📜 Licença

Distribuído sob licença MIT.

Uso, modificação e redistribuição são permitidos, desde que mantidos os créditos.

📧 Contato:

🛡️ ShadowSec Toolkit ©

Autor: Luciano Valadão

19/12/2025

项目信息

开发语言：Python

Star 数：1

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Modular security toolkit core for auditing, hardening, and defensive automation with structured JSON logging.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。