Pular para o conteúdo principal
Versão: 0.4 · atual

Entidades, marcas e herança

ConceitoRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Visualizador, Operador, Editor, Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

O Excubius coloca cada recurso em exatamente um nó de uma árvore de entidades e permite agrupar recursos de qualquer parte da árvore com marcas. As configurações descem pela árvore: o que um nó define, tudo o que está abaixo dele herda, até que um nó inferior ou um único recurso o substitua.

A árvore de entidades​

Uma entidade é um nó que representa o que a sua organização precisar: uma empresa, um cliente, um ambiente, uma equipe. O Excubius oferece os tipos root, tenant, client, environment e group, mas eles são rótulos, não regras, então use quantos níveis forem necessários.

Neste exemplo, a Pelourinho Digital é um provedor de serviços gerenciados na raiz. Cada cliente tem o próprio ramo, e cada ramo é dividido em ambientes. As duas instâncias do SQL Server aparecem uma única vez na árvore, abaixo do grupo de disponibilidade a que pertencem.

Mover um recurso ou uma entidade para outro nó muda o que ele herda a partir desse momento. O log de auditoria registra cada movimentação.

O que é herdado​

ConfiguraçãoDefina emSubstituída por
Limites de todas as verificaçõesQualquer entidadeUma entidade inferior ou um único recurso
Canais de notificação (Slack)Qualquer entidadeUma entidade inferior que tenha canais próprios
Janelas de manutençãoQualquer entidade ou um recurso— as janelas se somam
Funções de usuários e de grupos do diretórioQualquer entidade— prevalece a função mais alta do caminho
Tema e logotipo padrãoQualquer entidadeUma entidade inferior ou o tema do próprio usuário
Modo de registro de novos usuáriosQualquer entidadeUma entidade inferior
Configurações do Jira: projeto, tipo de item, prioridades, rótulosQualquer entidadeUma entidade inferior
Pesos das áreas da pontuação de segurançaQualquer entidadeUma entidade inferior
CredenciaisQualquer entidade— utilizáveis pelos recursos dessa entidade e das inferiores

A tela que edita um valor sempre mostra de onde vem o valor efetivo: a linha de base do catálogo, uma entidade pelo nome ou este recurso. Assim, ninguém precisa adivinhar por que um servidor gera alerta em 70% e outro em 80%.

Como um limite é resolvido​

O Excubius parte da linha de base que a entrada do catálogo da verificação declara, com a origem dela (documentação da Microsoft, CIS Benchmark, recomendações do Azure Monitor, prática da comunidade de DBAs ou o seu RPO e RTO). Cada entidade do caminho até o recurso pode substituir um valor; o próprio recurso pode substituí-lo por último. Prevalece o valor mais específico. Limites e linhas de base explica os detalhes.

dica

Defina os limites o mais alto possível na árvore e substitua apenas as exceções. Uma regra definida uma vez em Produção cobre todos os servidores adicionados ali depois.

Marcas​

Marcas são rótulos key:value nos recursos, como env:prod, role:sql ou client:ciguapa. Um recurso fica em um único lugar da árvore, mas as marcas permitem encontrá-lo de qualquer ângulo sem duplicá-lo.

Use marcas para o que atravessa a árvore: todos os SQL Server de produção de todos os clientes, tudo o que guarda dados pessoais, tudo o que tem um servidor vinculado. Hoje, você as usa para filtrar a lista de recursos com uma regra de marcas, como env:prod role:sql, e para agrupar a exibição Hex do painel Overview. Exibições salvas que fixam uma regra de marcas estão planejadas.

Marcas mínimas recomendadas: env, role e client. Atribua também a cada recurso a Criticality (criticidade), de 1 (baixa) a 5 (crítica): ela pondera o recurso na pontuação de segurança e destaca no painel Overview os recursos críticos com problemas.

As funções também seguem a árvore​

Uma função é atribuída a um usuário ou a um grupo do diretório em um nó e se aplica a tudo o que está abaixo dele. Uma pessoa pode ser Administrador de entidade de um cliente e Operador de outro. Em qualquer nó, a função efetiva é a mais alta encontrada no nó e nos ancestrais dele, contando as funções da própria pessoa e as dos grupos do diretório dela.

FunçãoPode
VisualizadorLer painéis, alertas e detalhes de recursos; alterar as próprias configurações
OperadorTudo o que um visualizador pode, além de confirmar, silenciar, atribuir e resolver alertas, criar tickets do Jira e planejar janelas de manutenção
EditorTudo o que um operador pode, além de alterar as verificações e os limites dos recursos e aceitar riscos de segurança
Administrador de entidadeTudo o que um editor pode, além de gerenciar as entidades, os limites padrão, os recursos, as credenciais, as fontes, os usuários, as funções, os convites, o registro, os canais, as configurações do Jira e a página de status do ramo

A função Super admin (Superadministrador), atribuída somente na raiz, cobre todos os ramos e as configurações de toda a instalação.

O que a árvore significa para o que você vê:

  • As listas contêm apenas o que está nos seus ramos: entidades, recursos, alertas, o painel Overview, credenciais, canais e usuários. Se as suas funções começam em Veredas Ltda., a sua árvore de entidades também começa ali.
  • Tudo o que pertence a outro ramo não existe para você. Algo que você pode ver, mas não alterar, como um alerta para um visualizador, mostra Your role does not allow this.
  • As funções são lidas a cada solicitação: remover uma função ou desativar um usuário tem efeito na próxima solicitação dele.
  • Os administradores de entidade atribuem funções apenas nas entidades que administram, e nunca uma função acima da própria.

As credenciais pertencem a uma entidade​

Uma credencial, como um logon de monitoramento, pertence à entidade em que foi criada e pode ser usada pelos recursos dessa entidade e de todas as entidades abaixo dela. Decidir onde o coletor se conecta com ela é reservado aos administradores da entidade da credencial: criar um recurso, ou alterar os detalhes de conexão, o pai ou a credencial dele, exige a função de administrador de entidade na entidade de cada credencial que o coletor poderia usar a partir daí. Caso contrário, o administrador de um cliente poderia apontar um logon compartilhado de cima para um host de sua escolha.

Grupos do diretório​

Com o Microsoft Entra ID, uma função pode ser atribuída em uma entidade a um grupo do diretório, chamado entra: seguido da ID de objeto do grupo, em vez de a cada pessoa. O Excubius lê os grupos de uma pessoa a cada entrada, então adicionar alguém ao grupo dá a essa pessoa a função na próxima entrada, e removê-la do grupo tira a função nesse momento. Para cortar o acesso na hora, desative o usuário. Os grupos do diretório fazem parte do plano Enterprise. Grupos do Active Directory ou do LDAP, a sincronização pelo Microsoft Graph para pessoas em mais de 200 grupos e grupos criados no Excubius estão planejados.

Quem pode entrar, por entidade​

Cada entidade decide como novas pessoas recebem uma conta, e as entidades abaixo dela herdam a escolha até que uma defina a própria:

ModoO que acontece
By invitationO padrão. Um administrador envia um link; a pessoa entra com a Microsoft ou o Google e recebe a função do convite. Ninguém mais entra
Allowed domainsQualquer pessoa cujo endereço corporativo esteja em um dos domínios listados recebe uma conta na primeira entrada, com a Default role (Visualizador, a menos que outra seja definida) na entidade que define o modo. Adequado para a equipe interna

Uma conta do Google conta para um domínio somente quando é uma conta do Google Workspace desse domínio; contas pessoais do Google sempre precisam de convite. O registro que aguarda a aprovação de um administrador está planejado.