V2

Conexão com o Painel do Agente (GLPI)

Guia de conexão ativos/glpi-integracao 8 min de leitura

Como obter o App Token e o User Token no Painel do Agente, conectar no SNDesk e importar as máquinas do inventário.

Esta tela ainda é da interface V1. A tela de integração com o Painel do Agente fica em Ativos > Integração GLPI (rota `ativos/glpi-integracao`) da interface clássica. Na V2, prefira o Ativos Agente, que dispensa o GLPI.
Ativos Agente e o modo GLPI: a conexão com o gateway, a transição e a data de corte
Transcrição do vídeo

Neste vídeo, você vai ver o Ativos Agente: as máquinas que reportam sozinhas, o vínculo com o cadastro de ativos, o detalhe da máquina, as regras que abrem chamado e o modo GLPI.

Em Ativos, Ativos Agente, ficam as máquinas com o SNDESK Agent instalado. Elas reportam sozinhas o fabricante, o modelo, o sistema, o IP, o disco, o antivírus e o firewall. A lista mostra a saúde de cada uma, o último contato e o vínculo com o cadastro de ativos.

Os seis indicadores são filtros: Críticas mostra só as críticas, e um novo clique tira o filtro. Sem vínculo mostra as máquinas que ainda não estão ligadas a um ativo. A busca cobre máquina, serial, usuário, IP e cliente.

Sem vínculo, a máquina não entra em contrato, chamados nem relatórios. Vincular liga a máquina a um ativo já cadastrado, com sugestões pelo serial, ou cria um ativo novo na categoria Ativos Agente. O endereço do agente identifica a instância, não o cliente: por isso o cliente é escolhido aqui.

No detalhe, o topo diz que máquina é, de quem é e se está falando com o servidor. A aba Saúde traz os sinais abertos, com a severidade e desde quando aparecem, e os fatos do último inventário: o espaço em disco, o antivírus, o firewall, o sistema e o acesso remoto.

As outras abas mostram as verificações a cada contato, os componentes, os softwares instalados, o histórico dos inventários e o inventário bruto, exatamente como o agente enviou.

Em Configurações, Agente de inventário, a aba Regras e chamados liga a abertura automática de chamados, que nasce desligada: para um cliente piloto ou para todos, com o departamento, a categoria e o SLA por severidade. Em cada regra de saúde você escolhe se ela avalia, a severidade, se abre chamado e se fecha sozinho.

A aba Verificações liga as conferências a cada contato: serviços críticos parados, disco com previsão de falha, reinício pendente, backup local sem arquivo novo e erro de driver. Elas só leem o Windows e precisam do instalador novo do agente.

Para quem ainda usa o GLPI, o seletor no alto da lista troca a fonte para GLPI ou Ambos. O modo GLPI mostra a conexão com o gateway, a transição para a fonte direta e a data de corte, a partir da qual a tela mostra só o agente direto.

A instalação do agente e todos os detalhes estão no guia de Ativos Agente, na documentação do SNDesk. Até o próximo vídeo!

Como funciona (visão geral)

 Computadores da sua empresa          Painel do Agente                 Seu SNDesk
 ┌──────────────────────────┐        ┌──────────────────────┐        ┌──────────────────────────┐
 │  Agente SNDesk instalado │  ───►  │  j2ksistemas.com.br  │  ───►  │  Ativos > Integração     │
 │  (coleta o inventário)   │        │  /ativos             │        │  Agente (importa/lista)  │
 └──────────────────────────┘        └──────────────────────┘        └──────────────────────────┘
  1. Cada computador da empresa roda o Agente SNDesk, que envia o inventário (fabricante, modelo, serial, discos, memória…) para o Painel do Agente, identificado com a etiqueta (tag) do seu domínio (ex.: suaempresa.sndesk.com.br).
  2. O SNDesk se conecta ao Painel do Agente usando três informações (URL, App Token e User Token) e lista somente as máquinas do seu domínio.
  3. Com um clique em Importar, a máquina vira um ativo dentro do SNDesk.

Antes de começar (pré-requisitos)

RequisitoQuem providencia
Agente SNDesk instalado nos computadores, com a tag do seu domínioEquipe técnica / suporte SNDesk
Usuário do SNDesk com permissão de visualizar Ativos (para importar, permissão de criar Ativos)Administrador do seu SNDesk
App Token e User Token do Painel do AgenteSuporte SNDesk (ou siga a Parte 1)

💡 Na prática: a Parte 1 (obter os tokens no Painel do Agente) normalmente é feita uma única vez pela equipe do SNDesk/J2K, que envia os dois códigos para você. Se você já recebeu os tokens, pule direto para a Parte 2.

Parte 1 — Obter as credenciais no Painel do Agente

1.1 Acessar o Painel do Agente

Abra https://j2ksistemas.com.br/ativos e entre com um usuário administrador:

