Sentinela

Documentação

O essencial para pôr a Sentinela a trabalhar e a mantê-la segura. A referência completa, em inglês, está no README.

Como fala com o CrowdSec

Usa três fontes, todas opcionais. Uma página cuja fonte falta diz o que configurar em vez de falhar.

API local (LAPI)
decisões e alertas, com uma conta de máquina (cscli machines add)
Métricas Prometheus
contadores do AppSec e regras que dispararam, em :6060/metrics
cscli
hub, allowlists, bouncers, máquinas e reload, corrido com sudo ou dentro do contentor

Os comandos do cscli são executados a partir de uma lista fixa, sem shell, e todos os valores (IPs, nomes, durações, comentários) são validados antes.

Configuração

Com o instalador, a configuração fica em /etc/sentinela/sentinela.env. Depois de mudar alguma coisa: sudo systemctl restart sentinela. As variáveis mais usadas:

SENTINELA_LISTEN
endereço e porta, por omissão 127.0.0.1:8095
SENTINELA_READ_ONLY
true para só consultar
SENTINELA_CSCLI_MODE
exec, docker ou none
SENTINELA_COOKIE_SECURE
true atrás de um proxy com TLS
SENTINELA_AUTH_MODE
local, ou proxy atrás do Authelia ou do oauth2-proxy

A lista completa está na secção Configuration.

Contas

Há dois papéis: admin, que altera, e viewer, que só consulta. Para criar uma conta, ou trocar a palavra-passe e o TOTP de uma existente:

sudo sentinela-admin user ana viewer

As palavras-passe são guardadas com bcrypt. O TOTP funciona com qualquer app autenticadora (Aegis, 2FAS, Google Authenticator, 1Password).

Segurança

Quem entra na Sentinela pode desbloquear atacantes e remover regras. Por isso:

  • não a exponha na Internet, nem a LAPI: use 127.0.0.1 com túnel SSH, uma VPN, ou um proxy com SSO;
  • active o TOTP, ou o 2FA do SSO;
  • se só precisa de decisões, alertas e métricas, use SENTINELA_CSCLI_MODE=none;
  • com o CrowdSec em Docker, lembre-se de que o acesso ao socket do Docker equivale a root.

Cada alteração (quem, de que IP, o quê) fica no registo do serviço: journalctl -u sentinela. O modelo de ameaças está em Security and threat model. Falhas de segurança reportam-se em privado.

Problemas comuns

“incorrect Username or Password” nas decisões

Versões anteriores à 0.2.0 enviavam um User-Agent que o CrowdSec recusa. Actualize: sudo sentinela-admin update.

O CrowdSec não arranca depois de instalado

Normalmente a porta 8080 já está ocupada. Mude listen_uri em /etc/crowdsec/config.yaml e url em /etc/crowdsec/local_api_credentials.yaml, reinicie o CrowdSec e corra o instalador de novo.

A página AppSec está vazia

O componente AppSec não está activo, ou ainda não recebeu pedidos desde que o CrowdSec arrancou. Os contadores vêm do Prometheus e voltam a zero quando o CrowdSec reinicia.

“cross-origin request detected” ao entrar

Acontecia nas versões 0.1.0 e 0.1.1 quando a interface era servida por HTTP simples. Actualize para a versão mais recente.