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

Ativar os módulos de segurança

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Superadministrador, Administrador de entidade, Editor
PlanosPro · EnterpriseImplantaçãoAuto-hospedado

Os módulos de segurança procuram pontos fracos nas suas instâncias do SQL Server, nas suas identidades e nas suas assinaturas do Azure, e acrescentam descobertas do Microsoft Defender for Cloud e do Wazuh. Todas as verificações apenas leem; uma descoberta vem com as evidências e uma ação sugerida para uma pessoa executar, e nada é alterado em seu nome. Este guia mostra como ativar os módulos, conceder a eles acesso somente leitura, ponderar a pontuação e aceitar um risco.

Plano

Os módulos de segurança e a pontuação de segurança fazem parte do plano Enterprise e são um complemento no plano Pro.

Antes de começar​

  • Para ativar os módulos, você precisa da função Super admin (superadministrador).
  • Para adicionar recursos e credenciais e para definir os pesos da pontuação, você precisa da função Entity admin (administrador de entidade) na entidade.
  • Para aceitar um risco, você precisa da função Editor ou superior na entidade da descoberta.
  • Leia Postura de segurança para saber o que é uma descoberta, como a pontuação é calculada e o que cada verificação detecta.

Ativar os módulos​

  1. Abra Settings › Instance.

  2. Em Features, no grupo Security, ative o que você precisa:

    Opção de recursoEfeito
    securityA página Security posture, as descobertas e a pontuação, com os módulos de bancos de dados, identidade e nuvem
    security.recommendationsAs recomendações do Defender for Cloud (avaliações de severidade média e baixa) são exibidas, contadas na pontuação e listadas na caixa de entrada. Quando desativada, restam apenas as avaliações de severidade alta, como descobertas
    security.defenderColeta das avaliações do Defender for Cloud. Desativada por padrão
    security.wazuhColeta dos alertas e das vulnerabilidades do Wazuh. Desativada por padrão
  3. Opcionalmente, ative collab.jira para que as descobertas possam ser enviadas ao Jira.

As outras três opções exigem security. Desativar o Defender ou o Wazuh interrompe a coleta; as descobertas já geradas continuam abertas até serem resolvidas.

Adicionar as verificações aos recursos existentes​

Os recursos que você adicionar a partir de agora recebem imediatamente as verificações de segurança do tipo deles. Os recursos que já existiam antes da ativação dos módulos precisam que as verificações que faltam sejam adicionadas uma vez, pela API:

curl -s "${H[@]}" -X POST "$BASE/resources/$SQL01/checks" -d '{"check_ids": []}' \
| jq -r '.[].check_id' | grep security

Uma lista vazia adiciona todas as verificações padrão que faltam para o tipo do recurso. Os bancos de dados e os grupos de disponibilidade descobertos recebem as deles no próximo Discover da instância. $BASE e H são definidos como em Início rápido: adicionar uma instância do SQL Server com a API.

Conceder acesso somente leitura aos módulos​

Banco de dados​

As verificações de segurança do SQL Server usam o logon de monitoramento da instância. Ele precisa de VIEW SERVER STATE, VIEW ANY DEFINITION, CONNECT ANY DATABASE e SELECT em msdb.dbo.backupset, e de nada mais. Consulte Armazenar uma credencial para o coletor.

Identidade​

  1. Adicione um recurso do tipo Entra ID tenant / domain services com o tenant_id do locatário, abaixo da entidade à qual ele pertence, por exemplo Veredas Ltda..
  2. Conceda a ele acesso de leitura ao Microsoft Graph, de uma destas duas formas:
    • Um registro de aplicativo com as permissões de aplicativo do Microsoft Graph RoleManagement.Read.Directory, AuditLog.Read.All e IdentityRiskEvent.Read.All, todas somente leitura, com consentimento do administrador. Armazene-o como uma credencial do tipo Azure service principal: o ID do cliente, o segredo do cliente e o tenant_id. Escolha-a como a credencial do recurso.
    • As mesmas permissões concedidas à identidade gerenciada do servidor do Excubius.
  3. Para as verificações do Active Directory, forneça uma conta de domínio somente leitura (tipo de credencial Windows account) em um host que tenha o módulo Active Directory PowerShell, acessado por WinRM.

Os detalhes de registro da autenticação multifator exigem o Microsoft Entra ID P1 ou P2; as detecções de risco completas exigem o P2.

Nuvem​

As verificações do Azure leem por meio do Azure Resource Graph e do Defender for Cloud, com a identidade gerenciada do servidor ou com um registro de aplicativo armazenado como uma credencial Azure service principal:

  • Reader em cada assinatura, para as verificações do Resource Graph.
  • Security Reader em cada assinatura, para o Defender for Cloud.

