cs-abuseipdb-bouncer
Bouncer en Go para CrowdSec que reporta IPs bloqueadas a AbuseIPDB en tiempo real. Usa persistencia ACID con bbolt, métricas Prometheus y contenedores distroless seguros. Soporta mapeo de escenarios y control de cuotas diarias.
Ficha actualizada 23 sept 2026, 23:18 · upstream 23 sept 2026, 22:56 · release v2.4.0
Qué es cs-abuseipdb-bouncer
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto es un componente de salida diseñado para integrarse con la API Local (LAPI) de CrowdSec. Su función principal es consumir decisiones de bloqueo y reportarlas automáticamente a la base de datos de inteligencia de amenazas de AbuseIPDB. Está implementado en Go como un binario estático único, ejecutándose dentro de contenedores distroless sin shell ni privilegios de root, lo que garantiza una superficie de ataque mínima. La arquitectura utiliza una cola de trabajo concurrente para manejar picos de tráfico y evita bloquear el bucle principal del evento.
La persistencia del estado se gestiona mediante bbolt, asegurando operaciones ACID para la gestión de cuotas diarias y ventanas de enfriamiento por IP, sobreviviendo a reinicios del contenedor. El sistema incluye endpoints de salud independientes que no consumen cuota API y un logger estructurado compatible con SIEMs como Loki o Splunk. Además, implementa políticas de seguridad estrictas mediante perfiles seccomp personalizados y redacción automática de claves sensibles en los registros.
- Integración directa con la API Local de CrowdSec para automatizar reportes
- Cumplimiento de políticas de inteligencia de amenazas externas sin intervención manual
- Monitoreo y control estricto del consumo de cuota diaria de AbuseIPDB
- Despliegue seguro en entornos Kubernetes o Docker con hardening de contenedores
- Gestión de ventanas de enfriamiento para evitar saturación de la API destino
- Binario estático Go compilado para múltiples arquitecturas (multi-arch)
- Persistencia ACID mediante bbolt para integridad de datos y cuotas
- Seguridad hardening con contenedor distroless, seccomp y ejecución sin root
- Pool de trabajadores concurrentes para alto rendimiento en reportes masivos
- Endpoints de salud independientes que no consumen cuota API
- Mapeo inteligente de escenarios a categorías de AbuseIPDB (22 de 23)
- No implementa enforcement directo ni redirección de tráfico, solo reporting
- La categoría DNS Poisoning no se reporta actualmente por falta de patrones de escenario
- Requiere una instancia de CrowdSec con LAPI accesible y configurada previamente
- Dependencia externa de la cuota diaria gratuita (1000 reportes) o planes de pago
- No incluye lógica de AppSec ni generación de CAPTCHA o HTML de remediación
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Configurar volumen persistente para /data/state.db para mantener cuotas y cooldowns. Establecer variables de entorno CROWDSEC_LAPI_KEY y ABUSEIPDB_API_KEY. Monitorear métricas Prometheus en puerto 9090 para verificar consumo de cuota (limit, used_today). Asegurar permisos correctos en el volumen de datos para evitar errores de inicio.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.