initial commit

Signed-off-by: ale <ale@manalejandro.com>
Este commit está contenido en:
ale
2025-09-20 19:00:44 +02:00
commit c8e3ccb07f
Se han modificado 14 ficheros con 1173 adiciones y 0 borrados

91
CHANGELOG.md Archivo normal
Ver fichero

@@ -0,0 +1,91 @@
# Changelog
Todos los cambios notables de este proyecto serán documentados en este archivo.
El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [1.0.0] - 2025-09-20
### Agregado
- Panel de administración web completo para CSF
- Autenticación segura con JWT
- Dashboard en tiempo real con WebSockets
- Gestión completa de reglas de firewall (allow/deny/temporal)
- Visualización de logs del sistema y firewall
- Estadísticas del servidor en tiempo real
- Dockerfiles para CSF y aplicación web
- Docker Compose para orquestación
- Script de despliegue automatizado
- API REST completa para interactuar con CSF
- Interfaz responsive con Tailwind CSS
- Sistema de notificaciones y alertas
- Monitoreo de conexiones activas
- Backup y restauración de configuraciones
### Características Principales
- **Framework**: Next.js 15 con App Router
- **UI**: React 19 + Tailwind CSS
- **Backend**: API Routes con Node.js
- **Base de Datos**: Archivos de configuración CSF nativos
- **Tiempo Real**: Socket.IO para actualizaciones en vivo
- **Autenticación**: JWT con cookies httpOnly
- **Containerización**: Docker + Docker Compose
- **Monitoreo**: Logs, métricas y estadísticas del sistema
### Seguridad
- Autenticación por defecto (admin/admin123)
- Headers de seguridad configurados
- Validación de entrada en todas las APIs
- Acceso restringido a comandos del sistema
- Logs de auditoría completos
### Docker
- Contenedor CSF optimizado para producción
- Contenedor web con Next.js standalone
- Networking seguro entre contenedores
- Volúmenes persistentes para configuraciones
- Healthchecks para ambos servicios
### APIs Implementadas
- `/api/auth` - Autenticación de usuarios
- `/api/csf` - Control del firewall CSF
- `/api/rules` - Gestión de reglas
- `/api/logs` - Acceso a logs del sistema
- `/api/stats` - Estadísticas del servidor
- `/api/config` - Configuración de CSF
- `/api/socket` - WebSocket para tiempo real
### Componentes UI
- Dashboard principal con navegación por pestañas
- Tarjeta de estado del firewall con controles
- Tabla de reglas con búsqueda y filtros
- Visor de logs con expansión de detalles
- Gráficos de estadísticas del sistema
- Formularios de login y gestión de reglas
- Indicadores de conexión en tiempo real
### Notas de Seguridad
⚠️ **IMPORTANTE**:
- Cambiar credenciales por defecto antes de usar en producción
- Configurar HTTPS para acceso externo
- Revisar configuraciones de firewall antes del despliegue
- Hacer backup de configuraciones existentes
### Instalación
```bash
# Clonar proyecto
git clone [repository-url]
cd csf-web-admin
# Configurar entorno
cp .env.example .env
# Desplegar
./deploy.sh
```
### Acceso
- URL: http://localhost:3000
- Usuario: admin
- Contraseña: admin123