PanOps Docs

Visão geral

O inventário é a lista de equipamentos e servidores da organização. Com ele, a equipe acha um equipamento pela busca da tela Acesso e conecta direto, sem que cada pessoa precise cadastrar a própria sessão.

O inventário é opcional. Ele roda dentro da sua rede, no servidor de acesso, e reúne equipamentos de duas origens:

  • Cadastro próprio: equipamentos cadastrados um a um ou importados de uma planilha Excel ou CSV.
  • Bases externas: bancos PostgreSQL ou MySQL da sua rede que já têm a lista de equipamentos, como um CMDB ou um sistema de provisionamento.
Importante!

O inventário guarda só o necessário para conectar: nome, endereço, porta, protocolo, grupo, descrição e tags. Usuário e senha dos equipamentos não ficam no inventário. Quem conecta informa a credencial na hora, e ela não é guardada nem no inventário nem no PanOps.

Cada organização tem um inventário, instalado em um dos seus servidores de acesso. As conexões aos equipamentos do inventário saem por esse servidor.

Instalando

Só administradores veem o menu Configurações › Inventário.

  1. Acesse Configurações › Inventário.
  2. Em Servidor de acesso, escolha o servidor onde o inventário vai rodar. Escolha um que alcance os equipamentos que vão entrar no inventário.
  3. O PanOps confere se o kubeconfig desse servidor tem as permissões necessárias. Se faltar alguma, a tela mostra a Role a aplicar, com um botão para copiar. Aplique no cluster e clique em Conferir de novo.
  4. Clique em Instalar.

O PanOps cria no namespace terminal do servidor um serviço chamado terminal-hub, com um volume de 1 GiB para o cadastro. Os segredos do inventário são gerados na instalação e ficam no próprio cluster. A primeira subida leva alguns segundos a mais, porque o cluster precisa baixar a imagem. Depois disso, a situação muda para Pronto.

Permissões para instalar

O kubeconfig do Instalando o K3s só tem permissão para as sessões. Para instalar o inventário, aplique também esta Role e ligue-a à mesma conta de serviço:

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: panops-terminal-hub
  namespace: terminal