Com um registro de aplicativo, o atributo subscriptions da credencial, definido pela API, limita quais assinaturas são lidas; caso contrário, aplica-se a configuração AZURE_SUBSCRIPTION_IDS do servidor. Consulte Solicitar o servidor do Azure para ver as funções e os IDs delas.

As verificações do Resource Graph consideram o resource_id do recurso: um recurso, um grupo de recursos ou uma assinatura inteira, como /subscriptions/<id>.

Defender for Cloud e Wazuh​

As avaliações do Defender for Cloud, as alterações nas atribuições de funções do Azure, as descobertas do Wazuh e a varredura das imagens da própria plataforma são executadas em um recurso do tipo Monitoring platform itself. Se ainda não tiver um, adicione-o com Resources › Add resource, por exemplo abaixo da entidade raiz. As descobertas são então vinculadas ao recurso a que se referem: as do Defender, ao recurso do inventário cujo resource_id corresponde; as do Wazuh, ao host cujo nome, nome de host, endereço IP ou nome de máquina corresponde ao agente.

Para o Wazuh:

  1. Crie um usuário somente leitura do Wazuh com acesso de leitura aos índices wazuh-alerts-* e wazuh-states-vulnerabilities-* e, opcionalmente, agents:read na API do gerenciador.

  2. Armazene-o em Settings › Credentials com o tipo HTTP user and password. Se o certificado do indexador não for confiável para o servidor, crie a credencial pela API, com "attributes": {"verify_tls": false}; o console não tem um campo para isso.

  3. Aponte a verificação para o seu indexador do Wazuh e atribua a ela a credencial, pela API:

    curl -s "${H[@]}" -X PATCH "$BASE/resources/$PLATFORM/checks/security_cloud.wazuh_alerts" -d '{
    "params": {"indexer_url": "https://wazuh.areito.example:9200",
    "api_url": "https://wazuh.areito.example:55000"},
    "credential_id": "'"$WAZUH_CRED"'"
    }'

O cliente do Wazuh envia apenas pesquisas e a chamada de autenticação do gerenciador; qualquer outra coisa é recusada no código. O Excubius nunca implanta agentes do Wazuh; quem faz isso são as suas próprias ferramentas.

Ponderar as áreas da pontuação​

A pontuação geral é a média das áreas avaliadas, identidade, bancos de dados e nuvem, com peso 1 para cada uma por padrão. Uma entidade pode definir os próprios pesos, de 0 a 100, e todas as entidades abaixo dela os herdam. Não há uma tela para isso nesta versão; use a API:

# Ciguapa cares most about its databases
curl -s "${H[@]}" -X PUT "$BASE/entities/$CIGUAPA/security/score-weights" \
-d '{"identity": 1, "database": 3, "cloud": 1}'

# back to the inherited weights
curl -s "${H[@]}" -X PUT "$BASE/entities/$CIGUAPA/security/score-weights" -d '{}'

GET /entities/{id}/security/score-weights mostra os pesos próprios da entidade e os efetivos.

Aceitar um risco​

Quando uma descoberta é conhecida e aceitável por um tempo, por exemplo xp_cmdshell habilitado para um trabalho legado até que ele seja substituído, aceite o risco em vez de deixá-la aberta.

  1. Abra Security posture e selecione a descoberta.
  2. Selecione Accept risk….
  3. Escreva o Reason: por que o risco é aceitável e o que o atenua, de 3 a 2.000 caracteres.
  4. Em Accepted for, escolha um número de dias ou Until a date. O término deve estar dentro de um ano.
  5. Selecione Accept risk.

A descoberta sai da lista de itens abertos e deixa de contar na pontuação. Ela continua sendo verificada e é reaberta automaticamente quando a aceitação termina, ou antes, se a severidade aumentar. A decisão fica registrada com o seu nome, a data, o término e a forma como terminou.

Para encerrar uma aceitação antes do prazo, abra a descoberta e selecione Reopen.

Algumas descobertas são alterações, e não condições, como um novo membro de sysadmin ou uma nova atribuição da função Owner. Elas não podem ser aceitas: revise a alteração e resolva a descoberta manualmente.

Publicar uma varredura das imagens da plataforma​

A verificação security_cloud.platform_images relata vulnerabilidades críticas nas imagens de contêiner do próprio Excubius. Gere um relatório com trivy image --format json <image> e envie-o para POST /api/v1/security/platform-report; isso exige a função Super admin. Vale o relatório mais recente de cada imagem.