Skip to content

Latest commit

 

History

History
363 lines (231 loc) · 11 KB

File metadata and controls

363 lines (231 loc) · 11 KB

Manual do Usuário — Protector ISAPI Manager v4.0

Protector Sistemas — Engenharia aplicada à segurança eletrônica Versão 4.0.0 | Março 2026


Sumário

  1. Introdução
  2. Instalação
  3. Primeiro Acesso
  4. Tela de Clientes
  5. Tela de Cadastros
  6. Tela de Regras de Acesso
  7. Tela de Backup
  8. Tela de Auditoria
  9. Tela de Eventos
  10. Tela de Manutenção
  11. Tela de Relatórios
  12. Auto-Update
  13. Solução de Problemas

1. Introdução

O Protector ISAPI Manager é uma ferramenta desktop para gestão centralizada de terminais de reconhecimento facial Hikvision (Ultra Series). Com ele você pode cadastrar pessoas, clonar terminais, fazer backup/restore, controlar portas, gerar relatórios e muito mais — tudo de forma centralizada.

Protocolo: Comunicação via ISAPI (HTTP) com Digest Authentication. Não requer software adicional nos terminais.

Requisitos: Windows 10/11 (64-bit), rede com acesso aos terminais na porta 80.


2. Instalação

Instalador (Recomendado)

  1. Baixe o instalador .exe da página de releases
  2. Execute como administrador
  3. Escolha o idioma (Português ou Inglês)
  4. Siga o assistente — por padrão instala em C:\Program Files\Protector ISAPI Manager
  5. Opcionalmente marque "Iniciar com o Windows"

Atualização

Se já possui uma versão instalada, o instalador detecta automaticamente e faz upgrade. Não é necessário desinstalar.

A partir da v4.0, o app verifica atualizações automaticamente ao abrir (veja seção Auto-Update).


3. Primeiro Acesso

Ao abrir o app pela primeira vez, você verá a sidebar à esquerda com todas as telas disponíveis e a área principal à direita.

Passo 1 — Cadastrar um cliente: Vá em Clientes → clique em + Cliente → digite o nome da empresa.

Passo 2 — Adicionar um terminal: Selecione o cliente → clique em + Terminal → preencha IP, porta (80), usuário (admin) e senha.

Passo 3 — Verificar conexão: Clique em Verificar Todos para testar a comunicação com todos os terminais.

Após isso, todas as demais telas estarão funcionais para o terminal cadastrado.


4. Tela de Clientes

Gestão centralizada de clientes e terminais.

Layout

Painel dividido: lista de clientes à esquerda, terminais do cliente selecionado à direita.

Ações de Clientes

  • + Cliente — Adiciona um novo cliente
  • Editar — Renomeia o cliente selecionado
  • Remover — Remove o cliente e todos os seus terminais

Ações de Terminais

  • + Terminal — Cadastra um terminal (IP, porta, usuário, senha, nome)
  • Editar — Altera dados do terminal
  • Remover — Remove o terminal
  • Mover — Transfere o terminal para outro cliente
  • Web — Abre a interface web do terminal no navegador

Operações em Lote

  • Verificar Todos — Testa conexão com todos os terminais
  • Ping Todos — Verifica latência de rede

Import/Export

  • Exportar JSON — Salva a lista de terminais em JSON
  • Importar JSON — Carrega terminais de um arquivo JSON
  • Exportar Excel — Gera planilha com todos os terminais
  • Importar Excel — Importa terminais de planilha Excel

5. Tela de Cadastros

Gestão de pessoas, faces, cartões e regras de acesso por terminal.

Como usar

  1. Selecione o terminal no dropdown superior
  2. Clique em Carregar Pessoas para buscar todos os cadastros
  3. Use a barra de busca para filtrar por nome ou matrícula
  4. Clique em uma pessoa para ver o detalhe no painel direito (foto, biometria, regras)

Filtros disponíveis

  • Todos — Exibe todos os cadastros
  • OK — Apenas cadastros completos
  • Pendências — Cadastros com problemas
  • Com Foto — Apenas quem tem face cadastrada
  • Sem Foto — Quem ainda não tem face

Ações

  • Sincronizar — Sincroniza pessoas entre dois terminais (selecione origem e destino)
  • Exportar Excel — Gera planilha com todos os cadastros
  • Exportar JSON — Salva dados em JSON
  • Limpar Tela — Limpa a visualização

6. Tela de Regras de Acesso

Visualização e edição de templates de horário, planos semanais e feriados.

Como usar

  1. Selecione o terminal no dropdown
  2. Clique em Carregar Regras para buscar as regras do terminal
  3. Selecione uma regra na lista para ver os detalhes
  4. Use as abas Detalhes, Grupos de Acesso e Raw Data (JSON) para inspecionar

Ações

  • Criar Nova — Cria uma regra de acesso
  • Editar — Modifica a regra selecionada
  • Copiar p/ Outro Terminal — Replica regras para outro terminal
  • Comparar — Compara regras entre dois terminais
  • Exportar Excel — Exporta regras em planilha

Filtro

  • Mostrar vazias/inativas — Toggle para exibir/ocultar regras sem configuração

7. Tela de Backup

Sistema completo de backup e restore com integridade SHA256.

Backup de Configuração (Clássico)

  • Backup Todos — Faz backup de configuração de todos os terminais
  • Backup Individual — Backup de um terminal específico
  • Restaurar — Restaura configuração de um arquivo .bin

Backup de Regras

  • Exportar Regras — Salva regras em JSON
  • Importar Regras — Carrega regras de JSON
  • Clonar Regras (A→B) — Copia regras de um terminal para outro

