Skip to content
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/agent/enrollment
- Instalação: https://developers.zarv.com/agent/installation
- Registro: https://developers.zarv.com/agent/enrollment
- Configuração: https://developers.zarv.com/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 ​

Depois de instalado, o agente precisa ser registrado uma vez para se vincular ao seu workspace na Zarv. O registro troca o token de acesso do workspace por uma identidade persistente do dispositivo.

Passo a passo ​

  1. Copie o token de acesso do workspace no painel da Zarv, na área de agentes. O token é o mesmo para todos os agentes do workspace e pode ser reutilizado.
  2. Abra a interface local do agente em http://localhost:8088. No primeiro boot, ela exibe a tela de registro.
  3. Cole o token e confirme. O agente troca o token 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.

Token por variável de ambiente

Para provisionamento automatizado, o token também pode ser fornecida via ZARV_AGENT_ENROLLMENT_TOKEN em /etc/default/zarv-agent. O agente o usa no primeiro boot, quando ainda não tem identidade.

O que acontece nos bastidores ​

  • O agente troca o token 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. Copie o token de acesso do workspace no painel (se ele foi trocado, use o novo).
  2. Abra http://localhost:8088 e cole o token (mesmo fluxo do primeiro registro).

O agente limpa o estado de revogação e volta a operar com a nova identidade (um novo instance_id).

Próximos passos ​