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

Modelo de segurança

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

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 nonce dessa 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.
ProvedorPlanos
GoogleFree, Core, Pro, Enterprise
Microsoft Entra IDCore, Pro, Enterprise
Grupos do Microsoft Entra ID como titulares de funçõesEnterprise

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:

TokenTempo de vidaFinalidade
Token de acesso15 minutosComprova quem você é a cada solicitação
Token de atualização14 diasObté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.

observação

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çãoPode
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
EditorTudo 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:

EventoRegistrado como
Uma entradalogin
Uma recusa depois que o provedor respondeu, com o motivologin.failed
Uma conta criada na primeira entradauser.create
Um convite criado, aceito ou excluídoinvitation.create, invitation.accept, invitation.delete
Uma função atribuída ou removidarole.grant, role.revoke
Uma mudança do modo de registroregistration.update, registration.reset
Uma alteração em um usuário ou nas preferências deleuser.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.