Backup Completo v4.0 (ZIP)

O backup v4.0 gera um arquivo ZIP contendo todos os dados do terminal:

  • users.json — Todos os cadastros
  • cards.json — Todos os cartões
  • faces/ — Todas as fotos faciais em JPEG
  • config.bin — Configuração do dispositivo
  • manifest.json — Metadados com hash SHA256

Ações:

  • Backup Completo (ZIP) — Cria backup com opções de incluir faces e/ou config
  • Restaurar Backup — Restaura de um ZIP com validação de integridade e serial
  • Listar Backups — Navega todos os backups por terminal/data
  • Validar Backup — Verifica integridade do ZIP (hash SHA256)

Sessões

  • Ver Sessões Pendentes — Mostra operações em andamento ou interrompidas
  • Limpar Finalizadas — Remove sessões concluídas

8. Tela de Auditoria

Verificação cruzada de integridade entre terminais.

Ações

  • Auditar Todos os Terminais — Compara cadastros entre todos os terminais. Identifica pessoas faltando, cadastros incompletos e discrepâncias.
  • Comparar Par de Terminais — Comparação detalhada entre dois terminais específicos.
  • Exportar Relatório Excel — Gera planilha com os resultados da auditoria.

O que a auditoria verifica

  • Pessoas cadastradas em um terminal mas não em outro
  • Cadastros sem foto facial
  • Validade expirada
  • Regras de acesso inconsistentes

9. Tela de Eventos

Consulta e análise de eventos de acesso dos terminais.

Coleta de Eventos

  • Coletar Hoje — Busca eventos do dia
  • Últimos 7 Dias — Busca eventos da semana

Filtros

  • Somente Faciais — Apenas eventos de reconhecimento facial
  • Somente Negados — Apenas acessos negados
  • Mostrar Todos — Remove filtros

Informações por Evento

Cada evento mostra: data/hora, pessoa, resultado (aprovado/negado), tipo de verificação, máscara detectada, score de similaridade, terminal e porta.

Ao clicar em um evento, o painel direito exibe a foto capturada (quando disponível).

Exportação

  • Exportar Excel — Planilha completa
  • Exportar CSV — Para importação em outros sistemas

10. Tela de Manutenção

Monitoramento e controle remoto dos terminais.

Status do Equipamento

Selecione um terminal e clique em Consultar Status para ver:

  • Identificação — Modelo, serial, firmware, nome, IP, MAC, gateway, DHCP
  • Capacidade — Usuários, faces, cartões e eventos (usado/total)
  • Rede — Configuração de rede
  • Eventos Recentes — Últimos acessos

Marque Auto 30s para atualização automática.

Controle de Porta

  • Abrir — Destrava a porta imediatamente
  • Fechar — Trava a porta
  • Manter Aberta — Porta permanece destrancada
  • Manter Fechada — Porta permanece trancada

Operações de Dispositivo

  • Reboot — Reinicia o terminal
  • Ajustar Hora — Sincroniza relógio e timezone
  • Reset Fábrica — Apaga todos os dados (irreversível)
  • Reset (rede) — Reset mantendo configuração de rede

11. Tela de Relatórios

Geração de relatórios profissionais.

Filtros

  • Terminal — Todos ou um específico
  • Período — Hoje, 7 dias, 30 dias, mês atual ou personalizado

Relatório Completo (Snapshot)

Gera um documento com todas as informações do terminal: identificação, cadastros, regras, eventos e rede.

  • Gerar Excel (.xlsx)
  • Gerar PDF

Relatório de Eventos

Lista detalhada de eventos de acesso filtrados por período.

  • Gerar Excel
  • Gerar CSV

12. Auto-Update

O app verifica automaticamente se há atualizações ao ser aberto.

Como funciona

  1. Ao iniciar, o app consulta o GitHub em background
  2. Se houver versão mais recente, aparece um diálogo com as novidades
  3. Clique em Baixar e Instalar para atualizar
  4. O download mostra barra de progresso
  5. Após o download, o instalador executa automaticamente
  6. O app fecha, atualiza e reabre

Atualização Manual

Você sempre pode baixar a versão mais recente em: https://github.com/ProtectorAnalytics/protector-isapi-manager/releases/latest


13. Solução de Problemas

O app não conecta ao terminal

  • Verifique se o IP está correto e o terminal está ligado
  • Teste ping: ping <IP_DO_TERMINAL>
  • Confirme que a porta 80 está acessível
  • Verifique usuário/senha (padrão: admin)

Clonagem de faces trava ou falha

  • O terminal pode estar sobrecarregado — aguarde e tente novamente
  • O app tem backoff adaptativo (cooldown de 2s a 20s)
  • Se interromper, o sistema de sessões permite retomar de onde parou

Backup ZIP dá erro de integridade

  • O arquivo pode estar corrompido — tente fazer um novo backup
  • Use Validar Backup para verificar o hash SHA256

Auto-update não detecta nova versão

  • Verifique sua conexão com a internet
  • O app precisa acessar api.github.com
  • Se estiver atrás de proxy, pode ser necessário configurar

Erro "Terminal ocupado" ou "Serial locked"

  • Outra operação está em andamento no mesmo terminal
  • Aguarde a conclusão ou verifique em Sessões Pendentes

O app não abre após atualização

  • Execute o instalador novamente manualmente
  • Se persistir, desinstale pelo Painel de Controle e reinstale

Protector Sistemas © 2026 — Todos os direitos reservados