Saltar al contenido principal
Versión: 0.4 · actual

Configurar la instancia

Guía paso a pasoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Superadministrador
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

Cada instalación de Excubius incluye todas las capacidades. Configuración › Instancia decide cuáles muestra la instalación, y con qué nombre, logotipo y tema. Los cambios se aplican a todos a la vez y se escriben en el registro de auditoría. Esta guía muestra cómo activar y desactivar funciones, aplicar un preset y configurar la marca.

Antes de empezar​

  • Necesitas el rol Superadministrador. La pantalla no se muestra a nadie más.
  • Algunas funciones también necesitan configuración en el servidor, como un token de Slack o credenciales de Jira. Activar una función la muestra; no la configura.

Abrir la pantalla​

  1. Selecciona Configuración y luego Instancia.
  2. Busca las secciones Presets, Funciones y Marca que se describen a continuación. Al final, la pantalla indica si las funciones desactivadas solo se ocultan o si además la API las rechaza, y cuándo se hizo el último cambio.

Los nombres del servidor y TLS tienen su propia pantalla, enlazada desde la parte superior como Nombres del servidor y HTTPS. Consulta Configurar nombres y TLS.

Partir de un preset​

Un preset es un punto de partida con nombre: un conjunto de interruptores de funciones más la marca. Cada uno se muestra como una tarjeta con su descripción. Los presets de uso general son:

PresetContenido
enterpriseTodo activado; el predeterminado para una instalación nueva
databasesInfraestructura, alertas, la página de estado y los módulos de bases de datos
coreInfraestructura, alertas y la página de estado
aviso

Seleccionar la tarjeta de un preset lo aplica de inmediato. Reemplaza todos los interruptores de funciones y la marca por los del preset. Anota tu marca antes de aplicar uno, y ajusta después los interruptores individuales.

Incluso en enterprise, las fuentes Defender for Cloud y Wazuh permanecen desactivadas hasta que las activas.

Activar o desactivar una función​

  1. En Funciones, busca la función en su grupo: Fuentes, Monitoreo, Seguridad, Colaboración, Acceso o Interfaz. Cada línea muestra la clave de la función, lo que hace y, si la tiene, la función que requiere.
  2. Usa su interruptor.

El cambio se aplica de inmediato.

  • Una función que requiere otra aparece atenuada mientras esa otra está desactivada. Desactivar un requisito desactiva también las funciones que dependen de él; por ejemplo, desactivar security también desactiva security.defender y security.wazuh.
  • Desactivar una función a la que pertenecen módulos del catálogo quita esos módulos de la lista del catálogo.
  • De forma predeterminada, ocultar es solo visual: la navegación, las pantallas y los widgets siguen los interruptores, mientras que la recopilación, el almacenamiento y la API siguen funcionando. Cuando vuelves a activar una función, su historial sigue ahí. Para que la API también rechace las funciones desactivadas, establece EXCUBIUS_FEATURES_ENFORCE_API=true en la configuración del servidor; sus puntos de conexión responden entonces 404.
  • Algunos interruptores se aplican siempre. Con access.google_login desactivada, se rechaza el inicio de sesión con Google.

Funciones a las que se refieren otras guías:

FunciónQué controla
monitoring.databasesLos módulos de SQL Server (incluidos los grupos de disponibilidad), Azure SQL, Managed Instance y PostgreSQL
monitoring.updatesLa página Actualizaciones y avisos y sus comprobaciones
securityLa página Postura de seguridad, los hallazgos y la puntuación de seguridad
security.defender, security.wazuhLa recopilación desde Microsoft Defender for Cloud y desde Wazuh. Desactivadas de forma predeterminada
security.recommendationsMuestra las recomendaciones de Defender for Cloud junto a los hallazgos
collab.jiraCrear ticket en Jira en alertas y hallazgos; requiere collab.assign
access.google_loginEl inicio de sesión con Google
access.directory_groupsLos roles para grupos de Microsoft Entra ID
ui.public_status_pageLas páginas de estado públicas
ui.i18nLos idiomas distintos del inglés, en la consola y en los mensajes de Slack
ui.themesLos temas de color además del claro y el oscuro

Configurar la marca​

  1. En Marca, completa los campos:

    CampoEfecto
    Nombre del productoEl título del navegador, el encabezado, la página de inicio de sesión, el nombre de la aplicación instalada, y el prefijo y la etiqueta de las incidencias de Jira. Hasta 60 caracteres
    LemaSe muestra junto al nombre en pantallas anchas y en la descripción de la aplicación instalada. Hasta 120 caracteres
    LogoNinguna, la Marca incorporada o una URL de una imagen: una dirección https o una ruta de este servidor que empiece por /
    Tema por defectoEl tema de la página de inicio de sesión y de los usuarios nuevos. Cada persona puede seguir eligiendo el suyo
    Mostrar la línea "con tecnología de"Un crédito en el pie de página, que solo se muestra con la marca incorporada
  2. Selecciona Guardar.

Con Logo establecido en Ninguna, se usa un icono neutro en todas partes, incluida la pestaña del navegador y la aplicación instalada, así que nada en el navegador nombra el producto. Los mensajes de Slack y las páginas de estado públicas nunca nombran el producto, sea cual sea la marca.

Los temas son Medianoche, Luz de día, Pizarra y ámbar, Sala de operaciones (alto contraste), Okabe–Ito (apto para daltonismo) y Papel. Con ui.themes desactivada, la instalación solo ofrece el tema claro y el oscuro.

La rama de un cliente puede tener su propio tema y logotipo predeterminados; consulta Configurar la apariencia de una rama.

Hacerlo con la API​

Cada solicitud necesita el rol Superadministrador y queda registrada en la auditoría.

TareaSolicitud
Leer la configuración completa, los presets y el registro de funcionesGET /api/v1/instance/admin
Aplicar un presetPOST /api/v1/instance/preset con {"name": "databases"}
Activar o desactivar funcionesPATCH /api/v1/instance/features con {"changes": {"collab.jira": false}}
Cambiar la marcaPATCH /api/v1/instance/branding con cualquiera de product_name, tagline, logo, show_powered_by, theme_default

GET /api/v1/instance no requiere iniciar sesión: devuelve la marca y los interruptores tal como los ve quien llama, que es lo que lee la consola al cargarse.