Saltar al contenido principal
Versión: 0.4 · actual

Administrar entidades

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

Las entidades forman el árbol que contiene tus recursos: empresas, clientes, entornos, equipos. Lo que configuras en una entidad lo hereda todo lo que está debajo de ella. Esta guía muestra cómo construir y cambiar el árbol en Configuración › Entidades, dónde configurar lo que cada entidad transmite hacia abajo y cómo etiquetar recursos para agruparlos en todo el árbol.

Antes de empezar​

  • Necesitas el rol Administrador de entidad en la entidad que cambias. Para crear una entidad, lo necesitas en la entidad padre; para mover una, en la entidad y en su nuevo padre.
  • Planifica los niveles que necesitas. Los tipos de entidad (inquilino, cliente, entorno, grupo) son etiquetas descriptivas y no cambian ningún comportamiento. Para saber cómo funciona la herencia, consulta Entidades, etiquetas y herencia.

En los ejemplos, Areito Corporation es la raíz, Ciguapa Inc. es un cliente debajo de ella, y Producción y UAT son sus entornos.

Crear una entidad​

  1. Abre Configuración › Entidades. El árbol muestra la entidad elegida en el selector y todo lo que está debajo, con el número de recursos de cada rama.
  2. En la entidad padre, por ejemplo Ciguapa Inc., abre su menú de acciones y selecciona Agregar una entidad debajo.
  3. Escribe el Nombre, por ejemplo Production.
  4. Elige el Tipo, por ejemplo entorno.
  5. Si quieres, escribe un Nombre corto, que se usa en las rutas: letras minúsculas, dígitos y guiones, único en toda la instalación. Si lo dejas vacío, se deriva del nombre. No se puede cambiar después.
  6. Selecciona Crear.

Solo hay una entidad raíz; todas las demás entidades tienen un padre.

Cambiar el nombre de una entidad​

  1. Abre el menú de acciones de la entidad y selecciona Cambiar el nombre.
  2. Cambia el Nombre y, si hace falta, el Tipo. El tipo de la raíz no puede cambiar.
  3. Selecciona Guardar.

El nombre corto no cambia, así que los enlaces y las rutas siguen funcionando.

Mover una entidad​

Mover una entidad mueve todo lo que está debajo de ella, y a partir de ese momento todo hereda de su nuevo lugar: umbrales, canales de Slack, ventanas de mantenimiento, registro y roles.

  1. Abre el menú de acciones de la entidad y selecciona Mover.
  2. Elige el Nuevo padre. Solo se ofrecen entidades que administras, y nunca la propia entidad ni una que esté debajo de ella.
  3. Selecciona Mover.

La raíz no se puede mover. El registro de auditoría guarda cada movimiento.

Eliminar una entidad​

Puedes eliminar una entidad cuando ya no queda nada debajo de ella.

  1. Quita o mueve lo que contiene: entidades hijas, recursos y fuentes. Eliminar un recurso también elimina sus alertas.
  2. Abre el menú de acciones de la entidad y selecciona Eliminar. La opción solo está disponible cuando la entidad está vacía.
  3. Selecciona Eliminar para confirmar. Las credenciales, los canales de Slack y las asignaciones de roles propios de la entidad se eliminan con ella.

Excubius rechaza la eliminación cuando la entidad todavía tiene entidades hijas, recursos, fuentes o alertas, o cuando recursos de otras partes usan una de sus credenciales. La raíz no se puede eliminar.

Configurar lo que una entidad transmite​

Cada configuración heredada tiene su propia pantalla. Elige la entidad en el selector, o ábrela desde Configuración › Entidades.

ConfiguraciónDóndeGuía
Umbrales predeterminados de cada comprobaciónConfiguración › Entidades, menú de acciones, Umbrales predeterminadosCambiar umbrales y desactivar comprobaciones
Roles y quién obtiene una cuentaConfiguración › Usuarios y rolesAdministrar usuarios y roles
Credenciales para el recolectorConfiguración › CredencialesGuardar una credencial para el recolector
Canales de SlackConfiguración › NotificacionesConfigurar las notificaciones de Slack
Ventanas de mantenimientoConfiguración › Ventanas de mantenimientoPlanificar una ventana de mantenimiento
Tema y logotipo predeterminadosConfiguración › Apariencia de la ramaConfigurar la página de estado pública
Página de estado públicaConfiguración › Página de estadoConfigurar la página de estado pública

Etiquetar recursos​

Las etiquetas son pares key:value en los recursos, como env:prod, role:sql o client:ciguapa. Un recurso vive en un solo lugar del árbol, pero las etiquetas te permiten agruparlo con otros desde cualquier parte del árbol.

Para etiquetar un recurso:

  1. Abre el recurso y selecciona Editar. Cuando agregas un recurso, el asistente tiene un paso Etiquetas que funciona igual.
  2. En Etiquetas, escribe pares key:value separados por espacios, por ejemplo env:prod role:sql client:ciguapa. Las claves usan letras, dígitos, punto, guion y guion bajo, y cada clave aparece una sola vez.
  3. Establece la Criticidad, de 1 (baja) a 5 (crítica). Es un campo propio, no una etiqueta, y se usa para el enrutamiento, el riesgo y la puntuación de seguridad.
  4. Selecciona Guardar.

Usa al menos env, role y client en cada recurso, y establece la criticidad.

Para usar las etiquetas:

  • En Recursos, escribe una Regla de etiquetas. role:sql env:prod muestra los recursos que tienen ambas; una clave sola, como client, muestra todos los recursos que tienen esa clave.
  • En la Vista general, elige la vista Hexágonos y Agrupar por una clave de etiqueta para ver un grupo de hexágonos por valor.

Hacerlo con la API​

TareaSolicitud
CrearPOST /api/v1/entities con parent_id, name y, opcionalmente, kind y slug
Cambiar el nombre o el tipoPATCH /api/v1/entities/{id} con name o kind
MoverPATCH /api/v1/entities/{id} con parent_id
EliminarDELETE /api/v1/entities/{id}; responde 409 con el motivo mientras la entidad no esté vacía
Etiquetar un recursoPATCH /api/v1/resources/{id} con tags, un objeto como {"env": "prod", "role": "sql"}, y criticality