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_ONLYtruepara só consultarSENTINELA_CSCLI_MODEexec,dockerounoneSENTINELA_COOKIE_SECUREtrueatrás de um proxy com TLSSENTINELA_AUTH_MODElocal, ouproxyatrá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.