# Virtual hosts de RabbitMQ para aislar tenants en la empresa
Los virtual hosts de RabbitMQ para aislar tenants en la empresa ofrecen a cada tenant un namespace lógicamente separado para exchanges, colas, bindings, usuarios y políticas dentro de un mismo broker. Son la herramienta adecuada para separar tenants a nivel organizativo y de control de acceso, pero comparten la misma VM de Erlang, la memoria, el disco y la CPU, de modo que por sí solos no constituyen una frontera rígida de seguridad ni de recursos.
Qué aísla realmente un vhost (y qué no)
Un virtual host de RabbitMQ, o vhost, es un namespace dentro de un único broker o clúster. Cada exchange, cola y binding reside exactamente en un vhost, y los nombres solo tienen que ser únicos dentro de ese vhost, no en todo el broker. Dos tenants pueden tener cada uno una cola llamada orders sin conflicto, porque tenant-a/orders y tenant-b/orders son objetos completamente distintos.
Un vhost también delimita el ámbito de los usuarios y permisos, las políticas (TTL, max-length, enrutamiento dead-letter, ajustes de colas de quórum, comportamiento de replicación), los parámetros de runtime, los límites de conexiones y colas, y los enlaces de Federation y Shovel.
Lo que un vhost no aísla es todo lo que está por debajo del modelo de objetos de AMQP. Todos los vhosts de un nodo comparten la misma VM de Erlang y los mismos hilos del scheduler, el mismo pool de memoria física regido por el único vm_memory_high_watermark del nodo, el mismo disco regido por disk_free_limit, los mismos límites de descriptores de fichero y sockets del sistema operativo, y los mismos núcleos de CPU.
Aquí es donde auditores y arquitectos se equivocan con más frecuencia. Si la aplicación de un tenant publica más rápido de lo que consume, la profundidad de cola crece, la presión de memoria aumenta y RabbitMQ dispara una alarma de memoria o una alarma de disco a nivel de nodo. En cuanto salta, el nodo bloquea a los publicadores de todos los vhosts, no solo del causante. Un vhost es una frontera administrativa y de namespace, no un sandbox de recursos: impide que los tenants vean o toquen las colas y mensajes de otros, pero no impide que un tenant ruidoso degrade el servicio de todos los que comparten el nodo.
Para el comportamiento a nivel de nodo (watermarks de memoria, límites de disco, clustering, colas de quórum), consulte la guía de arquitectura en producción. Para ver cómo encajan exchanges, colas y bindings, consulte la guía de topología.
Cuándo aislar con vhosts y cuándo con clústeres separados
La decisión no depende de cuántos tenants tenga. Depende del radio de impacto, de las fronteras de cumplimiento normativo y de la divergencia operativa.
Use vhosts en un clúster compartido cuando:
Los tenants tienen perfiles de throughput y de picos similares, de modo que ninguno puede dejar sin recursos a los demás
Los tenants son equipos internos o unidades de negocio de confianza, no partes adversarias
El alcance de cumplimiento normativo ya trata todo el clúster como un único sistema
El número de tenants es elevado (de decenas a cientos) y minimizar el coste de infraestructura es importante
La cadencia de actualizaciones y las ventanas de mantenimiento pueden compartirse sin conflictos
Use clústeres separados cuando:
Una frontera de cumplimiento normativo exige separación de infraestructura, no solo de namespace (por ejemplo, tenants con HIPAA y PCI DSS y auditores distintos)
Los SLA difieren de forma significativa: un tenant necesita respuesta a incidentes en 15 minutos y otro acepta el siguiente día laborable
El tráfico de un tenant es tan grande que puede disparar alarmas en el nodo compartido
La caída de un tenant nunca debe afectar a la disponibilidad de otro, y el radio de impacto compartido de los vhosts es inaceptable
La cadencia de actualizaciones diverge: un tenant está fijado a una versión antigua de RabbitMQ por una integración con un proveedor
La regla práctica: los vhosts resuelven de forma económica el multi-tenant organizativo, mientras que los clústeres separados resuelven el multi-tenant por radio de impacto y cumplimiento normativo. La mayoría de las empresas acaban en un modelo híbrido: vhosts para tenants de bajo riesgo y tamaño similar, y clústeres dedicados para los pocos con requisitos regulatorios, de SLA o de escala que no encajan en el modelo compartido.
Diseño de permisos multi-tenant
A cada usuario de RabbitMQ se le asignan permisos por vhost mediante tres expresiones regulares: configure, write y read, que controlan, respectivamente, qué puede declarar o eliminar, en qué puede publicar y desde qué puede consumir o con qué puede hacer binding.
Diseñe los permisos en torno a cuentas de servicio, no a personas. Una cuenta nominal asociada a permisos genera un problema de auditoría y de baja en cuanto alguien cambia de puesto o se marcha; cree en su lugar una cuenta por aplicación y por vhost.
Esto concede a svc-acme-orders derechos solo sobre los recursos que empiezan por orders. dentro de tenant-acme. No puede tocar nada fuera de ese prefijo y no tiene visibilidad sobre ningún otro vhost.
Los permisos de topic añaden una segunda capa para los topic exchanges, donde la propia routing key tiene significado (orders.region.us.priority.high):
Aquí el servicio solo puede publicar routing keys con prefijo de EE. UU., pero puede leer tanto el tráfico de EE. UU. como el de la UE, algo útil cuando un servicio de informes necesita un acceso de lectura más amplio que el de los publicadores que agrega.
Los tags de usuario controlan el acceso de gestión y monitorización, de forma independiente de los permisos sobre recursos del vhost: management permite iniciar sesión en la UI y ver los vhosts sobre los que el usuario tiene permisos; monitoring da acceso de solo lectura a las métricas de todo el broker, incluidos vhosts sobre los que el usuario no tiene permisos de recursos; policymaker permite definir políticas y parámetros en los vhosts que administra; administrator otorga control total, incluida la gestión de usuarios y vhosts en todo el broker.
No asigne ningún tag a las cuentas de servicio de las aplicaciones; solo necesitan acceso AMQP, no inicio de sesión en la UI. Reserve administrator para los operadores de la plataforma, no para los administradores de los tenants. Si un tenant gestiona sus propias políticas, concédale policymaker limitado a su vhost, nunca un tag de alcance global. Audite periódicamente las cadenas de permisos: una cadena configure, write o read con valor .* en cualquier cuenta de servicio es una señal de alarma, no una comodidad.
Límites de recursos por vhost
RabbitMQ 3.8 y posteriores admiten dos límites rígidos definidos directamente en un vhost:
max-connections limita cuántas conexiones AMQP puede abrir un tenant en ese vhost, lo que limita indirectamente la proliferación de canales y consumidores. max-queues limita cuántas colas pueden existir en el vhost, lo que protege frente a la creación descontrolada de colas dinámicas por parte de un cliente defectuoso o de un proceso roto de limpieza de colas temporales.
Los límites por usuario añaden una segunda capa, independiente del vhost:
Conviene decirlo claramente, porque sorprende: la memoria y el disco no son recursos por vhost. No existe ningún ajuste max-memory ni max-disk limitado a un vhost. Los parámetros vm_memory_high_watermark y disk_free_limit del nodo se aplican de forma global, y un solo tenant con un crecimiento ilimitado de colas puede disparar cualquiera de las dos alarmas y bloquear a los publicadores en todo el clúster.
En la práctica, el verdadero throttling del consumo de memoria y disco son las políticas, no los límites de conexiones. Aplique políticas por vhost para el TTL de los mensajes, de modo que los mensajes no consumidos no se acumulen indefinidamente; max-length o max-length-bytes, para limitar el tamaño de la cola y forzar un comportamiento de desbordamiento (descartar la cabeza o rechazar la publicación) al alcanzar el límite; un dead-letter exchange (DLX), para que los mensajes que alcanzan los límites de TTL o longitud vayan a un lugar observable en vez de desaparecer; y valores predeterminados para colas de quórum, ya que las colas de quórum tienen un comportamiento de memoria y replicación distinto al de las colas clásicas.
Cuando un tenant necesita legítimamente más de lo que permiten los límites compartidos, la solución no es relajar el límite para todos. Aumente individualmente los límites del vhost y de las políticas de ese tenant, vigile mientras tanto el margen de memoria y disco del nodo y, si el aumento le lleva a una huella de recursos sustancialmente distinta de la de los demás tenants del nodo, tómelo como la señal para migrarlo a un vhost dedicado o a un clúster separado (consulte la sección de migración más abajo).
Patrones operativos
Convención de nombres. Elija una y aplíquela en todas partes: env.tenant.purpose (prod.acme.orders) o tenant.env (acme.prod) funcionan igual de bien; lo importante es que sea lo bastante predecible como para automatizarla con scripts y buscarla con grep en los logs. Evite nombres de vhost de texto libre elegidos sobre la marcha en cada solicitud de incorporación.
Aprovisionamiento. Los comandos manuales de rabbitmqctl no escalan más allá de unos pocos tenants. Hay dos vías soportadas: la exportación/importación de definiciones, donde rabbitmqctl export_definitions genera un documento JSON con vhosts, usuarios, permisos, políticas y topología que puede usar como plantilla por tenant y cargar con rabbitmqctl import_definitions; y la API HTTP, donde el plugin de gestión expone PUT /api/vhosts/{name}, /api/permissions/{vhost}/{user} y /api/vhosts/{name}/limits, que es lo que la mayoría de los módulos de Terraform y Ansible invocan internamente. Use el provider comunitario de Terraform para RabbitMQ, o los módulos rabbitmq_vhost y rabbitmq_user de Ansible, para mantener el aprovisionamiento bajo control de versiones en lugar de ejecutarlo a mano contra producción.
Monitorización. El exportador de Prometheus de RabbitMQ, integrado desde la 3.8 mediante rabbitmq_prometheus, etiqueta las métricas con vhost, por lo que puede crear dashboards y alertas por tenant sobre profundidad de cola, número de conexiones y tasa de mensajes sin exportadores adicionales. Configure alertas sobre el crecimiento de colas por vhost y sobre el número de conexiones cercano a max-connections, no solo sobre la memoria y el disco de todo el nodo, ya que las alarmas a nivel de nodo saltan demasiado tarde para atribuir la responsabilidad a un tenant concreto. Consulte la guía de monitorización en Kubernetes para configurar el exportador en despliegues en contenedores.
Federation y Shovel. Ambos se configuran por vhost, no de forma global. Un upstream de Federation o un enlace de Shovel declarado en tenant-acme solo mueve mensajes hacia o desde recursos de ese vhost, de modo que el movimiento de datos entre tenants es explícito y auditable, no implícito.
Seguridad y cumplimiento normativo
Los vhosts permiten una separación de funciones limpia: el policymaker de un tenant puede ajustar sus propias políticas de colas sin tocar el vhost de otro tenant, mientras que una cuenta administrator de toda la plataforma queda reservada a los operadores de infraestructura, no al personal de los tenants. Mantenga esa separación en el modelo de permisos, no solo en la documentación de procesos.
El registro de auditoría de los cambios de definiciones importa más de lo que la mayoría de los equipos presupuesta. Cada llamada a set_permissions, set_policy y add_vhost modifica el modelo de aislamiento de tenants, y esos cambios deben registrarse y poder revisarse, ya sea mediante el event exchange del plugin de gestión, el envío de los logs de RabbitMQ o un proceso de gestión de cambios alrededor del pipeline de aprovisionamiento (el historial de plan/apply de Terraform funciona bien aquí).
TLS debe terminarse por conexión, con autenticación mutua donde se requiera. El mapeo de certificados por vhost mediante x.509 o claims de tokens OAuth2 vincula un certificado de cliente o un scope de JWT directamente con los permisos de un vhost, lo que elimina la gestión de usuarios y contraseñas de la incorporación de tenants. Esto combina bien con un módulo criptográfico validado FIPS cuando el alcance regulatorio lo exige; consulte FIPSMQ.
Cuando presente el aislamiento por vhosts a un auditor, sea preciso en lo que afirma. Un vhost es una frontera de control: aplica control de acceso y separación de namespaces, auditable mediante exportaciones de permisos. No es un aislamiento rígido a nivel de infraestructura, ya que el cómputo, la memoria y el disco son compartidos. Los auditores acostumbrados al aislamiento a nivel de VM o de contenedor a veces suponen que un vhost ofrece la misma garantía; corregirlo desde el principio evita un hallazgo más adelante. Consulte cumplimiento normativo de RabbitMQ y la guía del stack de mensajería para sectores regulados para una visión más completa del cumplimiento normativo.
Migración: trasladar un tenant a su propio vhost o clúster
Sacar a un tenant de un vhost compartido, ya sea a un vhost dedicado o a un clúster dedicado, no requiere tiempo de inactividad si se ordenan bien los pasos.
De vhost compartido a vhost dedicado (mismo clúster):
1. Cree el nuevo vhost y replique en él los usuarios, permisos y políticas del tenant.
2. Configure un Shovel desde las colas del tenant en el vhost antiguo hacia el nuevo vhost, para que los mensajes sigan fluyendo durante el cutover.
3. Actualice la configuración de los productores para que publiquen en el nuevo vhost, de forma escalonada entre instancias si es necesario.
4. Cuando confirme que los productores escriben en el nuevo vhost, actualice la configuración de los consumidores para que lean de él.
5. Deje que el Shovel vacíe los mensajes restantes y, después, elimínelo y retire los recursos antiguos.
El mismo patrón de Shovel sirve para pasar de un vhost dedicado a un clúster separado, ya que los Shovels se conectan mediante AMQP estándar y no requieren pertenecer al clúster; basta con apuntar el destino del Shovel al vhost del nuevo clúster. Como alternativa, una ventana de doble publicación hace que los productores escriban en ambas ubicaciones durante un periodo fijo; después se pasan los consumidores una vez confirmada la paridad y se detiene la publicación en el lado antiguo. Esto supone aceptar una breve ventana de entregas duplicadas, que exige consumidores idempotentes, a cambio de un modelo más sencillo que el vaciado mediante Shovel.
Checklist de cutover:
Confirme la idempotencia de los consumidores antes de activar la doble publicación o de confiar en los tiempos de vaciado del Shovel
Valide que las políticas (TTL, max-length, DLX) se replican exactamente en la nueva ubicación
Confirme que los permisos y las credenciales de las cuentas de servicio se han probado en la nueva ubicación
Monitorice la profundidad de cola en ambos lados durante la ventana de transición
Mantenga el vhost o clúster antiguo disponible, en solo lectura, durante una ventana de rollback
Antipatrones
Usar el vhost predeterminado / para todos los tenants, lo que elimina por completo la separación de namespaces
Una única cuenta de administrador compartida por todos los equipos, lo que deja sin sentido las pistas de auditoría
Credenciales personales en las cuentas de servicio en lugar de cuentas de servicio por aplicación, lo que se rompe en cuanto alguien se marcha
Cadenas de permisos .* en configure, write o read, que conceden acceso sin restricciones dentro del vhost
No definir límites max-connections ni max-queues, lo que deja a un cliente defectuoso libre para agotar los recursos del broker
No tener políticas por vhost para TTL o max-length, de modo que un consumidor bloqueado puede hacer crecer una cola hasta disparar la alarma de memoria de todo el nodo
Tratar el aislamiento por vhosts como equivalente al aislamiento de red o de infraestructura al hablar con auditores o clientes
Aprovisionar los vhosts a mano en lugar de mediante exportación/importación de definiciones, la API HTTP o infraestructura como código, lo que hace indetectable la desviación de la configuración
Operar todo esto de forma fiable a escala, sobre todo con tenants de sectores regulados y SLA distintos, es donde entra AceMQ. AceMQ es el único partner MSP de RabbitMQ designado por Broadcom, con línea directa con el equipo principal (Core Team) de RabbitMQ, objetivos de respuesta desde 15 minutos, según el plan, y cobertura de soporte desde la 3.8.x hasta la 4.x, con más de 160+ clientes empresariales en 26+ países, incluidos despliegues en sectores regulados como finanzas, sanidad y administración pública. Consulte los servicios de RabbitMQ o contacte con nosotros para solicitar una revisión de arquitectura.
Preguntas frecuentes
¿Es un vhost de RabbitMQ una frontera de seguridad?
En parte. Un vhost impone control de acceso y aislamiento del espacio de nombres: los usuarios necesitan permisos explícitos para ver o tocar los exchanges y las colas de un vhost, y un tenant no puede explorar los recursos de otro. Pero todos los vhosts de un nodo comparten la misma máquina virtual de Erlang, la misma memoria, el mismo disco y la misma CPU. Un vhost no protege frente al agotamiento de recursos ni frente a una denegación de servicio a nivel de nodo provocada por otro tenant. Trátelo como una frontera de control del acceso, no como una frontera de aislamiento estricto de la computación o la memoria, sobre todo cuando se lo describa a los auditores.
¿Cómo limito los recursos por tenant en RabbitMQ?
Defina max-connections y max-queues directamente en el vhost con rabbitmqctl set_vhost_limits y, si lo desea, limite max-connections y max-channels por cuenta de usuario. Para la memoria y el disco, que no tienen ámbito de vhost, aplique en su lugar políticas por vhost: TTL de los mensajes, max-length o max-length-bytes en las colas y un dead-letter exchange para que los mensajes que desbordan vayan a un sitio visible en lugar de descartarse sin avisar o crecer sin límite. Eso es lo que de verdad protege el nodo compartido.
¿Debe cada cliente tener su propio vhost o su propio clúster de RabbitMQ?
Use un vhost en un clúster compartido cuando los tenants tengan perfiles de tráfico similares y ningún requisito estricto de separación física de la infraestructura; es más barato de operar y escala a cientos de tenants. Pase a un tenant a un clúster dedicado cuando una frontera de cumplimiento normativo exija separación a nivel de infraestructura, cuando los SLA difieran de forma significativa entre tenants o cuando el throughput de un tenant sea lo bastante grande como para arriesgarse a disparar las alarmas del nodo compartido y afectar a todos los demás.
¿Puede un solo tenant ruidoso tumbar una configuración de vhosts compartidos de RabbitMQ para todos?
Sí, y es el malentendido más habitual sobre los vhosts. Las alarmas de memoria y de disco son de nodo, no de vhost. Si la cola de un tenant crece sin límite porque un consumidor se atasca o un productor envía una ráfaga, el nodo puede superar vm_memory_high_watermark o disk_free_limit, lo que bloquea a los publicadores de todos los vhosts de ese nodo, no solo los del tenant causante. Las políticas por vhost de TTL y max-length, junto con una monitorización proactiva por vhost, son la mitigación práctica.
¿Qué tags de usuario de RabbitMQ deben tener las cuentas de servicio?
Las cuentas de servicio de las aplicaciones que publican y consumen mensajes, por lo general, no necesitan ningún tag de gestión, ya que las operaciones AMQP no requieren acceso a la interfaz de gestión. Reserve management para las personas que necesitan iniciar sesión en la interfaz, monitoring para una visibilidad amplia de solo lectura, policymaker para los administradores de tenants que gestionan las políticas de su propio vhost y administrator estrictamente para los operadores de la plataforma que gestionan todo el broker. Asignar el tag administrator a una cuenta de servicio por comodidad es un hallazgo de auditoría habitual.
¿Cómo configuro permisos de mínimo privilegio para un vhost multitenant de RabbitMQ?
Cree una cuenta de servicio por aplicación y por vhost, no credenciales compartidas ni personales. Use rabbitmqctl set_permissions con patrones regex limitados al prefijo de recursos que esa aplicación necesita realmente, por ejemplo ^orders\. en lugar de .*. Añada por separado permisos de topic para los topic exchanges en los que las routing keys tienen relevancia para el acceso. Audite periódicamente las cadenas de permisos en busca de cualquier patrón .*, que indica una concesión más amplia de lo que requiere la aplicación.
Tanto si está resolviendo un incidente en producción como si planifica una migración o quiere una segunda opinión sobre su arquitectura, nuestro equipo está preparado. Sin discursos comerciales, solo respuestas.