Modelo de segurança
O Excubius não tem senhas próprias para a sua equipe: as pessoas entram com a conta Microsoft ou Google que a sua organização já gerencia. O que elas podem ver e fazer depois depende da função que têm em cada ramo da árvore de entidades, verificada de novo a cada solicitação. Os segredos de que o coletor precisa são armazenados criptografados e nunca podem ser lidos de volta. Este artigo explica cada camada.
Entrada
O Excubius usa o OpenID Connect com o Microsoft Entra ID (um locatário) e o Google, pelo fluxo de código de autorização com PKCE, state e nonce. Nenhum SDK de provedor e nenhum serviço de identidade pago são usados.
- O token de ID é validado a cada entrada: a assinatura em relação às chaves que o provedor publica, o emissor (no Entra ID, o seu locatário), o público, a expiração e o
noncedessa entrada. - A entrada em andamento é guardada em um cookie assinado e HttpOnly que dura 10 minutos. A página para a qual voltar depois da entrada precisa ser uma página do mesmo site, de modo que um link forjado não consegue mandar ninguém para outro lugar.
- As contas são identificadas pelo provedor e pelo assunto, a ID de objeto do usuário no Entra ID ou o assunto do Google, nunca apenas pelo endereço de e-mail.
- Quem pode receber uma conta é decidido por entidade: por convite ou por um domínio de e-mail permitido. 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.
- Os segredos dos provedores vêm apenas da configuração do servidor. Eles, os códigos de autorização e os tokens nunca são armazenados no banco de dados, retornados pela API nem gravados em logs.
| Provedor | Planos |
|---|---|
| Free, Core, Pro, Enterprise | |
| Microsoft Entra ID | Core, Pro, Enterprise |
| Grupos do Microsoft Entra ID como titulares de funções | Enterprise |
Autenticação multifator
A MFA é imposta pelo seu provedor de identidade: o Acesso Condicional do Entra ID ou a Verificação em duas etapas do Google. O Excubius ainda não inspeciona as declarações de MFA, então exija MFA no provedor para todos que podem entrar e, principalmente, para os administradores de entidade.
Sessões e tokens
Uma entrada bem-sucedida define dois cookies, ambos HttpOnly, Secure por HTTPS e SameSite=Lax:
| Token | Tempo de vida | Finalidade |
|---|---|---|
| Token de acesso | 15 minutos | Comprova quem você é a cada solicitação |
| Token de atualização | 14 dias | Obtém um novo par de tokens; cada atualização emite um novo par |
As permissões não viajam no token. Elas são lidas do banco de dados a cada solicitação, então desativar um usuário, remover uma função ou alterar a atribuição de um grupo tem efeito na próxima solicitação dessa pessoa. A participação em grupos do diretório é lida de novo a cada entrada.
Ainda não é possível revogar os tokens de atualização um a um. Para encerrar o acesso de alguém antes que a sessão expire, desative o usuário. Sair do Excubius não faz você sair da Microsoft nem do Google.
Ainda não há chaves de API: nesta versão, scripts e outras ferramentas não podem chamar a API em nome próprio.
Funções na árvore de entidades
Uma função é atribuída a uma pessoa, ou a um grupo do diretório, em uma entidade e se aplica a essa entidade e a tudo o que está abaixo dela. Uma pessoa pode ser Entity admin de um cliente e Operator de outro. Em qualquer entidade, a função efetiva é a mais alta encontrada na entidade e nos ancestrais dela, contando as funções da própria pessoa e as dos grupos dela.
| Função | Pode |
|---|---|
| Viewer (Visualizador) | Ler painéis, alertas, descobertas e detalhes de recursos; alterar as próprias configurações |
| Operator (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 |
| Entity admin (Administrador de entidade) | Tudo o que um editor pode, além de gerenciar as entidades, os padrões das entidades, os recursos, as credenciais, as fontes, as pessoas, as funções, os convites, os canais de notificação, as configurações do Jira e a página de status do ramo |
| Super admin (Superadministrador) | Tudo, em todos os ramos, além das configurações de toda a instalação. Atribuída somente na raiz, por outro superadministrador |
O que isso significa na prática:
- Toda lista se limita aos seus ramos: entidades, recursos, alertas, o painel Overview, credenciais, canais e pessoas. Se as suas funções começam em Veredas Ltda., a árvore de entidades que você vê também começa ali.
- Tudo o que está fora dos seus ramos não existe para você: abrir o endereço responde Not found, or no longer visible to you. Algo que você pode ver, mas não alterar, responde Your role does not allow this.
- Atribuir funções fica dentro do seu ramo e do seu nível: um administrador de entidade pode convidar pessoas e atribuir funções apenas nas entidades que administra, e nunca uma função acima da própria.
- Uma credencial pertence à entidade que a possui e pode ser usada pelos recursos dessa entidade e das inferiores. Apontar o coletor para um host com uma credencial exige a função de administrador de entidade na entidade da credencial, de modo que o administrador de um cliente não consegue apontar um logon compartilhado de cima para um host de sua escolha.
Entidades, marcas e herança explica a própria árvore.
Segredos
As credenciais de monitoramento, as chaves de API das fontes, os segredos de cliente e as chaves dos certificados carregados são somente gravação:
- Eles são criptografados no banco de dados com AES e uma assinatura HMAC (Fernet), usando uma chave que o instalador gera e guarda no arquivo de configuração do servidor, não no banco de dados. Um dump do banco de dados sozinho não revela nenhum segredo.
- As telas e a API dizem apenas se um segredo está definido, por exemplo stored — leave empty to keep it. Ninguém consegue ler um segredo de volta, seja qual for a função.
- Um segredo é descriptografado no servidor, ou enviado ao coletor pela rede interna do servidor quando uma verificação precisa dele. O coletor o mantém na memória e nunca o registra em log.
- O contêiner do coletor recebe apenas o próprio token e as próprias configurações: nunca a senha do banco de dados, o segredo de assinatura de sessões nem a chave de criptografia. As rotas do coletor são recusadas na borda do servidor, então ele só pode ser acessado de dentro.
As próprias credenciais são provisionadas sem direitos de gravação ou de instalação nos sistemas monitorados; veja Arquitetura.
Auditoria
Toda alteração feita pela API é gravada no log de auditoria com o usuário que a fez, o horário e o endereço IP da solicitação. Para entrada e acesso, isso inclui:
| Evento | Registrado como |
|---|---|
| Uma entrada | login |
| Uma recusa depois que o provedor respondeu, com o motivo | login.failed |
| Uma conta criada na primeira entrada | user.create |
| Um convite criado, aceito ou excluído | invitation.create, invitation.accept, invitation.delete |
| Uma função atribuída ou removida | role.grant, role.revoke |
| Uma mudança do modo de registro | registration.update, registration.reset |
| Uma alteração em um usuário ou nas preferências dele | user.update, user.preferences |
As ações sobre alertas, as alterações de limites, as alterações de fontes, as janelas de manutenção e as edições da página de status são auditadas da mesma forma. O log de auditoria é mantido no banco de dados da plataforma.