Configurar la instancia
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
- Selecciona Configuración y luego Instancia.
- 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:
| Preset | Contenido |
|---|---|
enterprise | Todo activado; el predeterminado para una instalación nueva |
databases | Infraestructura, alertas, la página de estado y los módulos de bases de datos |
core | Infraestructura, alertas y la página de estado |
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
- 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.
- 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
securitytambién desactivasecurity.defenderysecurity.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=trueen la configuración del servidor; sus puntos de conexión responden entonces404. - Algunos interruptores se aplican siempre. Con
access.google_logindesactivada, se rechaza el inicio de sesión con Google.
Funciones a las que se refieren otras guías:
| Función | Qué controla |
|---|---|
monitoring.databases | Los módulos de SQL Server (incluidos los grupos de disponibilidad), Azure SQL, Managed Instance y PostgreSQL |
monitoring.updates | La página Actualizaciones y avisos y sus comprobaciones |
security | La página Postura de seguridad, los hallazgos y la puntuación de seguridad |
security.defender, security.wazuh | La recopilación desde Microsoft Defender for Cloud y desde Wazuh. Desactivadas de forma predeterminada |
security.recommendations | Muestra las recomendaciones de Defender for Cloud junto a los hallazgos |
collab.jira | Crear ticket en Jira en alertas y hallazgos; requiere collab.assign |
access.google_login | El inicio de sesión con Google |
access.directory_groups | Los roles para grupos de Microsoft Entra ID |
ui.public_status_page | Las páginas de estado públicas |
ui.i18n | Los idiomas distintos del inglés, en la consola y en los mensajes de Slack |
ui.themes | Los temas de color además del claro y el oscuro |
Configurar la marca
-
En Marca, completa los campos:
Campo Efecto Nombre del producto El 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 Lema Se muestra junto al nombre en pantallas anchas y en la descripción de la aplicación instalada. Hasta 120 caracteres Logo Ninguna, la Marca incorporada o una URL de una imagen: una dirección httpso una ruta de este servidor que empiece por/Tema por defecto El 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 -
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.
| Tarea | Solicitud |
|---|---|
| Leer la configuración completa, los presets y el registro de funciones | GET /api/v1/instance/admin |
| Aplicar un preset | POST /api/v1/instance/preset con {"name": "databases"} |
| Activar o desactivar funciones | PATCH /api/v1/instance/features con {"changes": {"collab.jira": false}} |
| Cambiar la marca | PATCH /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.