Administração › Agentes

Agentes

O agente é um programa que lê os certificados A1 da máquina — instalados no Windows ou guardados como arquivo .pfx — e envia a validade ao Vaulton Cert automaticamente. Ele pode ficar centralizado na contabilidade ou no computador de cada cliente.

Menu: Administração › AgentesVer: todos os usuáriosGerar chave, bloquear e remover: Administrador

O que o agente lê

O agente lê os certificados instalados no Windows — de todos os usuários do computador — e os arquivos .pfx que você indicar, e envia só a parte pública: titular, CNPJ/CPF, emissor, número de série e validade. A chave privada nunca sai da máquina. Certificados que não são ICP-Brasil (de sites, por exemplo) são ignorados.

Dois jeitos de usar

Jeito	Como funciona
Agente geral (instalado por esta tela)	Pega todos os certificados ICP-Brasil da máquina e cada um vai para a empresa do mesmo CNPJ; as que ainda não estão na lista são cadastradas. Ideal na máquina da contabilidade que guarda os certificados de vários clientes.
Agente da empresa (instalado pela tela da empresa)	Abra a empresa em Empresas › empresa › Leitura automática e escolha Instalar no computador da empresa. O agente monitora só aquele CNPJ. Se o computador tiver certificados de outras empresas (um grupo com vários CNPJs, por exemplo), eles aparecem como "encontrados e não monitorados" e você inclui só os que são clientes.

Instalar com um comando

No cartão Agente geral (ou na tela da empresa, para o agente da empresa), clique em Gerar chave e comando de instalação.
Na aba Windows, copie o comando (ele começa com irm).
Na máquina onde os certificados estão, clique com o botão direito no menu Iniciar › Terminal (Administrador) ou Windows PowerShell (Administrador), cole o comando e tecle Enter.
Em menos de um minuto aparece "instalado e em execução". A máquina entra na lista "Máquinas com o agente" e os certificados aparecem em Empresas.

O comando já leva a chave do escritório: copie na hora, porque por segurança ela aparece completa só uma vez.
A mesma chave instala o agente em várias máquinas até a data de validade dela. Gerar nova chave invalida a anterior para novas instalações; os agentes já instalados continuam funcionando.
Rodar o comando de novo na mesma máquina atualiza o agente sem criar outro.
Servidor Linux: use a aba Linux. No Linux o agente lê arquivos .cer/.crt/.pem de pastas que você informa no comando.
O agente se atualiza sozinho quando sai uma versão nova.

Certificado só como arquivo .pfx

Muitos certificados A1 não são instalados no Windows: ficam só como arquivo .pfx numa pasta. Nesse caso o agente precisa do caminho do arquivo e da senha.

Na instalação pela tela da empresa, o comando pergunta se o certificado está instalado no Windows. Responda N e informe o caminho do arquivo e a senha.
Depois de instalado, para incluir outro arquivo, rode na máquina (PowerShell como Administrador): vaulton-cert-agent pfx add "C:\Certificados\empresa.pfx". A senha é pedida ali.
A senha fica só naquela máquina, cifrada pelo Windows. Ela nunca é enviada ao Vaulton Cert: o agente abre o arquivo no próprio computador, tira a parte pública e envia só ela.
No detalhe da máquina (clique na linha da tabela) aparece cada arquivo .pfx e se a última leitura deu certo. "senha incorreta" indica que a senha mudou: rode o pfx add de novo com a senha nova.

Empresas encontradas pelo agente geral

Quando o agente geral encontra um e-CNPJ de um cliente que ainda não está na lista, a empresa é cadastrada automaticamente com a razão social do certificado e já fica ligada a esse agente. Para desligar isso, use Configurações › Agente cadastra empresas novas.

Certificados e-CPF (do contador, de sócios) não viram empresa sozinhos: só são lidos se já existir uma empresa cadastrada com aquele CPF, como um produtor rural que emite nota com e-CPF.

Máquinas com o agente

Coluna	O que mostra
Empresa	A empresa dona do computador ou "Agente geral", e quantas empresas a máquina monitora.
Máquina	Nome dado pelo escritório (ou o nome do computador) e a versão do sistema. Se a última leitura teve problema, o motivo aparece em vermelho.
Situação	ativo, sem comunicação (não fala com o Vaulton Cert há mais de um dia: confira se a máquina está ligada e com internet) ou bloqueado.
Última leitura	Quando o agente enviou os certificados pela última vez.
Certificados	Quantos certificados este agente encontrou.

Clique na linha para ver o detalhe da máquina: empresas monitoradas (com aviso quando o certificado não foi encontrado na última leitura), certificados encontrados nesta máquina e não monitorados com o botão Monitorar, e os arquivos .pfx lidos. Com o limite dos pacotes atingido, os certificados novos ficam nessa lista até você comprar mais pacotes.
Setas circulares (Ler agora): o agente lê os certificados no próximo contato, em até 5 minutos. A coluna "Última leitura" mostra "leitura pedida" enquanto isso.
Lápis: dá um nome fácil para a máquina (ex.: "Caixa — Padaria Sol").
Bloquear: o agente para de enviar até ser desbloqueado e reinstalado com o comando.
Remover: tira a máquina da lista. Os certificados que ela encontrou continuam no painel.