Uso

Iniciar Catsplash

Una vez instalado, inicia el portal cautivo:

sudo ./bin/catsplash

O si está instalado como servicio systemd:

sudo systemctl start catsplash

Por defecto escucha en el puerto 8080. Los clientes que se conecten al WiFi serán redirigidos automáticamente al portal.

catsctl: CLI de control

catsctl es la herramienta de línea de comandos para gestionar Catsplash.

Ver estado del sistema

sudo catsctl status

Muestra las interfaces activas, puerto del portal, número de sesiones activas/pendientes y tráfico total.

Listar clientes

sudo catsctl list

Tabla con estado, MAC, IP, tiempo de conexión, datos usados, límites y ancho de banda de cada cliente.

Autorizar manualmente

sudo catsctl auth aa:bb:cc:dd:ee:ff 192.168.10.50

Desconectar cliente

sudo catsctl kick aa:bb:cc:dd:ee:ff

Extender sesión

sudo catsctl extend aa:bb:cc:dd:ee:ff 30

Extiende la sesión en 30 minutos.

Establecer límite de datos

sudo catsctl limit aa:bb:cc:dd:ee:ff 500

Límite de 500 MB. Usa 0 para eliminar el límite.

Establecer ancho de banda

sudo catsctl band aa:bb:cc:dd:ee:ff 5mbit 2mbit

Límite de descarga 5 Mbps y subida 2 Mbps. Usa 0 para eliminar el límite.

Panel de administración web

Catsplash incluye un panel de administración en:

http://<gateway_ip>:8080/admin

Credenciales por defecto: admin / catsplash.

Características del panel:

• Autenticación con contraseña hasheada (bcrypt).
• Protección CSRF en todos los formularios.
• Vista de clientes activos con estado, MAC enmascarada, IP y tiempos.
• Control de cuota de datos y ancho de banda por cliente.
• Logs de auditoría de accesos y eliminaciones de datos.

Derechos ARCO+ (LOPDP)

Catsplash cumple con la Ley Orgánica de Protección de Datos Personales del Ecuador:

• Política de privacidad: Disponible en /privacy desde el portal.
• Solicitud de datos: Los usuarios pueden solicitar sus datos en /data-request.
• Eliminación de datos: Los usuarios pueden solicitar la eliminación de sus datos en /data-deletion.
• Identidad por cookie: La identidad del solicitante se resuelve desde cookie de sesión, nunca desde parámetros URL.

Monitoreo de tráfico

Catsplash monitorea el tráfico de cada cliente autenticado cada 10 segundos usando contadores de iptables. Si un cliente excede su cuota de datos, la sesión se cierra automáticamente.