rules:
  - apiGroups: ["apps"]
    resources: ["deployments"]
    verbs: ["create", "get", "patch", "delete"]
  - apiGroups: [""]
    resources: ["services", "persistentvolumeclaims"]
    verbs: ["create", "get", "delete"]
  - apiGroups: [""]
    resources: ["secrets"]
    verbs: ["create", "delete"]
  - apiGroups: [""]
    resources: ["services/proxy"]
    verbs: ["get", "create"]
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["list"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: panops-terminal-hub
  namespace: terminal
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: Role
  name: panops-terminal-hub
subjects:
  - kind: ServiceAccount
    name: panops-terminal
    namespace: terminal
k3s kubectl apply -f panops-terminal-hub.yaml

O PanOps fala com o inventário pela própria API do Kubernetes do servidor de acesso (porta 6443). Nenhuma porta nova precisa ser aberta na sua rede.

Manutenção

No topo da tela ficam a situação do inventário, o servidor onde ele roda e quantos equipamentos e bases externas ele tem.

  • Testar: confere se o inventário responde e se as bases externas estão acessíveis.
  • Atualizar: aparece quando há uma versão nova. O inventário fica fora do ar por alguns segundos enquanto reinicia.
  • Remover inventário: apaga o inventário do cluster, com todos os equipamentos e bases externas cadastrados. Não dá para desfazer: digite remover para confirmar.

Enquanto o inventário existir, o servidor de acesso onde ele roda não pode ser excluído. Remova o inventário antes.

Equipamentos

A aba Equipamentos lista o cadastro próprio, com busca e filtro por protocolo. Clique em Novo equipamento e preencha:

  • Nome: como o equipamento aparece na busca. Não pode repetir.
  • Endereço: IP ou nome DNS que o servidor de acesso alcança.
  • Protocolo e Porta. Porta vazia usa a padrão do protocolo (22 no SSH, 23 no Telnet).
  • Grupo e Descrição (opcionais).
  • Tags: palavras-chave para achar o equipamento na busca, por exemplo fabricante, função, região ou cliente. Digite e pressione Enter.
  • Ativo: desligado, o equipamento some da busca, mas continua cadastrado.
Importante!

O PanOps Terminal conecta por SSH e Telnet. O inventário também aceita equipamentos RDP e VNC, mas eles ainda não conectam pelo Terminal.

Importando uma planilha

  1. Em Exportar › Modelo de planilha, baixe o modelo. Ele traz as colunas nome, endereço, porta, protocolo, grupo, descrição, tags e ativo, e uma aba de instruções.
  2. Preencha uma linha por equipamento.
  3. Clique em Importar e escolha o arquivo (.xlsx ou .csv).
  4. Confira a prévia: quantos equipamentos são Novos, Atualizados, Sem mudança ou Com erro, e o problema de cada linha com erro. Nada é gravado até você confirmar.
  5. Clique em Importar para gravar.

Equipamentos com um nome que já existe são atualizados. Planilhas com colunas de usuário ou senha são recusadas: apague essas colunas e importe de novo.

Para tirar uma cópia do cadastro, use Exportar › Excel (.xlsx) ou CSV.

Bases externas

A aba Bases externas liga o inventário a bancos da sua rede. O inventário só faz consultas de leitura nesses bancos, e a busca do Terminal junta os resultados com o cadastro próprio.

Clique em Nova base e preencha:

  • Nome e Identificador. O identificador entra na referência dos equipamentos e não muda depois.
  • Banco (PostgreSQL ou MySQL), Servidor, Porta, Base, Usuário do banco e Senha do banco. Use um usuário do banco que só tenha permissão de SELECT.
  • Exigir TLS, se o banco aceitar conexões cifradas.
  • Tempo limite de cada consulta.
  • Query modelo: um SELECT que devolve uma linha por equipamento, com estas colunas (renomeie com AS):
ColunaObrigatóriaConteúdo
refSimIdentificador estável da linha, por exemplo o id da tabela de origem.
nameSimNome exibido no Terminal.
hostSimIP ou nome DNS que o servidor de acesso alcança.
protocolSimssh, telnet, rdp ou vnc (maiúsculas são aceitas).
portNãoVazio usa a porta padrão do protocolo.
groupNãoAgrupa e filtra na busca.
descriptionNãoTambém entra na busca.

Exemplo para PostgreSQL:

SELECT d.id AS ref, d.hostname AS name, d.mgmt_ip AS host,
       lower(d.proto) AS protocol, d.porta AS port, s.nome AS "group"
FROM dispositivos d
JOIN sites s ON s.id = d.site_id
WHERE d.ativo

No MySQL, group é palavra reservada: escreva AS `group`.

Não traga colunas de usuário ou senha: o inventário não lê essas colunas. Linhas sem ref, sem host ou com protocolo desconhecido são ignoradas.

Clique em Testar conexão e query antes de salvar. O inventário roda a query com poucas linhas, confere as colunas obrigatórias e mostra o resultado. A senha do banco fica cifrada no próprio cluster; ao editar a base, deixe o campo como está para mantê-la.

Conectando pelo inventário

Na tela Acesso, digite pelo menos duas letras na busca acima das sessões. Além das sessões salvas, a árvore mostra o grupo Inventário, com os equipamentos que têm o texto no nome, no endereço, na descrição ou nas tags. As tags que casam com a busca aparecem primeiro.

Clique no equipamento para conectar:

  • SSH: o PanOps pede usuário e senha. Eles valem só para essa conexão e não ficam guardados. O PanOps lembra apenas o último usuário digitado para aquele equipamento, enquanto a página estiver aberta.
  • Telnet: conecta direto, e o login é feito no próprio terminal.

O endereço e a porta vêm sempre do inventário: quem conecta não troca o destino. A conexão entra no Registro de Sessões como qualquer outra.

Para guardar um equipamento do inventário entre as suas sessões, use o botão Copiar para minhas sessões ao lado dele. Abre uma sessão nova já preenchida com nome, endereço, grupo, protocolo e porta. Informe a credencial e salve. A cópia não fica ligada ao inventário.

Se uma base externa estiver fora do ar, a busca mostra um aviso com o nome dela e continua trazendo os resultados das outras.

© 2026, Panops Solutions | Todos os direitos reservados.