Developers

Aparência

Vai integrar o Zarv Agent (on-premise) com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar o Zarv Agent (on-premise). Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/edge-agent/enrollment
- Instalação: https://developers.zarv.com/edge-agent/installation
- Registro: https://developers.zarv.com/edge-agent/enrollment
- Configuração: https://developers.zarv.com/edge-agent/configuration
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

O agente é um software instalado em máquina do cliente, não uma API que você chama: siga os passos de instalação, registro e configuração na ordem documentada, e use os arquivos e comandos exatamente como aparecem nas páginas.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: instalar, registrar e configurar o agente no meu ambiente]

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.

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:

EstadoSignificado
registeredIdentidade válida persistida.
onlineConectividade de saída OK (verificada por sondagem periódica).
pausedA Zarv suspendeu a coleta; o agente segue autenticado, sem enviar eventos.
revokedO 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 ​