O agente do SentinelWeb: conta ao painel o que cada máquina Linux é e como ela está, e desliga, reinicia ou suspende quando o painel pede.
O SentinelAgente é um serviço do systemd que fica em cada computador e conversa com o SentinelWeb. Ele diz ao painel o que a máquina é e como ela está, e executa os três comandos de energia que o painel oferece. A série que ele lê do firmware liga a máquina ao computador cadastrado com ela no SentinelWeb. É para quem cuida da TI e usa o SentinelWeb: quem guarda e mostra é o painel.
Note
Só Linux: Ubuntu 24.04 ou mais novo, em amd64 ou arm64. Fala só com o SentinelWeb, e o log é em português
do Brasil. Roda como root, e o .deb se monta a partir do código-fonte.
- Quem a máquina é, a cada conexão, uma vez por dia e no Atualizar agora: o nome, o sistema, o
processador, o MAC e o IP da placa da rota padrão, a série, o UUID, o fabricante e o modelo, as placas de
vídeo e a versão do agente. Valor de fábrica, como
To Be Filled By O.E.M., não vai. - Como ela está, de hora em hora e no Atualizar agora: a CPU, na média desde a leitura anterior, a memória e cada disco local.
- Um id só da instalação, sorteado no primeiro arranque e guardado em
/var/lib/sentinel-agent/hwid. A máquina reinstalada, o SentinelWeb reconhece pela série e pelo UUID. - O que não vai: os programas instalados, o usuário logado, a telemetria de rede, os processos e o uso da placa de vídeo. A leitura feita sem conexão se perde: nada fica guardado para depois.
- Nada escondido: o agente aparece como
sentinel-agentnopse nosystemctl status, e para comsystemctl stop. - Só
wss://, com o certificado sempre conferido; ows://, sem criptografia, só vale com o SentinelWeb na mesma máquina, como em desenvolvimento. Cada máquina tem o seu token, que o cadastro troca pelo segredo de instalação, e o agente apaga o segredo depois.
De onde sai cada campo, e o que o SentinelWeb faz com ele, está em
protocolo.md.
| No painel | No agente |
|---|---|
| Desligar | systemctl poweroff |
| Reiniciar | systemctl reboot |
| Suspender | systemctl suspend |
| Atualizar agora | manda na hora quem a máquina é e como ela está |
O /usr/bin/systemctl roda direto, sem shell, e os bloqueios do logind valem. Qualquer outro comando é
recusado e vai para o log (journalctl -u sentinel-agent), que diz também, com o id do comando, se o systemd
aceitou ou por que recusou. O SentinelWeb não guarda comando para depois: a máquina desconectada não recebe
nada.
flowchart LR
navegador["Navegador"] -- "/api" --> api["SentinelWeb<br/>API e painel"]
agente["SentinelAgente<br/>em cada máquina"] -- "WebSocket /agent-hub" --> api
api --> banco[("PostgreSQL")]
O agente é C# com .NET 10, fica conectado ao SentinelWeb e reconecta sozinho quando a conexão cai.
Monte o .deb num clone do repositório, com o SDK do .NET 10:
./packaging/build-deb.sh # artifacts/sentinel-agent_<versão>_amd64.deb
./packaging/build-deb.sh arm64 # para ARMLeve o pacote para a máquina e instale com o endereço do SentinelWeb e o segredo de instalação, o
AGENT_ENROLL_SECRET de lá. O SentinelWeb atende em HTTP: o wss:// precisa de um proxy com TLS na frente dele.
sudo SENTINEL_URL=wss://<servidor>/agent-hub SENTINEL_ENROLL_SECRET=<segredo> \
apt install ./sentinel-agent_<versão>_amd64.deb
systemctl status sentinel-agent
journalctl -u sentinel-agent -fO apt traz o runtime do .NET junto. Instalar sem o segredo no ps, o servidor com certificado interno,
atualizar, recadastrar e remover estão em instalar-o-agente.md.
Precisa do SDK do .NET 10.
dotnet build
dotnet test # os testes leem o testdata/ e não pedem root
dotnet formatRodar o agente na máquina de desenvolvimento, contra um SentinelWeb local, está em
preparar-o-ambiente.md.
docs/README.md: o mapa da documentação e por onde entrar.arquitetura.md: as pastas, o que cada uma guarda e quem usa quem.protocolo.md: o que o agente manda e recebe, e o que o SentinelWeb faz com isso.decisoes/: o porquê de cada regra.
Dúvida ou bug: abra uma issue.
GNU GPL, versão 3 ou posterior (GPL-3.0-or-later). Qualquer um pode usar, alterar e
redistribuir. Quem distribuir o agente, alterado ou não, oferece o código-fonte junto, com a mesma licença. Vem
sem garantia nenhuma. As bibliotecas do .NET que vão no pacote seguem com a licença delas, a MIT. O porquê da
escolha está na A29.