Registro (enrollment)
Depois de instalado, o agente precisa ser registrado uma vez para se vincular à sua organização na Zarv. O registro troca uma chave de enrollment de uso único por uma identidade persistente do dispositivo.
Passo a passo
- Gere a chave de enrollment no painel da Zarv, na área de edge-servers. A chave é de uso único e tem validade curta.
- Abra a interface local do agente em
http://localhost:8088. No primeiro boot, ela exibe a tela de registro. - Cole a chave e confirme. O agente troca a chave por sua identidade, persiste localmente e passa a operar sob controle da Zarv.
- Pronto — o dispositivo aparece como registrado no painel e começa a enviar heartbeats.
Chave por variável de ambiente
Para provisionamento automatizado, a chave também pode ser fornecida via EDGE_AGENT_ENROLLMENT_TOKEN em /etc/default/zarv-agent. O agente a consome no primeiro boot e a remove em seguida.
O que acontece nos bastidores
- O agente troca a chave por uma identidade (
instance_id+ tokens) junto à Zarv e persiste essa identidade no banco local em/var/lib/zarv-agent. - Em boots seguintes ele não repete o registro: usa a identidade já persistida para renovar suas credenciais automaticamente.
- O vínculo é por dispositivo; cada agente tem sua própria identidade.
Estados após o registro
A interface local e o painel da Zarv refletem o estado do agente:
| Estado | Significado |
|---|---|
registered | Identidade válida persistida. |
online | Conectividade de saída OK (verificada por sondagem periódica). |
paused | A Zarv suspendeu a coleta; o agente segue autenticado, sem enviar eventos. |
revoked | O acesso foi cancelado na Zarv — é necessário re-registrar. |
Re-registro após revogação
Se o dispositivo for revogado no painel da Zarv, o agente detecta a revogação na próxima sincronização, para de enviar dados e passa a exibir um aviso de "registro necessário" na interface local.
Para reativar:
- Gere uma nova chave de enrollment no painel.
- Abra
http://localhost:8088e cole a nova chave (mesmo fluxo do primeiro registro).
O agente limpa o estado de revogação e volta a operar com a nova identidade.