Tela de login do Painel do Agente
Tela de login do Painel do Agente

1.2 Copiar o App Token

No menu lateral, vá em Configurar → Geral e abra a aba API:

Configurar > Geral > aba API
Configurar > Geral > aba API

Clique no cliente da API "full access from localhost" e copie o campo Token de aplicação (app_token):

Ficha do cliente da API com o app_token
Ficha do cliente da API com o app_token
Não marque "Regenerar" — isso trocaria o token e desconectaria todos os SNDesk que já usam o atual.

1.3 Copiar o User Token

No menu lateral, vá em Administração → Usuários e abra o usuário sndesk. Na seção Chaves de acesso remoto, copie o campo Token da API:

Ficha do usuário sndesk com o Token da API
Ficha do usuário sndesk com o Token da API

💡 Se o campo estiver vazio, marque Regenerar e clique em Salvar — o token aparece ao recarregar a ficha.

Ao final da Parte 1 você deve ter em mãos:

InformaçãoExemplo
URLhttps://j2ksistemas.com.br/ativos
App Tokenf7g2…9k1m (40 caracteres)
User Tokenq3w8…t5z7 (40 caracteres)

🔒 Trate os dois tokens como senhas: não envie por canais públicos e não anote em locais compartilhados.

Parte 2 — Conectar no SNDesk

2.1 Entrar no seu SNDesk

Acesse o seu SNDesk (ex.: https://suaempresa.sndesk.com.br) e faça login normalmente:

Tela de login do SNDesk
Tela de login do SNDesk

2.2 Abrir a tela de Integração

No menu, vá em Ativos → Integração Agente — ou acesse direto a URL:

https://SEUDOMINIO.sndesk.com.br/ativos/agent

2.3 Preencher e conectar

Preencha os três campos com as informações da Parte 1 e clique em Conectar:

Formulário Conectar ao Agente
Formulário Conectar ao Agente
CampoO que colocar
URLhttps://j2ksistemas.com.br/ativos (com https://, sem barra no final)
App Tokeno Token de aplicação copiado no passo 1.2
User Tokeno Token da API do usuário copiado no passo 1.3

2.4 Ver e importar as máquinas

Se a conexão der certo, aparece a barra "Conectado" com a validade da sessão e a lista dos computadores do seu domínio:

Tela conectada com a lista de ativos
Tela conectada com a lista de ativos
  • Importar — cria a máquina como ativo do SNDesk, na categoria "Ativos Agente", já com Serial, Patrimônio, Status e data da última atualização do inventário.
  • Importado (verde) — a máquina já existe no SNDesk; o sistema não deixa duplicar e mantém a data de última atualização sincronizada automaticamente.
  • Desconectar — encerra a sessão com o Painel do Agente (a lista some até conectar de novo).

Para ver os componentes de uma máquina importada (processador, memória, discos…), abra o ativo no SNDesk e use a opção Componentes.

Sobre a sessão

  • A conexão fica válida por 24 horas e é renovada automaticamente — em uso normal, você conecta uma vez e esquece.
  • A conexão é da empresa (não de cada usuário): quem conectar por último define a sessão usada por todos.
  • Trocar a senha do usuário sndesk no Painel do Agente não afeta a conexão (ela usa os tokens, não a senha).

Problemas comuns

SintomaCausa provávelO que fazer
"Falha na autenticação" ao conectarToken copiado errado/incompleto, ou token regenerado no painelCopie novamente os dois tokens (passos 1.2 e 1.3) e tente de novo
"Servidor indisponível. Faça uma nova conexão."O Painel do Agente ficou fora do ar no momento da consultaAguarde alguns minutos e recarregue a página; se persistir, contate o suporte
Conecta, mas a lista vem vazia ("Nenhum ativo encontrado com a tag deste domínio")As máquinas não têm o agente instalado, ou o agente foi instalado sem a tag do seu domínioContate o suporte para verificar a instalação/tag do agente nas máquinas
Uma máquina não aparece na listaAgente daquela máquina parado ou sem a tag corretaVerifique se a máquina está ligada/na rede e acione o suporte
"Este ativo já foi importado anteriormente"A máquina já existe como ativoNada a fazer — procure-a na categoria "Ativos Agente"
A data de Última Atualização está antigaO agente daquela máquina não se comunica há diasVerifique se a máquina está ligada; acione o suporte se persistir

Suporte

Em caso de dúvida, acione o suporte SNDesk informando: seu domínio (ex.: suaempresa.sndesk.com.br), a tela em que parou e a mensagem exibida.

Guia gerado em 21/07/2026. Imagens: capturas reais das telas de login e ilustrações fiéis das telas internas (valores e tokens mascarados).

Origem: guia docs/GUIA_CONEXAO_SNDESK_GLPI.md do repositório do sistema, migrado para esta documentação em 01/10/2026.

Relacionado