IRCv3
xBNC negocia con cada servidor las capacidades que ofrece y le interesan, y ofrece a cada cliente las suyas. A cada cliente solo le llega lo que ha pedido: un cliente clásico recibe los mensajes de siempre (por ejemplo, el JOIN corto y solo el rango más alto en la lista de usuarios).
Con los servidores
| Capacidad | Para qué |
|---|---|
server-time | Hora real de cada mensaje. |
message-tags | Etiquetas en los mensajes. |
multi-prefix | Todos los rangos de un usuario (@+), no solo el más alto. |
extended-join | Las entradas llevan la cuenta y el nombre real. |
away-notify | Avisos cuando alguien se marca como ausente o vuelve. |
account-notify | Avisos cuando alguien se identifica o deja de estarlo. |
account-tag | Cada mensaje indica la cuenta de quien lo envía. |
chghost | Cambios de usuario o host sin salir y entrar. |
userhost-in-names | La lista de usuarios con nick!usuario@host. |
invite-notify | Invitaciones a otras personas en tus canales. |
setname | Cambios de nombre real. |
cap-notify | El servidor añade o quita capacidades en caliente. |
sasl | Identificación SASL (PLAIN y EXTERNAL hacia el servidor; PLAIN desde los clientes). |
Con los clientes
| Capacidad | Para qué |
|---|---|
server-time | Hora real de cada mensaje. |
message-tags | Etiquetas en los mensajes. |
echo-message | Tus propios mensajes vuelven confirmados por el servidor. |
batch | Grupos de mensajes (historial, reproducción). |
sasl | Identificación SASL (PLAIN y EXTERNAL hacia el servidor; PLAIN desde los clientes). |
draft/chathistory | El cliente pide el historial que necesita (CHATHISTORY). |
draft/event-playback | El historial incluye entradas, salidas, kicks y cambios de nick como eventos reales. |
draft/read-marker | Marcadores de lectura compartidos entre dispositivos. |
soju.im/bouncer-networks | Todas tus redes en una sola conexión. |
soju.im/bouncer-networks-notify | Avisos de cambios en tus redes. |
extended-join | Las entradas llevan la cuenta y el nombre real. |
away-notify | Avisos cuando alguien se marca como ausente o vuelve. |
account-notify | Avisos cuando alguien se identifica o deja de estarlo. |
account-tag | Cada mensaje indica la cuenta de quien lo envía. |
chghost | Cambios de usuario o host sin salir y entrar. |
multi-prefix | Todos los rangos de un usuario (@+), no solo el más alto. |
userhost-in-names | La lista de usuarios con nick!usuario@host. |
invite-notify | Invitaciones a otras personas en tus canales. |
setname | Cambios de nombre real. |
cap-notify | El servidor añade o quita capacidades en caliente. |
Con CAP LS 302 se anuncia sasl=PLAIN. Si el servidor no admite una capacidad que pide un cliente, xBNC la ofrece igual cuando puede construirla él (por ejemplo, el JOIN extendido con los datos que conoce). El informe para pruebas recoge, por red, lo que ofrece el servidor (caps_offered), lo que xBNC activó (caps_acked) y lo que pidió cada cliente.
Informe para pruebas
En Tu cuenta → Informe para pruebas → Descargar informe (o GET /api/v1/diagnostics) se descarga un JSON con lo que hace falta para diagnosticar un problema con una red, sin contraseñas, mensajes, nicks de otras personas ni IPs de tus dispositivos.
| Campo | Contenido |
|---|---|
report, format | xbnc-diagnostics, versión 1 del formato. |
version, brand | Versión de xBNC y «xBNC v1.0.0 - https://xbnc.org». |
os, arch, database | Sistema, arquitectura y base de datos (sqlite o postgresql). |
started_at, generated_at | Cuándo arrancó xBNC y cuándo se generó el informe. |
timezone, language | Tu zona horaria e idioma. |
counters | Contadores del servidor (tráfico, mensajes, reconexiones, logins). |
networks[] | Por red: name, host, port, tls, enabled, si tiene SASL o contraseña de servidor, saved_channels, modules y plugins activos, y live. |
networks[].live | state, server, network_name, connected_since, last_error, caps_offered, caps_acked, isupport, services_logged_in, host_hidden, channels_joined y clients (dispositivo y capacidades de cada uno). |
Arquitectura
xBNC es un único programa (xbncd) con el panel incluido. El código se divide en crates/xbnc-proto (protocolo IRC sin E/S: parser y serializador con etiquetas IRCv3, prefijos, casemapping, ISUPPORT y CTCP) y crates/xbncd (servicio, CLI, API y panel), más los SDK de plugins en sdk/, el panel (React y TypeScript) en web/ y las traducciones en locales/.
Cómo trabaja por dentro
- Cada red de cada usuario es una tarea independiente que posee en exclusiva su conexión con el servidor, el estado de la red y la lista de clientes. Nadie más toca ese estado: no hay bloqueos en el camino de los mensajes.
- Cada cliente es una tarea de lectura y otra de escritura, con una cola acotada. Si un cliente no lee, se le desconecta en vez de acumular memoria; al volver recupera lo pendiente.
- El panel, la API y la terminal nunca tocan las conexiones IRC: escriben en la base de datos y envían órdenes a las tareas de red (estado, control, entrar, salir, recargar, desconectar un cliente, alerta, aviso a todos).
- Todo acceso a la base de datos va por un grupo de hilos aparte. Los mensajes de todas las redes pasan por un único hilo escritor que guarda en una sola transacción todo lo que espera (hasta 512), conservando el orden de cada red.
- Los módulos son código del propio programa, llamados en puntos concretos (línea del servidor, comando de un cliente, temporizador, conexión, cliente que entra o sale). Los plugins reciben los eventos desde la tarea de red y se ejecutan en el grupo de hilos bloqueante.
- Al llegar un mensaje: se interpreta, se actualiza el estado (nick, canales, miembros, modos, tema), se guarda con la hora del servidor y un identificador, y se envía a cada cliente adaptado a sus capacidades.
- Los textos se buscan por clave en los idiomas cargados (los incluidos y los ficheros de
locales_dir), con el inglés como respaldo.
Módulos del código
| Módulo (crates/xbncd/src) | Qué hace |
|---|---|
main.rs | El comando xbncd: el servicio y la línea de comandos (usuarios, redes, copias, importación, idiomas, versiones, actualizaciones). |
config | Lectura y validación de xbnc.toml. |
db, sql | Almacenamiento: migraciones versionadas, usuarios, redes, canales, mensajes, cursores, auditoría y copias; sql da a SQLite (rusqlite) y a PostgreSQL la misma interfaz. |
crypto | Argon2id, cifrado XChaCha20-Poly1305 de las credenciales guardadas y un tipo Secret que nunca se imprime. |
auth | El formato de login, la comprobación de contraseñas, el limitador de fuerza bruta y el enmascarado de líneas en los logs. |
util | Codec de líneas IRC (límite de longitud, UTF-8 con pérdida, protección contra inyección de CR/LF) y funciones de tiempo. |
network/ | La tarea de cada red de cada usuario: conexión con el servidor IRC, estado, historial y clientes vinculados. mods.rs y extra.rs tienen el comportamiento de los módulos, status.rs y status_more.rs los comandos *status, *notes y *watch, plugins.rs entrega los eventos a los plugins, dcc.rs decide qué ofertas DCC pasan por xBNC y readmark.rs guarda las marcas de lectura. |
downstream, bouncer, events | Conexiones de clientes: registro, CAP, SASL, PASS y reenvío a la tarea de la red; soju.im/bouncer-networks; avisos a los clientes cuando cambia una red. |
modules | Catálogo de módulos, esquema y validación de sus ajustes y configuración tipada por red. |
perform | Convierte comandos al estilo del cliente (/msg, /mode…) en IRC, para los comandos al conectar, los alias y las tareas programadas. |
logs | Registros en ficheros, escritos en un hilo aparte. |
certs | Certificados de cliente (generación, validación y huellas) y certificados de servidor de confianza. |
fish | Cifrado FiSH: Blowfish ECB y CBC y el intercambio de claves DH1080. |
i18n | Idiomas: inglés y español incluidos y los ficheros de locales_dir. |
netinfo | Direcciones de la red local y la dirección que se muestra para 0.0.0.0. |
server, ha | Contexto compartido, registro de tareas de red, puertos TLS, mantenimiento y recarga; alta disponibilidad activo/en espera con PostgreSQL. |
rbac, settings | Los cinco roles y sus permisos; ajustes de historial y límites editables en caliente (base de datos sobre xbnc.toml). |
totp, webauthn, sso | Verificación en dos pasos (RFC 6238), passkeys, OpenID Connect y LDAP. |
tz | Zonas horarias con horario de verano, con la base de datos incluida. |
metrics, alerts | Contadores de tráfico y mensajes, memoria y CPU del proceso; reglas de alerta comprobadas cada 30 s, con avisos en el panel, por IRC y por webhook. |
notify, push | Avisos por Telegram, Discord, correo, una dirección web propia y Web Push. |
plugins, plugin_dev, catalog | Plugins WebAssembly: manifiesto, validación, motor Wasmi con límites, instancias y acciones; modo desarrollo; el catálogo incluido y el remoto firmado. |
dcc | Lectura y reescritura de ofertas DCC y los túneles de un solo uso. |
http | Cliente HTTP/1.1 mínimo (TLS verificado, tamaño y tiempo acotados) para webhooks, avisos, plugins con acceso web y la comprobación de versiones. |
updates, release | Aviso de versiones nuevas, descarga y comprobación de paquetes, el ayudante xbncd apply-update y las firmas Ed25519. |
backup | Copias de seguridad desde el panel y su restauración. |
import | Migración desde otro bouncer: lectura de su configuración, datos de módulos, plan, aplicación en una transacción e importación de registros. |
web/ | Servidor HTTP (axum): API /api/v1, WebSocket, sesiones, CSRF, cabeceras y los ficheros del panel incluidos en el binario. |
El panel (web/) es una aplicación React y TypeScript compilada con Vite. web/dist se incluye en el binario, así que xBNC sigue siendo un único fichero. Los plugins oficiales también van dentro del binario (crates/xbncd/catalog/).
Máquinas de estado
Se mantienen separadas:
- Conexión con la red:
Disconnected → Registering → Connected. Durante el registro, xBNC negocia las capacidades IRCv3, SASL y el nick (con alternativa si está ocupado). Tiempos: 30 s para conectar, 60 s para registrarse, PING tras 90 s de silencio y desconexión a los 180 s. Reconexión con esperas crecientes de 5 s a 5 minutos con una variación aleatoria de ±20 %, y al menos 2 minutos tras un aviso de throttling. Si un servidor falla y la red tiene servidores de reserva, se prueba el siguiente al cabo de 1 segundo. - Sesión de cliente: registro (
CAP,PASSo SASL,NICK,USER) con tiempo límite, y después una sesión vinculada a una red. - Usuario y bouncer: qué tareas de red existen y cuántos clientes tiene cada usuario.
El camino de un mensaje
- La tarea de la red lee una línea del servidor y la analiza.
- Actualiza el estado (nick, canales, miembros, modos, tema).
- Si es un PRIVMSG, NOTICE o ACTION de alguien (o un evento, con el módulo Eventos), lo guarda en
messagescon la hora del servidor (server-time) o la local, y le da el identificadormsgid = x<id>. - Lo envía a cada cliente vinculado adaptado a sus capacidades (quitando las tags que el cliente no pidió) y avanza el cursor de cada cliente.
Lo que envía un cliente va al servidor, se guarda como saliente y se reenvía al resto de clientes del usuario (y al propio emisor si pidió echo-message).
Historial sin duplicados
- Cada dispositivo (
@dispositivoen el login,defaultsi no se indica) tiene un cursor por red enclient_cursors: el identificador del último mensaje entregado. - Al conectar, recibe los mensajes posteriores a su cursor (hasta
playback_max, 1.000 por defecto). Un dispositivo nuevo recibe losnew_client_playbackmás recientes (100 por defecto). - Los cursores se guardan al desconectar el dispositivo y cada 5 segundos; nunca retroceden.
- Los clientes con
draft/chathistoryno reciben reproducción automática: piden lo que necesitan conCHATHISTORY. Los mensajes ya leídos en otro dispositivo (draft/read-marker) no se vuelven a reproducir.
Esquema de la base de datos
| Tabla | Contenido | Desde la migración |
|---|---|---|
users | Usuario, hash Argon2id, rol, límites y cuotas, secreto TOTP cifrado, idioma, zona horaria, dirección de salida, último acceso y última conexión. | 1 (2, 4, 8, 9, 10) |
networks | Servidor, puerto, TLS, nick, SASL, comandos al conectar, certificado de cliente, servidores de reserva y certificados de confianza; contraseñas y claves cifradas. | 1 (3, 4, 10) |
channels | Canales guardados por red, con clave cifrada, retención, desactivado y posición. | 1 (8, 10) |
messages | Historial: red, conversación, hora, emisor, comando, texto, saliente y mención. | 1 (8) |
client_cursors | Último mensaje entregado por red y dispositivo. | 1 |
audit_log | Acciones administrativas. | 1 |
web_sessions | Sesiones del panel (hash del token, CSRF, IP, navegador, caducidad). | 2 |
settings | Ajustes cambiados desde el panel. | 2 |
login_events | Intentos de acceso por IRC y en el panel (10.000 como máximo). | 2 |
module_config | Módulos por red: activo y ajustes en JSON validado. | 4 |
notes | Notas de cada usuario. | 4 |
messages_fts | Índice de texto completo de messages.text, mantenido con triggers (SQLite; PostgreSQL usa su propia búsqueda de texto). | 5 |
api_tokens | Tokens de API: hash SHA-256, prefijo, alcance, caducidad, último uso e IP. | 6 |
plugins | Plugins instalados: manifiesto, SHA-256, tamaño, activo en el servidor, dominios web aprobados y el propio módulo. | 7 (8) |
plugin_config | Plugins por red: activo, ajustes y estado guardado. | 7 |
plugin_kv | Almacén clave-valor de cada plugin por red. | 8 |
notify_settings | Ajustes de avisos de cada usuario. | 8 |
push_subscriptions | Suscripciones Web Push de los navegadores de cada usuario. | 8 |
read_markers | Último mensaje leído de cada conversación. | 8 |
passkeys | Passkeys: credencial, clave pública, contador, nombre y último uso. | 8 |
user_identities | Identidades externas (OpenID Connect, LDAP) vinculadas a usuarios locales. | 8 |
PostgreSQL tiene el mismo esquema; se admite desde la versión 8 del esquema (PG_MIGRATIONS) y cada migración nueva se añade a las dos listas. Los eventos de canal (JOIN, PART…) se guardan en messages con su comando. Las contraseñas importadas de otro bouncer con SHA-256 se guardan como legacy-sha256$<hash>$<sal> hasta el primer acceso correcto, en el que se sustituyen por Argon2id. Las migraciones se aplican al arrancar dentro de una transacción, y un binario se niega a abrir un esquema más nuevo del que conoce.
Modelo de amenazas
Qué protege xBNC, de quién y con qué medida en cada punto. Es la guía para la auditoría externa y para revisar cada cambio.
Qué se protege
| Activo | Por qué importa |
|---|---|
| Contraseñas de las cuentas de xBNC | Dan acceso a las redes, al historial y, a los administradores, al servidor entero. |
| Credenciales de red (SASL, contraseña de servidor, claves de canal, comandos al conectar, contraseñas de servicios, claves FiSH, certificados) | Permiten suplantar al usuario en las redes. |
| Historial y registros | Privados y canales: información personal. |
| Sesiones del panel y tokens de API | Equivalen a la contraseña mientras son válidos. |
| La clave secreta (secret.key) | Descifra todas las credenciales guardadas. |
| La disponibilidad del servicio | Si cae, los usuarios pierden mensajes y presencia. |
| La reputación de la IP del servidor | Todas las conexiones salen de ella. |
Quién puede atacar
| Actor | Qué controla | Qué intenta |
|---|---|---|
| Cualquiera en internet | Conexiones a los puertos de IRC, panel y DCC | Adivinar contraseñas, agotar recursos, explotar el parser. |
| Alguien en una red IRC | Mensajes, CTCP, DCC, nombres de canal y nick | Inyectar comandos, que xBNC se conecte a redes internas, saturar el historial. |
| Un servidor IRC malicioso | Todo lo que llega por la conexión de una red | Lo anterior, más respuestas malformadas, líneas enormes y desconexiones en bucle. |
| Un usuario de xBNC | Su cuenta, sus redes, módulos y plugins | Leer datos de otros, escalar a administrador, abusar del servidor. |
| Un administrador | Usuarios y redes de otros | Escalar a superadministrador, cambiar ajustes globales. |
| El autor de un plugin | El código que instala un superadministrador | Salir del aislamiento, leer datos, actuar sin permiso. |
| El autor de un fichero de idioma | Un fichero que un administrador copia en locales_dir | Meter comandos IRC o HTML con los textos (se rechaza: se validan y se tratan como texto plano). |
| Una web maliciosa | El navegador de un usuario con sesión | CSRF, robo de sesión, secuestro del WebSocket. |
| Quien accede a las copias de seguridad | Los .tar.gz | Credenciales y conversaciones. |
Fuera de alcance: quien ya es root en la máquina, el proveedor del servidor y los fallos del sistema operativo o de las redes IRC.
Conexiones de clientes IRC (6697/6667)
| Amenaza | Medida |
|---|---|
| Fuerza bruta de contraseñas | Bloqueo por IP compartido con el panel y los tokens; Argon2id; mismo coste para usuarios inexistentes. |
| Agotar conexiones o memoria | Límite global de conexiones, 16 sin autenticar por IP, clientes por usuario, tiempo de registro y colas acotadas. |
| Líneas enormes o binarias | Límite de 8703 bytes por línea y UTF-8 con pérdida. |
| Inyección de comandos con CR/LF | Cualquier CR o LF corta la línea; los textos de módulos, plugins y ficheros de idioma se validan sin caracteres de control. |
| Texto plano en internet | Los puertos sin TLS solo aceptan la red local o exigen insecure = true. |
| Credenciales en los registros | Enmascarado de PASS, AUTHENTICATE, OPER y mensajes a servicios en todos los niveles. |
Conexiones a las redes IRC
| Amenaza | Medida |
|---|---|
| Suplantación del servidor | TLS verificado con el almacén del sistema, sin opción para desactivarlo; un certificado de confianza solo acepta su huella SHA-256 exacta. |
| Respuestas malformadas | Parser propio sin unsafe, con tests y fuzzing. |
| Inundación del historial | Retención configurable, eventos opcionales, colas acotadas; el módulo log descarta líneas si el disco no da abasto; ocultar canales inundados. |
| Desconexiones en bucle | Espera progresiva con variación aleatoria y espera mínima tras avisos de throttling. |
| Expulsión por flood | Control de ritmo en la salida. |
| Robo de la contraseña de servicios | En redes sin NickServ nunca se envía en modo automático. |
DCC
| Amenaza | Medida |
|---|---|
| Usar el bouncer para llegar a redes internas (SSRF) | Ofertas hacia direcciones internas o puertos por debajo de 1024 rechazadas salvo permiso del usuario. |
| Hacer que xBNC se conecte a un tercero | En tus envíos solo se conecta de vuelta a la IP de tu dispositivo. |
| Puertos abiertos indefinidamente | Un puerto por oferta, una sola conexión, tiempo de espera, cierre por inactividad y límite de tamaño. |
| Robo de la transferencia | En la recepción, el puerto solo acepta la IP del cliente. |
Panel web y API
| Amenaza | Medida |
|---|---|
| CSRF | Token CSRF en cabecera, cookie SameSite=Strict y comprobación de Origin. |
| XSS | React escapa todo el contenido; CSP sin scripts externos ni en línea; los textos de IRC nunca se interpretan como HTML; las traducciones son texto plano. |
| Robo de sesión | Cookie HttpOnly y Secure; solo el SHA-256 del token en la base de datos; caducidad deslizante; cambiar la contraseña cierra las demás sesiones. |
| Secuestro del WebSocket | Comprobación de Origin, revalidación de la sesión cada 30 s y sin tokens de API. |
| Escalada de privilegios | Permisos comprobados en el servidor en cada ruta; nadie cambia su propio rol; siempre queda un superadministrador. |
| Ver datos de otros usuarios | Las redes ajenas responden 404, no 403. |
| Abuso de la API y slowloris | 20 peticiones/s por IP, cuerpos acotados, 64 conexiones por IP y 4 096 en total, cierre tras 2 minutos sin tráfico, 10 s para el saludo TLS. |
| Tokens filtrados | Alcance, caducidad, último uso e IP visibles, revocación inmediata, solo su SHA-256 guardado. |
| Primer acceso robado | Código de un solo uso, solo en el registro del servicio. |
| Webhook hacia sitios internos | Solo lo configura un superadministrador; sin redirecciones, sin credenciales en la URL, 10 s como máximo. |
Plugins
| Amenaza | Medida |
|---|---|
| Salir del aislamiento | Intérprete Wasmi sin JIT, módulo validado al cargar, sin WASI ni más importaciones que las de xbnc, funciones avanzadas de WebAssembly desactivadas. |
| Bloquear o tumbar el servidor | Combustible por evento, memoria limitada, ejecución que nunca hace crecer la pila nativa, llamadas en hilos aparte, parada tras cinco fallos. |
| Actuar sin permiso | Acciones declarativas comprobadas contra los permisos; comandos peligrosos siempre prohibidos; máximo de mensajes por evento; acceso web solo a dominios aprobados y con límites. |
| Leer datos de otros | Cada instancia solo recibe los eventos de su red; estado y almacén separados por red. |
| Fichero cambiado tras instalarlo | Se guarda su SHA-256 y no se carga si no coincide; ficheros 0600. |
| Plugin malicioso instalado | Solo un superadministrador instala, viendo permisos y huella; queda en la auditoría; catálogo remoto firmado. |
Importación desde otro bouncer
| Amenaza | Medida |
|---|---|
| Fichero preparado para crear un superadministrador | La importación nunca concede ese rol. |
| Contraseñas débiles heredadas | SHA-256 con sal comparado en tiempo constante y sustituido por Argon2id; los formatos no comprobables reciben una contraseña aleatoria. |
| Rutas o tamaños abusivos | Fichero de hasta 4 MB, anidamiento limitado, nombres validados; los registros solo se leen de las carpetas indicadas. |
| Fugas en la vista previa | La vista previa no incluye secretos. |
Actualizaciones desde el panel
| Amenaza | Medida |
|---|---|
| Paquete falso (servidor de descargas, DNS o red comprometidos) | Firma Ed25519 sobre el nombre del paquete y su SHA-256; la clave pública solo está en xbnc.toml, propiedad de root. |
| Volver a una versión con fallos conocidos | Se rechazan las versiones iguales o anteriores a la instalada. |
Un proceso xbnc comprometido que intenta instalar algo como root | El ayudante (xbnc-update.service) no confía en nada de la carpeta del servicio: copia el paquete a /run (0700), comprueba la firma y la versión sobre esa copia, nunca sigue enlaces simbólicos, valida el nombre del fichero y usa cada petición una sola vez. |
| Petición de actualización falsa | Solo superadministradores, desde una sesión del panel (no con tokens de API) y con CSRF; queda en la auditoría. |
| Descargas infinitas o redirecciones a texto plano | 200 MB y 10 minutos como máximo; solo https://, 5 redirecciones como máximo. |
Datos guardados y copias de seguridad
| Amenaza | Medida |
|---|---|
| Robo de la base de datos | Credenciales de red cifradas con XChaCha20-Poly1305; la clave fuera de la base de datos, con permisos 0600 comprobados al arrancar. |
| Robo de una copia de seguridad | Fichero 0600; incluye la clave, así que hay que guardarlo cifrado. |
| Acceso desde otros usuarios del sistema | Servicio con el usuario xbnc sin privilegios, carpetas 0700 y hardening de systemd. |
Riesgos aceptados
- El historial se guarda sin cifrar en la base de datos: cifrarlo impediría la búsqueda y la reproducción. Lo protegen los permisos del sistema.
- Los clientes IRC no tienen segundo factor: la contraseña del bouncer es su única protección (de ahí el bloqueo por IP y Argon2id).
- Un superadministrador puede instalar un plugin con permiso para enviar mensajes en nombre de quien lo active: es una decisión de confianza que el panel muestra antes de instalar.
- Todas las conexiones a las redes salen de la IP del servidor.
- FiSH es criptografía antigua (Blowfish, sin integridad); los mensajes descifrados se guardan en el historial como el resto.
Revisión
Cada versión revisa estas tablas: una función nueva que abra una superficie que no esté aquí se añade a ellas. Los tests que respaldan cada medida están en crates/xbncd/tests/ y en los tests unitarios de cada módulo; el fuzzing cubre el parser IRC, DCC, el fichero de configuración importado, la búsqueda, y los manifiestos y la ejecución de plugins (ver Entorno de pruebas).
Revisión interna de la versión 0.7. Se revisó todo el código con estas tablas como guía (no sustituye a la auditoría externa):
- Consultas SQL: todas con parámetros enlazados; las partes construidas con
format!son solo listas de columnas y cláusulas fijas. - Autorización de la API: cada ruta comprueba la sesión o el token y el permiso; las rutas de redes comprueban el dueño. Corregido:
PATCH /users/{id}respondía 404 o 403 a cuentas sin permiso según existiera el usuario. - Procesos externos: el único es
dpkgorpmen el ayudante de actualización, con argumentos fijos y el paquete ya comprobado. - Rutas de ficheros: registros, plugins y actualizaciones construyen rutas solo con nombres validados; el ayudante de actualización nunca sigue enlaces simbólicos.
- Denegación de servicio: se añadieron el límite de conexiones IRC sin autenticar por IP, los límites de conexiones y el tiempo de inactividad del panel, y el límite de cálculos de Argon2id simultáneos.
- Plugins: el intérprete pasó al modo de ejecución en bucle después de que el fuzzing encontrara que el modo de llamadas encadenadas podía agotar la pila nativa en compilaciones sin optimizar.
- Código
unsafe: solo una llamada amalloptal arrancar (ajuste del asignador de memoria). - Dependencias:
cargo-denyen el CI (licencias y avisos de seguridad).
Revisión interna de la versión 1.0. Se revisó el código nuevo de la 1.0 y se corrigieron tres puntos antes de publicar: en redes sin servicios nunca se envía la contraseña a quien use el nick «NickServ»; el intercambio de claves FiSH tiene límite de peticiones y de claves guardadas; el texto descifrado no puede romper líneas. Los ficheros de idioma se validan (marcadores, etiquetas, sin caracteres de control ni saltos de línea) y un texto que no pasa se muestra en inglés.
Rendimiento
Prueba de carga (cargo run --release --example loadtest -- --users 1000 --clients 1 --rate 2 --seconds 60): un servidor IRC simulado envía mensajes a todas las redes a la vez (el peor caso) y cada cliente mide cuánto tarda en recibirlos, pasando por el historial, los módulos y los plugins. Máquina: 2 vCPU Xeon a 2,1 GHz, 7 GB de RAM, disco en red, configuración por defecto (SQLite).
| Usuarios y redes | Clientes | Mensajes/s entregados | CPU (de un núcleo) | Memoria | Latencia p50 / p95 / p99 | Todas las redes de vuelta tras una caída |
|---|---|---|---|---|---|---|
| 500 | 500 | 492 | 5 % | 52 MB | 21 / 43 / 46 ms | 6,2 s |
| 500 | 500 | 4 847 | 43 % | 56 MB | 46 / 64 / 72 ms | 6,2 s |
| 1 000 | 1 000 | 1 951 | 17 % | 88 MB | 50 / 80 / 95 ms | 6,2 s |
| 1 000 | 2 000 | 1 968 | 11 % | 114 MB | 44 / 66 / 78 ms | 6,2 s |
| 2 000 | 2 000 | 1 968 | 19 % | 153 MB | 75 / 141 / 155 ms | 6,3 s |
- Ningún mensaje se perdió en ninguna prueba.
- La latencia sube con el tamaño de la ráfaga: con 2 000 redes recibiendo el mismo mensaje a la vez, el último se entrega unos 150 ms después que el primero. Con tráfico real, repartido en el tiempo, es de pocos milisegundos.
- Memoria: unos 45 KB por red conectada y unos 30 KB más por cliente, sin contar el historial (en disco).
- Los logins de clientes (Argon2id) van de uno en uno por CPU: 2 000 clientes entrando juntos tardan unos 27 s en 2 núcleos, sin disparar la memoria.
- Disco: unos 150 bytes por mensaje guardado, con el índice de búsqueda.
Para dimensionar: un servidor pequeño (1–2 vCPU, 1 GB de RAM) atiende cientos de usuarios con varias redes y miles de mensajes por segundo. Con muchos usuarios, revisa limits.max_connections, LimitNOFILE del servicio (65 536 por defecto) y la retención del historial.
Cómo se mide
La prueba (crates/xbncd/examples/loadtest.rs) arranca en un solo proceso:
- un servidor IRC simulado con un canal
#xbnc; - xBNC con N usuarios, cada uno con su red conectada a ese servidor y dentro de
#xbnc; - uno o varios clientes IRC por usuario conectados a xBNC.
El servidor envía --rate mensajes por segundo al canal, a todas las redes a la vez (el peor caso: ráfagas simultáneas). Cada mensaje lleva la hora de envío y cada cliente mide cuánto tarda en llegar: servidor IRC → xBNC (guardado en el historial, módulos, plugins) → cliente. Al final el servidor corta todas las conexiones y la prueba mide cuánto tardan todas las redes en volver.
La memoria y la CPU son las del proceso completo, así que incluyen el servidor simulado y los clientes de la prueba (xBNC solo consume algo menos). La compilación es --release con la configuración por defecto (historial en SQLite con WAL).
Problemas encontrados y corregidos con esta prueba
| Problema | Antes | Después |
|---|---|---|
| Memoria tras muchas entradas simultáneas: glibc guardaba en cada hilo los 19 MB de cada cálculo de Argon2id. | 1.680 MB con 500 clientes | 55 MB (util::tune_allocator, umbral fijo de mmap) |
| Cientos de cálculos de Argon2id a la vez (también útil contra avalanchas de intentos de entrada). | Sin límite | Uno por CPU (crypto::with_hash_slot) |
| Una transacción de SQLite por mensaje guardado. | p50 70 ms y 13 % de CPU con 500 redes | p50 21 ms y 5 % de CPU: un único hilo escritor guarda en una sola transacción todo lo que espera (Db::insert_message) |
Pendiente
- Repetir la prueba en hardware dedicado y con varias redes por usuario.
- Medir con servidores IRC reales a distancia (la prueba usa uno local, sin latencia de red).
Para repetirla: cargo run --release --example loadtest -- --users 2000 --clients 1 --rate 1 --seconds 60. Las opciones son --users, --clients (por usuario), --rate (mensajes por segundo al canal) y --seconds.
Entorno de pruebas
Con Docker
testenv/ levanta xBNC con dos servidores IRC distintos (Ergo e InspIRCd) en una red aislada, todo en texto plano a propósito:
cd testenv
docker compose up -d --build
./setup.sh
# IRC: localhost:6667, contraseña test/ergo@laptop:testpassword1
# Panel: http://localhost:8080 (usuario test, contraseña testpassword1)
No publiques esos puertos en una interfaz pública.
Tests automáticos
cargo test --workspace # todos los tests
XBNC_TEST_POSTGRES=postgres://postgres@127.0.0.1/postgres cargo test --workspace # también con PostgreSQL
cargo clippy --workspace --all-targets -- -D warnings
cd web && npm run build && npm run i18n:check # panel y traducciones
xbncd locales check locales/*.json # ficheros de idioma
python3 ../xbnc-wiki/build.py --app . # la wiki (proyecto aparte)
Incluyen el protocolo, las unidades, la API contra un bouncer real, IRC de extremo a extremo, todos los comandos de *status, el cambio a un servidor de reserva, el certificado de confianza con un saludo TLS real, un idioma añadido como fichero, módulos y plugins contra un servidor IRC simulado, el panel, SSO y servidores IRC reales en el CI (Ergo, InspIRCd, UnrealIRCd, Solanum y miniircd). El fuzzing (fuzz/) se ejecuta cada semana. testenv/ui/language_check.py comprueba en un navegador real que todas las formas de cambiar el idioma funcionan.
Pruebas en redes reales
El plan de pruebas por red, módulo y plugin está en testenv/real/PLAN.md. Ver Probar la beta.
Los conjuntos de tests
| Conjunto | Dónde | Qué cubre |
|---|---|---|
| Protocolo (16) | crates/xbnc-proto | Parser y serializador, escapado de tags, prefijos, casemapping, ISUPPORT, CTCP. |
| Unitarios del servicio (159) | crates/xbncd/src | Configuración, Argon2id, cifrado y permisos de la clave, base de datos y migraciones (SQLite y PostgreSQL, y actualización de un esquema antiguo), historial y búsqueda, cursores, sesiones, copias, login, limitador de fuerza bruta, enmascarado de logs, codec, CAP, roles, ajustes, TOTP (vectores del RFC 6238), métricas, tokens, cookies, origen, IP tras un proxy, cobertura de OpenAPI, redirección HTTP→HTTPS, catálogo y validación de módulos, globs, menciones, alias, registros, certificados de cliente y de confianza (con un handshake TLS real), FiSH, zonas horarias, idiomas (todas las claves usadas existen, español completo, ficheros comprobados y cargados), plugins (permisos, límites, regresiones del fuzzing), DCC, cliente HTTP, firmas de versiones, el ayudante de actualización y límites de conexiones, para qué nombres es válido un certificado TLS, y la dirección del panel que se muestra al instalar, y los textos del instalador (completos en inglés y en español, comprobados en cualquier fichero de idioma, y que existe cada clave que usan los scripts). |
| API (13) | tests/api.rs | Primera instalación con código de un solo uso, login, sesiones, CSRF, origen, cabeceras, fuerza bruta, redes, canales, historial, exportación, aislamiento entre usuarios, roles, ajustes en caliente, 2FA, panel, OpenAPI, módulos, certificados, notas, idioma, tokens, métricas, alertas, importación y plugins. |
| Extremo a extremo (16) | tests/e2e.rs | El bouncer completo contra un servidor IRC simulado (escenarios abajo). |
| Módulos (18 + 12) | tests/modules.rs, tests/modules_v1.rs | Cada módulo contra el servidor simulado: ausente y resumen, recuperar nick, respuestas al dispositivo que pregunta, eventos, CTCP, canales fijos, alias, op automático, volver tras un kick, vigilar palabras, MOTD y registros; y los módulos de la 1.0: extras IRCv3 solo para los clientes que los piden, login en servicios (X con la IP oculta y Login on Connect), invitación, ignorar y quitar colores, FiSH en los dos sentidos y DH1080, canales desacoplados, canales inundados, recuperar op, Latin-1 y tareas programadas. |
Comandos *status (12) | tests/status_commands.rs | Ayuda agrupada, nombres de comandos de otros bouncers, servidores de reserva (añadir, saltar, promover y cambio automático), huellas de confianza, direcciones de salida, canales desactivados y ordenados, búferes, MOTD y avisos a todos, permisos, redes desde IRC y un idioma añadido como fichero. |
| Plugins (2 + 5 + 7) | tests/plugins.rs, tests/plugins_v1.rs, tests/official_plugins.rs | Plugins respondiendo en la red y al usuario, y cada plugin oficial: seen, trivia, greet, factoids, karma, quotes, games, badwords, acceso web solo a sitios aprobados, recordatorios, tell, encuestas, estadísticas, antiflood, dados y respuestas automáticas. |
| Puerto único (2) | tests/shared_port.rs | El panel e IRC en un solo puerto TLS: un navegador recibe el panel, un cliente IRC el bouncer, http:// se envía a https:// y a un cliente IRC sin SSL se le pide activarlo. |
| Panel (3) | tests/panel.rs | Chat en el panel, menciones e historial de canal, modo desarrollo de plugins y el catálogo de un clic. |
| SSO (3) | tests/sso.rs | Passkeys, OpenID Connect y LDAP. |
| Línea de comandos (2) | tests/cli.rs | xbncd info ejecutado como un proceso real: el panel en la dirección dada al instalar, y ningún error cuando su salida va a head. |
| PostgreSQL (1) | tests/postgres.rs | Paso de una base de datos SQLite a PostgreSQL (con XBNC_TEST_POSTGRES). |
| Servidor IRC real (1) | tests/real_ircd.rs | Un xBNC real contra un servidor IRC real (ver abajo). |
| SDK de Rust (3) | sdk/rust | Eventos y respuestas del SDK. |
Escenarios de extremo a extremo
- Al conectarse, el cliente recibe la bienvenida, el ISUPPORT de la red, sus canales, el tema y la lista de usuarios.
- Un mensaje recibido con el cliente cerrado se reproduce al reconectar, con su hora; los mensajes propios no se reproducen al mismo dispositivo y una tercera conexión no recibe duplicados.
- Dos dispositivos conectados a la vez se sincronizan; un dispositivo nuevo recibe el historial reciente.
CHATHISTORYLATEST, AFTER y errores,batch, elserver-timedel servidor conservado,msgidyecho-message; no se anuncian capacidades no implementadas.- Login con SASL PLAIN.
- Una contraseña incorrecta se rechaza y la IP se bloquea tras tres fallos, incluso con la contraseña correcta.
- Red inexistente: el error indica las redes disponibles.
- Caída del servidor: el bouncer avisa, reconecta con esperas crecientes y vuelve a entrar en los canales.
*status, yPARTyJOINcon clave guardados (la clave se guarda cifrada).- Los comandos al conectar se envían antes de entrar en los canales.
- Las marcas de lectura se comparten entre dispositivos.
soju.im/bouncer-networkspara clientes modernos.- Con
/mode $nick +xen los comandos al conectar, ningún JOIN llega al servidor (canales guardados, los de los comandos, los del propio cliente) hasta que el servidor oculta el host (396). /msg *status joinnowentra en los canales retenidos.- Una contraseña incorrecta recibe el formato correcto, y tras los fallos la dirección se bloquea indicando los minutos que quedan y dónde desbloquearla.
- La contraseña de ejemplo («TU_CONTRASEÑA») se explica y no bloquea la dirección.
Servidores IRC reales
tests/real_ircd.rs conecta un xBNC real a un servidor IRC real (variable XBNC_IRCD=host:puerto) y comprueba la lista de usuarios, los mensajes en los dos sentidos, la sincronización entre dos dispositivos, la reproducción sin duplicados con el cliente cerrado, el cambio de nick, salir de un canal y seguir conectado a la red:
XBNC_IRCD=127.0.0.1:6667 cargo test -p xbncd --test real_ircd -- --ignored
El CI lo ejecuta contra Ergo, InspIRCd, UnrealIRCd, Solanum y miniircd (testenv/ci/start-ircd.sh compila o instala cada uno con una configuración mínima).
Fuzzing
fuzz/ tiene seis objetivos de libFuzzer:
| Objetivo | Qué recibe |
|---|---|
irc_message | Líneas IRC arbitrarias: parser, serializador y la vuelta atrás. |
dcc | Ofertas DCC. |
import_config | Ficheros de configuración de otro bouncer. |
search_query | Consultas de búsqueda contra el índice de texto completo. |
plugin_manifest | Ficheros WebAssembly con manifiestos arbitrarios. |
plugin_runtime | Módulos WebAssembly arbitrarios cargados y ejecutados como plugins. |
cargo install cargo-fuzz # necesita Rust nightly
cd fuzz && mkdir -p corpus/irc_message && cp seeds/irc_message/* corpus/irc_message/
cargo +nightly fuzz run irc_message corpus/irc_message -- -max_total_time=600
El CI (.github/workflows/fuzz.yml) ejecuta cada objetivo 20 minutos cada semana, conserva el corpus entre ejecuciones y antes comprueba que los fallos ya encontrados (fuzz/regressions/) siguen corregidos. Los fallos encontrados hasta ahora, todos corregidos y con su test:
- El parser aceptaba CR, LF o NUL dentro de una línea.
- El parser aceptaba comandos que no son alfanuméricos (
@ @). - Las ofertas DCC aceptaban caracteres de control.
- Incrustar un manifiesto desbordaba con secciones de tamaño imposible.
- Un plugin con un bucle largo agotaba la pila nativa del proceso en compilaciones donde el compilador no convierte en saltos las llamadas del intérprete: ahora el intérprete usa el modo de ejecución en bucle, que nunca hace crecer la pila.
Pruebas de carga
cargo run --release --example loadtest -- --users 2000 --rate 1 --seconds 60. Resultados y método en Rendimiento.
El panel en un navegador
El panel se ha recorrido en Chrome con Playwright contra un bouncer real con un cliente IRC conectado de verdad: primera instalación, asistente de redes, canales, historial y búsqueda, usuarios, seguridad, ajustes, 2FA, módulos, plugins (instalación con la vista previa de permisos, ajustes por red), importación desde otro bouncer, alertas, actualizaciones, copias, chat, la pantalla de entrada, los temas claro y oscuro y el móvil, en inglés y en español, sin errores en la consola salvo el 401 esperado antes de entrar. testenv/ui/language_check.py URL USUARIO CONTRASEÑA repite en un navegador real todas las formas de cambiar el idioma (pantalla de entrada, Tu cuenta, Ajustes, un idioma añadido como fichero) y comprueba que no queda ningún texto en otro idioma.
Lista de verificación manual
Úsala con testenv/ o con una instalación real:
- El servicio arranca y para limpiamente (
systemctl startystop xbnc; en el log aparece xBNC stopped). - Se crean un administrador y varios usuarios con la línea de comandos.
- Un usuario con dos redes está conectado a las dos a la vez.
- Un cliente clásico (HexChat, WeeChat, irssi o mIRC) se conecta con
usuario/red@dispositivo:contraseña. - Con el cliente cerrado, otra persona escribe en el canal y por privado; al reconectar esos mensajes llegan una sola vez.
- Dos clientes del mismo usuario ven lo que escribe el otro.
docker compose restart ergo(o cortar la red): xBNC avisa, reconecta y vuelve a los canales./msg *status statusmuestra el estado correcto.- Cinco contraseñas incorrectas bloquean la IP durante 15 minutos.
scripts/backup.shyscripts/restore.shrecuperan usuarios, redes e historial.journalctl -u xbncno contiene contraseñas tras hacer login, SASL y/msg NickServ IDENTIFY.- Desde el panel: crear un usuario, añadirle una red con el asistente, entrar en un canal y ver el historial.
- Un usuario normal no ve Usuarios, Seguridad ni Ajustes, ni las redes de otros.
- Activar la verificación en dos pasos y entrar con el código.
- Cambiar la retención en Ajustes y comprobar en Sistema que se aplica sin reiniciar.
- Consumo de memoria con 1 usuario y 2 redes (
systemctl status xbnc): anótalo para comparar en versiones futuras.