---
url: https://developers.zarv.com/edge-agent/enrollment.md
---
# 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

1. **Gere a chave de enrollment** no painel da Zarv, na área de edge-servers.
   A chave é de uso único e tem validade curta.
2. **Abra a interface local** do agente em `http://localhost:8088`. No primeiro
   boot, ela exibe a tela de registro.
3. **Cole a chave** e confirme. O agente troca a chave por sua identidade,
   persiste localmente e passa a operar sob controle da Zarv.
4. Pronto — o dispositivo aparece como registrado no painel e começa a enviar
   heartbeats.

::: tip 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:

1. Gere uma **nova** chave de enrollment no painel.
2. Abra `http://localhost:8088` e 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.

## Próximos passos

* [Atualizações automáticas](/edge-agent/updates)
* [Solução de problemas](/edge-agent/troubleshooting)