Saltar al contenido principal
Versión: 0.4 · actual

Modelo de seguridad

ConceptoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Lector, Operador, Editor, Administrador de entidad, Superadministrador
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

Excubius no tiene contraseñas propias para tu equipo: las personas inician sesión con la cuenta de Microsoft o de Google que tu organización ya administra. Lo que pueden ver y hacer depende entonces del rol que tienen en cada rama del árbol de entidades, y se vuelve a comprobar en cada solicitud. Los secretos que necesita el recolector se guardan cifrados y nunca se pueden volver a leer. En este artículo se explica cada capa.

Inicio de sesión​

Excubius usa OpenID Connect con Microsoft Entra ID (un solo inquilino) y Google, mediante el flujo de código de autorización con PKCE, state y nonce. No intervienen SDK de proveedores ni servicios de identidad de pago.

  • El token de ID se valida en cada inicio de sesión: su firma contra las claves que publica el proveedor, el emisor (en Entra ID, tu inquilino), la audiencia, el vencimiento y el nonce de ese inicio de sesión.
  • El inicio de sesión en curso se guarda en una cookie firmada y HttpOnly que dura 10 minutos. La página a la que se vuelve después de iniciar sesión debe ser una página del mismo sitio, así un enlace manipulado no puede enviar a nadie a otro lugar.
  • Las cuentas se identifican por proveedor y sujeto: el ID de objeto del usuario en Entra ID o el sujeto de Google, nunca solo por la dirección de correo electrónico.
  • Quién puede obtener una cuenta se decide por entidad: por invitación o por un dominio de correo electrónico permitido. Una cuenta de Google cuenta para un dominio solo cuando es una cuenta de Google Workspace de ese dominio; las cuentas personales de Google siempre necesitan una invitación.
  • Los secretos de los proveedores vienen solo de la configuración del servidor. Ni ellos, ni los códigos de autorización, ni los tokens se guardan nunca en la base de datos, se devuelven en la API o se escriben en los registros.
ProveedorPlanes
GoogleFree, Core, Pro, Enterprise
Microsoft Entra IDCore, Pro, Enterprise
Grupos de Microsoft Entra ID como titulares de rolesEnterprise

Autenticación multifactor​

La MFA la exige tu proveedor de identidad: el acceso condicional de Entra ID o la verificación en dos pasos de Google. Excubius todavía no inspecciona las notificaciones de MFA, así que exige MFA en el proveedor a todas las personas que pueden iniciar sesión, y sobre todo a los administradores de entidad.

Sesiones y tokens​

Un inicio de sesión correcto establece dos cookies, ambas HttpOnly, Secure sobre HTTPS y SameSite=Lax:

TokenDuraciónPropósito
Token de acceso15 minutosDemuestra quién eres en cada solicitud
Token de actualización14 díasObtiene un nuevo par de tokens; cada actualización emite un par nuevo

Los permisos no viajan en el token. Se leen de la base de datos en cada solicitud, así que desactivar un usuario, quitar un rol o cambiar la asignación de un grupo tiene efecto en la siguiente solicitud de esa persona. La pertenencia a los grupos del directorio se vuelve a leer en cada inicio de sesión.

nota

Todavía no se pueden revocar los tokens de actualización uno por uno. Para terminar el acceso de alguien antes de que venza su sesión, desactiva al usuario. Cerrar sesión en Excubius no cierra tu sesión en Microsoft ni en Google.

Todavía no hay claves de API: en esta versión, los scripts y otras herramientas no pueden llamar a la API por su cuenta.

Roles en el árbol de entidades​

Un rol se asigna a una persona, o a un grupo del directorio, en una entidad, y se aplica a esa entidad y a todo lo que está debajo. Una persona puede ser Administrador de entidad de un cliente y Operador de otro. En cualquier entidad, el rol efectivo es el más alto que se encuentra en la entidad y en sus antecesoras, contando los roles propios de la persona y los de sus grupos.

