Entidades, marcas e herança
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ção | Defina em | Substituída por |
|---|---|---|
| Limites de todas as verificações | Qualquer entidade | Uma entidade inferior ou um único recurso |
| Canais de notificação (Slack) | Qualquer entidade | Uma entidade inferior que tenha canais próprios |
| Janelas de manutenção | Qualquer entidade ou um recurso | — as janelas se somam |
| Funções de usuários e de grupos do diretório | Qualquer entidade | — prevalece a função mais alta do caminho |
| Tema e logotipo padrão | Qualquer entidade | Uma entidade inferior ou o tema do próprio usuário |
| Modo de registro de novos usuários | Qualquer entidade | Uma entidade inferior |
| Configurações do Jira: projeto, tipo de item, prioridades, rótulos | Qualquer entidade | Uma entidade inferior |
| Pesos das áreas da pontuação de segurança | Qualquer entidade | Uma entidade inferior |
| Credenciais | Qualquer 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.
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ção | Pode |
|---|---|
| Visualizador | Ler painéis, alertas e detalhes de recursos; alterar as próprias configurações |
| Operador | Tudo o que um visualizador pode, além de confirmar, silenciar, atribuir e resolver alertas, criar tickets do Jira e planejar janelas de manutenção |
| Editor | Tudo 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 entidade | Tudo 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:
| Modo | O que acontece |
|---|---|
| By invitation | O 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 domains | Qualquer 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.