RolPuede
LectorLeer tableros, alertas, hallazgos y el detalle de los recursos; cambiar su propia configuración
OperadorTodo lo que puede un lector y, además, confirmar, silenciar, asignar y resolver alertas, crear tickets de Jira y planificar ventanas de mantenimiento
EditorTodo lo que puede un operador y, además, cambiar las comprobaciones y los umbrales de los recursos y aceptar riesgos de seguridad
Administrador de entidadTodo lo que puede un editor y, además, administrar las entidades de la rama, los valores predeterminados de las entidades, los recursos, las credenciales, las fuentes, las personas, los roles, las invitaciones, los canales de notificación, la configuración de Jira y la página de estado
SuperadministradorTodo, en todas las ramas, además de la configuración de toda la instalación. Se asigna solo en la raíz, y lo asigna otro superadministrador

Lo que esto significa en la práctica:

  • Cada lista se limita a tus ramas: entidades, recursos, alertas, la Vista general, credenciales, canales y personas. Si tus roles empiezan en Ciguapa Inc., el árbol de entidades que ves también empieza ahí.
  • Lo que está fuera de tus ramas no existe para ti: al abrir su dirección, la respuesta es No existe o ya no lo puedes ver. Lo que puedes ver pero no cambiar responde Tu rol no lo permite.
  • La asignación de roles se queda dentro de tu rama y tu nivel: un administrador de entidad puede invitar personas y asignar roles solo en las entidades que administra, y nunca un rol superior al suyo.
  • Una credencial pertenece a la entidad propietaria y la pueden usar los recursos de esa entidad y de las inferiores. Apuntar el recolector a un host con una credencial requiere el rol de administrador de entidad en la entidad de la credencial, así el administrador de un cliente no puede apuntar un usuario compartido desde arriba a un host de su elección.

En Entidades, etiquetas y herencia se explica el propio árbol.

Secretos​

Las credenciales de monitoreo, las claves de API de las fuentes, los secretos de cliente y las claves de los certificados cargados son de solo escritura:

  • Se cifran en la base de datos con AES y una firma HMAC (Fernet), con una clave que el instalador genera y guarda en el archivo de configuración del servidor, no en la base de datos. Un volcado de la base de datos por sí solo no revela ningún secreto.
  • Las pantallas y la API solo indican si un secreto está definido, por ejemplo guardado — déjalo vacío para conservarlo. Nadie puede volver a leer un secreto, sea cual sea su rol.
  • Un secreto se descifra en el servidor, o se envía al recolector por la red interna del servidor cuando una comprobación lo necesita. El recolector lo mantiene en memoria y nunca lo escribe en los registros.
  • El contenedor del recolector solo recibe su propio token y su configuración: nunca la contraseña de la base de datos, el secreto de firma de sesiones ni la clave de cifrado. Las rutas del recolector se rechazan en el borde del servidor, así que solo se puede llegar a él desde dentro.

Las propias credenciales se crean sin permisos de escritura ni de instalación en los sistemas monitoreados; consulta Arquitectura.

Auditoría​

Cada cambio que se hace a través de la API se escribe en el registro de auditoría con el usuario que lo hizo, la hora y la dirección IP de la solicitud. Para el inicio de sesión y el acceso, esto incluye:

EventoSe registra como
Un inicio de sesiónlogin
Un rechazo después de que el proveedor respondió, con el motivologin.failed
Una cuenta creada en el primer inicio de sesiónuser.create
Una invitación creada, aceptada o eliminadainvitation.create, invitation.accept, invitation.delete
Un rol asignado o quitadorole.grant, role.revoke
Un cambio del modo de registroregistration.update, registration.reset
Un cambio en un usuario o en sus preferenciasuser.update, user.preferences

Las acciones sobre alertas, los cambios de umbrales, los cambios de fuentes, las ventanas de mantenimiento y las ediciones de la página de estado se auditan de la misma forma. El registro de auditoría se conserva en la base de datos de la plataforma.