Support Hub/API & Integrations/Implantação de Dispositivos Biométricos: Native Push vs.…
Translated from the English article and reviewed by a person. Read the English original
Developer

Implantação de Dispositivos Biométricos: Native Push vs. Hybrid Push

Implantação de Dispositivos Biométricos: Native Push vs. Hybrid Push

Visão geral: Entendendo os Desafios de Conectividade dos Dispositivos Biométricos

Sistemas biométricos de controle de ponto e dispositivos de controle de acesso funcionam em ambientes diversos, com diferentes infraestruturas de rede, capacidades de conectividade e requisitos de segurança. As organizações enfrentam um desafio crítico: como integrar dispositivos biométricos — sejam leitores de impressão digital, terminais de reconhecimento facial, leitores de íris ou leitores de veias da palma da mão — aos seus sistemas HRMS (Sistemas de Gestão de Recursos Humanos), plataformas ERP (Planejamento de Recursos Empresariais) ou softwares de gestão de ponto já existentes, quando esses dispositivos são de fabricantes diferentes com protocolos de comunicação incompatíveis.

O Biometric Gateway aborda esse desafio fundamental de integração por meio de uma arquitetura de implantação adaptativa. Essa arquitetura seleciona automaticamente o método de comunicação ideal com base nas capacidades do dispositivo, na topologia da rede e nas restrições de infraestrutura, garantindo que cada dispositivo biométrico — independentemente de fabricante, modelo, idade ou capacidade de conectividade — possa se integrar a qualquer sistema de gestão de ponto ou plataforma de gestão de força de trabalho.

O Desafio de Compatibilidade de Dispositivos: Por que o Suporte Universal Importa

Fragmentação de Fabricantes em Hardware Biométrico

O mercado global de dispositivos biométricos inclui centenas de fabricantes que produzem milhares de modelos de dispositivos:

  • Dispositivos ZKTeco: Incluindo F18, K40, controladores de acesso InBio, série SpeedFace
  • Suprema BioStar: Terminais de reconhecimento facial BioEntry, BioLite, FaceStation
  • Terminais biométricos Anviz: Dispositivos de face e impressão digital FacePass, CrossChex, VF30 Pro
  • eSSL (Matrix Comsec): Leitores multibiométricos X990, K21 Pro, MB360
  • Realtime (Startek): Máquinas de ponto por impressão digital e RFID T502, T9, T52
  • Virdi: Sistemas de controle de acesso e ponto AC-2100, AC-5000
  • Nitgen: Leitores de impressão digital eNBioAccess, Fingkey Hamster
  • Morpho (IDEMIA): Dispositivos de autenticação por impressão digital MSO 1300, série Sigma
  • Mantra: Sensores de impressão digital MFS100, MFS110 e tablets MADT50
  • Secugen: Leitores de impressão digital Hamster Plus, OptiMouse
  • Hikvision: Terminais de reconhecimento facial da série DS-K1T
  • Time Watch: Terminais de ponto SG-100, SG-300
  • Biomax: Dispositivos de veia da palma e impressão digital N-BM180, Bio5000

Cada fabricante desenvolve protocolos de comunicação, formatos de dados e métodos de integração proprietários. As abordagens tradicionais de integração exigem esforços de desenvolvimento separados para cada fabricante de dispositivo, gerando dependência de fornecedor (vendor lock-in) e limitando a escolha do cliente na seleção de hardware.

Variações na Infraestrutura de Rede

As organizações implantam sistemas biométricos em arquiteturas de rede fundamentalmente diferentes:

  • Ambientes conectados à nuvem: Dispositivos com acesso direto à internet via WiFi, Ethernet ou conectividade celular
  • Redes isoladas (air-gapped): Instalações industriais, instalações de defesa ou escritórios governamentais seguros onde os dispositivos biométricos operam em redes isoladas, sem acesso à internet
  • Implantações em DMZ (Zona Desmilitarizada): Arquiteturas de segurança corporativa nas quais os dispositivos de controle de acesso biométrico ficam em segmentos de rede separados tanto das redes internas quanto da internet pública
  • Acesso somente por VPN: Localidades remotas, filiais ou lojas de varejo onde os dispositivos se conectam por meio de Redes Privadas Virtuais
  • Redes com restrição de proxy: Ambientes corporativos em que todas as conexões de saída devem ser roteadas por servidores proxy com autenticação
  • Ambientes protegidos por firewall: Organizações com políticas rigorosas de firewall que bloqueiam conexões de entrada ou limitam o tráfego de saída a portas e protocolos específicos

As soluções tradicionais de integração biométrica presumem configurações de rede específicas, forçando as organizações a modificar sua infraestrutura para atender aos requisitos de conectividade dos dispositivos. Isso cria riscos de segurança, violações de conformidade e atrasos na implementação.

Verificação de Compatibilidade de Dispositivos: O Primeiro Passo

Dispositivos Nativos Cams Biometrics

Todos os dispositivos biométricos fabricados pela Cams Biometrics incluem a capacidade nativa de Native Push integrada. Esses dispositivos — incluindo terminais de ponto por impressão digital, sistemas de reconhecimento facial e leitores biométricos multimodais — são fornecidos com conectividade em nuvem pré-configurada e oferecem suporte completo à Biometric Web API, sem exigir instalação de software adicional ou atualizações de protocolo.

Os recursos nativos incluem:

  • Envio de transações em tempo real via webhooks HTTPS
  • Comunicação bidirecional por REST API para gerenciamento de dispositivos
  • Enfileiramento e sincronização automáticos de dados offline
  • Cadastro remoto de usuários com transferência de templates biométricos
  • Configuração de dispositivos e atualizações de firmware baseadas em nuvem

Processo de Verificação de Dispositivos de Terceiros

Para dispositivos biométricos de outros fabricantes (hardware não Cams), a verificação de compatibilidade ocorre por meio da plataforma developer.camsbiometrics.com. Esse portal de verificação testa a compatibilidade de comunicação com dispositivos de fabricantes oficialmente parceiros.

O processo de verificação:

  1. Registro do dispositivo: Informe o número do modelo, o número de série e os dados do fabricante do dispositivo
  2. Teste de protocolo: Testes automatizados verificam a capacidade do dispositivo de se comunicar usando protocolos padronizados de troca de dados biométricos
  3. Validação de comunicação: O sistema confirma se o dispositivo consegue enviar transações de ponto, aceitar dados de cadastro de usuários e responder a comandos de configuração, de acordo com os acordos de protocolo mútuos
  4. Determinação de compatibilidade: Com base nos resultados dos testes, o sistema determina se o dispositivo se qualifica para a implantação Native Push ou se requer a implantação Hybrid

Resultados da verificação:

  • Verificação bem-sucedida: O dispositivo demonstra conformidade total com o protocolo → implantação Native Push habilitada
  • Verificação com falha ou problemas detectados: O dispositivo não atende aos requisitos do protocolo, possui firmware incompatível ou apresenta erros de comunicação → implantação Hybrid recomendada

Essa verificação garante que a seleção do modo de implantação seja baseada na capacidade técnica realmente testada, e não em suposições sobre especificações do dispositivo ou alegações do fabricante.

Por que Alguns Dispositivos Exigem Implantação Hybrid

Os dispositivos são reprovados na verificação de compatibilidade por diversos motivos técnicos:

  • Protocolos proprietários: O dispositivo usa métodos de comunicação específicos do fabricante, incompatíveis com protocolos padronizados de envio
  • Limitações de firmware: Versões antigas de firmware não possuem recursos de conectividade em nuvem ou suporte a webhooks
  • Restrições de hardware: Processador ou memória do dispositivo insuficientes para manter conexões persistentes com a nuvem
  • Problemas de validação de certificado: A implementação SSL/TLS do dispositivo é incompatível com os requisitos atuais de certificados
  • Incompatibilidades de formato de dados: O dispositivo transmite dados de ponto em formatos não padronizados que exigem tradução
  • Limitações de conectividade: A pilha de rede do dispositivo não oferece suporte aos protocolos necessários (HTTP/2, WebSocket etc.)

Quando os dispositivos não conseguem passar na verificação, o Hybrid Push Service oferece caminhos de comunicação alternativos que funcionam dentro das capacidades e limitações reais do dispositivo.

Opção de Arquitetura de Implantação 1: Native Push (Web API Completa)

O que é a Implantação Native Push?

O Native Push é o método de integração direta com a nuvem, no qual os dispositivos biométricos se comunicam diretamente com a plataforma em nuvem do Biometric Gateway, usando a Biometric Web API. Esse método de implantação oferece o conjunto completo de recursos, com desempenho máximo e latência mínima.

Native Push significa que o próprio dispositivo:

  • Estabelece conexões HTTPS diretamente com os endpoints da API em nuvem
  • Envia as transações de ponto imediatamente após a ocorrência
  • Recebe comandos REST API para gerenciamento de usuários e configuração do dispositivo
  • Mantém comunicação bidirecional para controle em tempo real
  • Gerencia seu próprio enfileiramento de dados offline e sincronização automática

Arquitetura Técnica do Native Push

Fluxo de comunicação:

Biometric Device (Fingerprint/Face Terminal) 
    ↓ [HTTPS/TLS 1.2+]
    ↓ [Real-time webhook POST requests]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook delivery to partner endpoint]
    ↓
Partner Application (HRMS/ERP/Attendance System)

Detalhes do protocolo:

  • Transporte: HTTPS sobre TCP/IP com criptografia TLS 1.2 ou superior
  • Autenticação: Autenticação baseada em chave de API com assinatura de requisições
  • Formato de dados: Payloads JSON para dados de transações e requisições de API
  • Envio por webhook: Requisições POST para as URLs de callback configuradas pelo parceiro
  • Métodos de API: Interface HTTP RESTful para operações do dispositivo

Recursos do Native Push: Conjunto Completo de Funcionalidades

Envio de Transações de Ponto em Tempo Real

Quando o dispositivo está online (conectado à internet):

  • Ocorre um evento de ponto (leitura de impressão digital, reconhecimento facial, aproximação de cartão RFID)
  • O dispositivo gera o registro da transação com carimbo de data/hora, ID do usuário e pontuação de correspondência biométrica
  • O dispositivo envia imediatamente uma requisição HTTPS POST para a API em nuvem (latência < 1 segundo)
  • A API em nuvem valida a transação, processa os dados e aciona o webhook para a aplicação parceira
  • A aplicação parceira recebe o registro de ponto em tempo real para processamento imediato

Quando o dispositivo está offline (sem conexão com a internet):

  • O dispositivo armazena as transações de ponto na memória local (a capacidade de armazenamento interno varia conforme o modelo, normalmente entre 50.000 e 100.000 registros)
  • O dispositivo continua operando normalmente, registrando o ponto biométrico sem interrupção
  • Quando a conexão com a internet é restabelecida (reconexão do WiFi, cabo Ethernet reconectado, sinal celular restaurado)
  • O dispositivo detecta automaticamente a restauração da conectividade
  • O dispositivo enfileira todas as transações offline armazenadas e as envia para a API em nuvem em ordem cronológica
  • Não é necessária intervenção manual, não há perda de dados e a sincronização é totalmente automática

Comunicação Bidirecional por REST API

A implantação Native Push oferece acesso REST API completo para gerenciamento programático de dispositivos. Com base na documentação da Biometric Web API, estão disponíveis as seguintes operações:

Operações de entrega de dados em tempo real:

  • Webhooks de transações de ponto: Envio automático de eventos de verificação biométrica (entrada, saída, início de intervalo, fim de intervalo) com identificação do funcionário, carimbo de data/hora, método de verificação, localização do dispositivo e pontuação de qualidade da correspondência
  • Notificações de eventos: Alertas em tempo real para eventos do dispositivo, incluindo detecção de adulteração, avisos de bateria baixa, alertas de porta arrombada, tentativas de acesso inválidas e erros do sistema
  • Atualizações de status: Monitoramento contínuo da saúde do dispositivo, incluindo mudanças de estado online/offline, utilização de memória, status da conectividade de rede e alertas operacionais

Operações de cadastro e gerenciamento de usuários:

  • Adicionar novos usuários aos dispositivos: Cadastrar funcionários com informações biográficas, incluindo ID do funcionário, nome completo, atribuição de departamento, classificação de função e permissões de acesso
  • Cadastrar templates biométricos remotamente: Enviar padrões de impressão digital, dados de reconhecimento facial, varreduras de íris ou templates de veia da palma da mão, de estações de cadastro centralizadas para dispositivos distribuídos
  • Consultar bases de usuários: Consultar listas completas de funcionários nos dispositivos, incluindo status de cadastro, níveis de acesso atribuídos, estados ativo/inativo e últimos carimbos de data/hora de verificação
  • Atualizar informações de usuários: Modificar dados dos funcionários, alterar atribuições de departamento, ajustar permissões de acesso, atualizar períodos de validade e revisar requisitos de autenticação
  • Excluir cadastros de usuários: Remover funcionários dos dispositivos, apagar templates biométricos, revogar permissões de acesso e limpar registros de autenticação
  • Operações em lote de usuários: Enviar vários registros de funcionários simultaneamente, atualizar em massa permissões de acesso em frotas de dispositivos, excluir em lote funcionários desligados e sincronizar bases de usuários entre localidades
  • Configuração de níveis de acesso: Definir regras de acesso por horário, configurar modos de autenticação (somente impressão digital, combinação de face e impressão digital, cartão e verificação biométrica), configurar limiares de verificação e estabelecer permissões de substituição

Operações de configuração e controle do dispositivo:

  • Consultar status do dispositivo: Obter informações em tempo real, incluindo versão do firmware, número de série, identificação do modelo, capacidade de memória, quantidade atual de usuários, utilização do armazenamento de templates, configuração de rede e data/hora da última comunicação
  • Configurar parâmetros operacionais: Ajustar limiares de sensibilidade da verificação, definir períodos de timeout da autenticação, configurar requisitos de autenticação multifator, definir políticas de bloqueio após tentativas malsucedidas e estabelecer parâmetros de segurança
  • Gerenciar regras de ponto: Definir escalas de trabalho, configurar horários de turno, configurar cálculos de horas extras, estabelecer regras de períodos de intervalo e especificar calendários de feriados
  • Controlar permissões de acesso: Definir durações de abertura de porta, configurar o tempo de retrancamento, configurar regras de anti-passback, estabelecer zonas de acesso temporais (permissões baseadas em horário) e gerenciar protocolos de acesso de visitantes
  • Agendar ações automáticas: Configurar agendas de sinais sonoros/alarmes para trocas de turno, definir o horário de anúncios por voz, definir agendas automáticas de trancamento/destrancamento de portas e estabelecer relatórios periódicos de status
  • Personalizar configurações de tela: Ajustar o brilho da tela, definir períodos de timeout, configurar preferências de idioma, enviar logotipos personalizados e definir mensagens de boas-vindas
  • Gerenciar configurações de comunicação: Configurar parâmetros de rede (endereço IP, máscara de sub-rede, gateway, servidores DNS), definir credenciais de WiFi, ajustar modos de conectividade e estabelecer protocolos de failover

Operações de consulta de dados de ponto:

  • Consultar registros históricos: Obter transações de ponto por intervalo de datas, filtrar por ID do funcionário, pesquisar por departamento, consultar dispositivos específicos e extrair registros por tipo de verificação
  • Baixar logs de transações: Exportar registros completos de marcação com carimbos de data/hora, identificadores do funcionário, status de entrada/saída, modos de verificação, localizações dos dispositivos e pontuações de correspondência
  • Acessar trilhas de auditoria: Revisar eventos do sistema, acompanhar alterações de configuração, monitorar atividades de cadastro de usuários e examinar decisões de controle de acesso
  • Gerar resumos de ponto: Calcular horas trabalhadas, consolidar a presença por departamento, calcular horas extras, acompanhar atrasos e identificar saídas antecipadas

Operações de administração do sistema:

  • Gerenciamento de firmware: Verificar versões atuais, iniciar atualizações remotas, agendar janelas de manutenção e confirmar a conclusão das atualizações
  • Operações de diagnóstico: Obter logs do sistema, acessar mensagens de erro, revisar o histórico de conectividade de rede, examinar falhas de autenticação e analisar métricas de desempenho
  • Backup e restauração: Exportar configurações de dispositivos, salvar bases de usuários, fazer backup das configurações do sistema e restaurar a partir de estados anteriores
  • Coordenação de múltiplos dispositivos: Sincronizar a hora entre frotas de dispositivos, distribuir configurações para grupos de dispositivos, coordenar atualizações da base de usuários e gerenciar políticas de acesso centralizadas

Fluxo Completo de Cadastro Biométrico

Cadastro remoto (da nuvem para o dispositivo):

  1. A aplicação parceira captura os dados biométricos (leitura de impressão digital, foto do rosto) em qualquer local (escritório de RH, estação de cadastro remota, aplicativo móvel)
  2. A aplicação envia o template biométrico para a API em nuvem, com a identificação do funcionário e as métricas de qualidade do template
  3. A API em nuvem valida a qualidade do template e verifica cadastros duplicados em toda a base de dados, para evitar conflitos de identidade
  4. A API em nuvem envia o template validado para o(s) dispositivo(s) biométrico(s) de destino, com base nos locais atribuídos ao funcionário
  5. O dispositivo recebe o template, armazena-o na memória local, indexa-o para verificação rápida e torna o usuário imediatamente verificável
  6. O funcionário pode se autenticar no dispositivo sem presença física prévia, permitindo a liberação de acesso no mesmo dia

Cadastro local (diretamente no dispositivo):

  1. O administrador adiciona o usuário ao dispositivo pela interface local (teclado, tela sensível ao toque ou terminal de cadastro conectado)
  2. O usuário passa o dedo várias vezes no leitor (normalmente 3 capturas) ou cadastra o rosto diretamente no terminal biométrico
  3. O dispositivo captura o template biométrico, realiza a avaliação de qualidade e verifica a unicidade do template
  4. O dispositivo armazena o template em memória não volátil local e envia imediatamente os dados de cadastro do usuário para a nuvem
  5. A API em nuvem sincroniza o cadastro do usuário entre vários dispositivos, se configurado (distribuição automática de templates)
  6. A aplicação parceira recebe a notificação de cadastro do usuário via webhook, incluindo ID do funcionário, carimbo de data/hora do cadastro, localização do dispositivo e pontuação de qualidade do template

Controle e Configuração do Dispositivo

Operações remotas:

  • Atualizações de firmware: Enviar firmware atualizado da nuvem para os dispositivos durante janelas de manutenção programadas, verificar a compatibilidade de versões, acompanhar o progresso da atualização e confirmar a instalação bem-sucedida
  • Regras de controle de acesso: Atualizar janelas de horário permitidas para grupos de funcionários, definir restrições específicas por departamento, configurar políticas de acesso em feriados e estabelecer procedimentos de autenticação de visitantes
  • Agendas de sinais sonoros/alarmes: Configurar sinais de troca de turno para ambientes industriais, definir alarmes de períodos de intervalo, definir agendas de sinais escolares e personalizar anúncios sonoros
  • Anúncios por voz: Selecionar preferências de idioma, enviar mensagens de áudio personalizadas, configurar gatilhos de anúncio (autenticação bem-sucedida, acesso negado, alertas do sistema) e ajustar os níveis de volume
  • Personalização da tela: Definir o brilho da tela de acordo com a hora do dia, configurar períodos de timeout para economia de energia, ajustar formatos de idioma e data, enviar logotipos da empresa e definir mensagens de boas-vindas
  • Modos de verificação: Alternar entre verificação 1:1 (cartão + biometria) e identificação 1:N (somente biometria), ajustar limiares de correspondência para equilibrar segurança e conveniência, habilitar autenticação multifator e configurar métodos de verificação de backup

Gerenciamento de múltiplos dispositivos:

  • Controle centralizado de frotas: Gerenciar centenas ou milhares de dispositivos a partir de uma única interface de API, sem acesso individual a cada dispositivo
  • Cadastro de usuários em lote: Adicionar um novo funcionário a todas as localidades relevantes simultaneamente, garantindo acesso imediato em toda a instalação ou organização
  • Configuração sincronizada: Enviar as mesmas configurações para grupos de dispositivos (todos os terminais da recepção, todos os dispositivos do chão de fábrica, todos os pontos de acesso executivos), mantendo a consistência
  • Diagnóstico remoto: Solucionar problemas de conectividade, revisar logs de erro, verificar a utilização de memória e identificar dispositivos com defeito sem visitas físicas ao local
  • Monitoramento automatizado: Receber alertas proativos para eventos de dispositivo offline, condições de bateria baixa, avisos de memória cheia e anomalias de autenticação

Requisitos de Rede para o Native Push

Conectividade com a internet:

  • Os dispositivos exigem acesso à internet (WiFi, Ethernet, celular 4G/5G ou outra conectividade IP)
  • A conexão pode ser intermitente — os dispositivos lidam com desconexões temporárias de forma adequada, por meio do enfileiramento automático
  • Largura de banda mínima: 10-50 Kbps por dispositivo (uma transação típica de ponto tem de 1 a 2 KB)
  • Tolerância de latência: funciona com conexões via satélite, 3G/4G celular e WiFi típico de escritório (até 5000 ms são aceitáveis)

Configuração de firewall:

  • O tráfego HTTPS de saída (porta 443) deve ser permitido da sub-rede dos dispositivos para api.camsbiometrics.com
  • Conexões de entrada não são necessárias (os dispositivos iniciam todas as conexões como clientes)
  • Não é necessário encaminhamento de portas (modelo de comunicação somente de saída)
  • Compatível com NAT (Network Address Translation) — dispositivos atrás de roteadores NAT funcionam normalmente
  • Funciona atrás de firewalls corporativos com políticas padrão de acesso web de saída

Resolução de DNS:

  • Os dispositivos devem resolver o nome de domínio api.camsbiometrics.com para um endereço IP
  • Servidores DNS padrão são aceitáveis (DNS do Google 8.8.8.8, DNS da organização, DNS do provedor de internet etc.)
  • Recomenda-se um DNS secundário de fallback para maior confiabilidade

Quando Usar a Implantação Native Push

Cenários ideais para o Native Push:

  • Novas instalações de sistemas biométricos com dispositivos modernos compatíveis com nuvem
  • Organizações com conectividade padrão de internet nos locais dos dispositivos
  • Estratégias de TI com prioridade para a nuvem, que preferem a arquitetura SaaS (Software como Serviço)
  • Implantações em múltiplas localidades (redes de varejo, escritórios distribuídos, redes de filiais)
  • Aplicações para equipes móveis que exigem visibilidade do ponto em tempo real
  • Ambientes em que os dispositivos podem alcançar a internet (diretamente ou pela rede corporativa)
  • Situações que exigem funcionalidade completa da API (gerenciamento remoto de usuários, configuração de dispositivos)

Organizações que utilizam o Native Push:

  • Redes de varejo com terminais de ponto por impressão digital em cada loja
  • Escritórios corporativos com controle de acesso por reconhecimento facial nas entradas dos prédios
  • Instituições de ensino com sistemas de ponto biométrico nas salas de aula
  • Unidades de saúde com autenticação por veia da palma da mão para acesso controlado a medicamentos
  • Empresas de logística com terminais de impressão digital nas docas de carregamento dos armazéns
  • Centros de BPO (Terceirização de Processos de Negócios) com sistemas de ponto multimodais
  • Redes hoteleiras com controle biométrico de jornada para a equipe de governança e recepção

Opção de Arquitetura de Implantação 2: Hybrid Push Service

O que é a Implantação Hybrid Push?

O Hybrid Push Service é a arquitetura de integração alternativa utilizada quando os dispositivos biométricos não podem oferecer suporte à implantação Native Push. Isso ocorre quando os dispositivos são reprovados na verificação de compatibilidade em developer.camsbiometrics.com ou quando a infraestrutura de rede impede que os dispositivos mantenham conectividade direta com a nuvem.

O Hybrid Push introduz um componente intermediário:

  • Um computador, servidor ou dispositivo de borda (PC com Windows, servidor Linux, Raspberry Pi etc.) fica entre os dispositivos biométricos e a nuvem
  • Esse intermediário executa um software (SDK, serviço local ou conector de banco de dados) que se comunica com os dispositivos usando os protocolos que eles suportam
  • O intermediário tem conectividade com a internet e se comunica com a API em nuvem
  • Os dispositivos biométricos podem ou não ter acesso à internet

Principal diferença arquitetural:

  • Native Push: o dispositivo se comunica diretamente com a nuvem
  • Hybrid Push: o dispositivo se comunica com o computador intermediário, e o intermediário se comunica com a nuvem

Por que o Hybrid Push Existe: Resolvendo Problemas de Incompatibilidade

Incompatibilidades no nível do dispositivo:

  • Terminais biométricos legados (com 5 a 10 anos ou mais) sem firmware de conectividade em nuvem
  • Dispositivos que usam RS232, RS485, Wiegand ou outros protocolos de comunicação legados
  • Leitores de impressão digital projetados apenas para conexão local com PC (leitores de mesa conectados via USB)
  • Painéis de controle de acesso com protocolos de rede proprietários
  • Dispositivos de fabricantes sem suporte padronizado a API

Restrições de infraestrutura de rede:

  • Redes industriais isoladas (air-gapped), nas quais os dispositivos não podem acessar a internet por motivos de segurança
  • Instalações governamentais ou de defesa que proíbem a conectividade de dispositivos com a internet
  • Ambientes de saúde com requisitos de isolamento de rede em conformidade com a HIPAA
  • Instituições financeiras com mandatos de segmentação de rede PCI-DSS
  • Instalações industriais com redes OT (Tecnologia Operacional) separadas das redes de TI

Restrições de políticas de segurança:

  • Organizações que proíbem o acesso de dispositivos IoT à internet como política de segurança
  • Requisitos de conformidade que exigem processamento de dados on-premises
  • Regulamentações de soberania de dados que impedem a transmissão de dados para a nuvem
  • Arquiteturas de rede zero-trust que bloqueiam comunicações entre dispositivos e a internet

Arquitetura do Hybrid Push: Quatro Modos de Conexão

A implantação Hybrid Push se adapta a diferentes configurações de infraestrutura por meio de quatro modos distintos. A seleção do modo depende do que a topologia da sua rede permite e de onde a integração é possível.

Modo A: Conexão com Hardware por Encaminhamento de Portas (Baseado em SDK)

O que este modo significa:

Esta implantação utiliza o SDK (Kit de Desenvolvimento de Software) da Cams Biometrics executado em um computador intermediário com conectividade com a internet. O SDK se comunica diretamente com o hardware do dispositivo biométrico usando o protocolo nativo do dispositivo. O encaminhamento de portas no roteador da sua rede permite que o SDK alcance os dispositivos, mesmo que eles estejam em segmentos de rede diferentes.

Arquitetura técnica:

Biometric Device (on local network 192.168.1.x)
    ↓ [Device native protocol: TCP/IP, RS485, etc.]
    ↓ [Direct hardware communication]
    ↓
Intermediary Computer with SDK (has internet access)
    ↑ [Port forwarding: router forwards port 4370 to device IP]
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

Como os dados fluem:

  1. O funcionário passa a impressão digital no dispositivo biométrico
  2. O dispositivo armazena a transação localmente (sem envio imediato para a nuvem — o dispositivo não é compatível com a nuvem)
  3. O SDK em execução no computador intermediário consulta o dispositivo a cada 30 segundos: "Há novas transações?"
  4. O dispositivo responde com as transações coletadas desde a última consulta
  5. O SDK recebe os dados da transação, formata-os e envia uma requisição HTTPS para a API em nuvem
  6. A API em nuvem valida os dados e aciona um POST de webhook para o endpoint da aplicação parceira
  7. O parceiro recebe o registro de ponto com atraso máximo de 30 segundos em relação ao horário real da leitura

Comportamento online (o computador intermediário tem internet):

  • O SDK consulta os dispositivos a cada 30 segundos
  • As novas transações são coletadas e enviadas para a nuvem com latência de 30 segundos
  • Os webhooks são entregues à aplicação parceira a cada 30 segundos (se houver novos dados)

Comportamento offline (o computador intermediário perde a internet):

  • O SDK continua consultando os dispositivos a cada 30 segundos, coletando transações
  • O SDK armazena as transações coletadas em uma fila local no computador intermediário
  • Quando a conexão com a internet é restabelecida no computador, o SDK envia automaticamente as transações enfileiradas para a nuvem
  • Todos os dados enfileirados são entregues por webhooks, com intervalos de 30 segundos entre os lotes
  • Sem perda de dados, recuperação automática completa

Dependências de disponibilidade de dados:

  • Conectividade computador-dispositivo: o SDK precisa alcançar os dispositivos para coletar as transações (LAN, WiFi ou encaminhamento de portas)
  • Conectividade dispositivo-computador: se o dispositivo perder a conexão de rede com o computador (cabo Ethernet desconectado, WiFi fora do ar), o SDK não consegue coletar transações até que a conectividade seja restabelecida
  • Conectividade computador-nuvem: é necessária internet no computador intermediário para o envio à nuvem

Casos de uso para o Modo A:

  • Filiais com servidor local e capacidade de encaminhamento de portas
  • Lojas de varejo com PC do escritório conectado ao terminal de ponto
  • Pequenas empresas com dispositivos na mesma LAN do computador do escritório
  • Localidades distribuídas em que a configuração do roteador permite encaminhamento de portas

Modo B: Conexão com Banco de Dados por Encaminhamento de Portas

O que este modo significa:

Esta implantação se integra no nível do banco de dados, e não diretamente ao hardware biométrico. Muitos dispositivos biométricos armazenam as transações de ponto em um banco de dados local (Microsoft SQL Server, MySQL, SQLite, Access etc.). O computador intermediário se conecta a esse banco de dados por meio de encaminhamento de portas, lê os registros de transação e os envia para a nuvem.

Arquitetura técnica:

Biometric Device (writes to database)
    ↓ [Device-to-DB: whatever protocol device uses]
    ↓
Database Server (SQL Server, MySQL, etc.)
    ↑ [Port forwarding: allows intermediary to reach DB]
    ↓ [SQL queries every 30 seconds]
    ↓
Intermediary Computer with DB Connector (has internet)
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

Como os dados fluem:

  1. O funcionário passa a impressão digital no dispositivo biométrico
  2. O dispositivo grava o registro de ponto em uma tabela do banco de dados (usando a própria conexão de banco de dados do dispositivo)
  3. O computador intermediário executa o software conector de banco de dados, consultando o banco a cada 30 segundos
  4. O conector executa uma consulta SQL para obter novos registros de ponto ainda não sincronizados no banco de dados
  5. O conector recupera os novos registros, formata os dados e os envia para a API em nuvem via HTTPS
  6. O conector atualiza o banco de dados, marcando os registros como sincronizados para evitar transmissão duplicada
  7. A API em nuvem recebe os dados e aciona um webhook para a aplicação parceira

Comportamento online (o computador intermediário tem internet):

  • O conector de banco de dados consulta a cada 30 segundos
  • Os novos registros do banco de dados são enviados para a nuvem com latência de 30 segundos
  • Os webhooks são entregues à aplicação parceira com atraso do intervalo de consulta

Comportamento offline (o computador intermediário perde a internet):

  • O conector continua consultando o banco de dados a cada 30 segundos
  • O conector marca os registros como "sincronização pendente" no banco de dados
  • Quando a internet é restabelecida, o conector envia todos os registros pendentes para a nuvem
  • Os dados enfileirados são entregues automaticamente por webhooks

Dependências de disponibilidade de dados:

  • Conectividade dispositivo-banco de dados: o dispositivo deve gravar com sucesso no banco de dados (se o dispositivo perder a conexão com o banco, as transações não são armazenadas)
  • Conectividade computador-banco de dados: o conector deve alcançar o servidor de banco de dados pela rede (encaminhamento de portas ou rede local)
  • Conectividade banco de dados-computador: se o servidor de banco de dados estiver inacessível (problema de rede, servidor fora do ar), o conector não consegue ler novos registros
  • Conectividade computador-nuvem: é necessária internet no computador intermediário para a entrega dos webhooks

Limitação: sem suporte a REST API

O Modo B oferece apenas o fluxo de dados de transações. Como a integração ocorre no nível do banco de dados, o sistema não consegue enviar comandos de volta aos dispositivos biométricos. As operações REST API (adicionar usuário, configurar dispositivo, excluir cadastro) não estão disponíveis neste modo.

Por que essa limitação existe:

O envio de comandos aos dispositivos exige protocolos de comunicação em nível de hardware. A integração por banco de dados apenas lê registros de transações; ela não consegue controlar o comportamento do dispositivo nem gravar dados de cadastro de usuários nos dispositivos por meio do banco de dados.

Casos de uso para o Modo B:

  • Sistemas legados em que o fabricante do dispositivo fornece saída em banco de dados SQL
  • Ambientes em que o acesso ao banco de dados é permitido, mas o acesso ao dispositivo é restrito
  • Integração com softwares de ponto já existentes e centrados em banco de dados
  • Organizações com controle de DBA (Administrador de Banco de Dados) sobre o acesso aos dados

Modo C: Conexão com Hardware por Serviço Local

O que este modo significa:

Esta implantação instala um serviço local (serviço do Windows ou daemon do Linux) em um computador intermediário na mesma rede dos dispositivos biométricos. O serviço se comunica diretamente com o hardware do dispositivo, sem necessidade de encaminhamento de portas. Isso funciona em redes totalmente isoladas, nas quais o acesso externo não é permitido.

Arquitetura técnica:

Biometric Device (on isolated network, no internet)
    ↓ [LAN/WiFi: 192.168.1.x local network]
    ↓ [Device native protocol communication]
    ↓
Intermediary Computer with Local Service
    ↑ [Same local network, no port forwarding needed]
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

Como os dados fluem:

  1. O funcionário do chão de fábrica passa a impressão digital no terminal de ponto
  2. O dispositivo armazena a transação na memória local (dispositivo em uma rede de produção isolada)
  3. O serviço local em execução no computador intermediário (também na rede de produção) consulta o dispositivo a cada 30 segundos
  4. O serviço coleta as novas transações usando o protocolo de comunicação do dispositivo
  5. O serviço envia os dados coletados para a API em nuvem por meio da conexão com a internet do computador intermediário
  6. A API em nuvem aciona um webhook para o HRMS baseado em nuvem do parceiro

Comportamento online (o computador intermediário tem internet):

  • O serviço local consulta os dispositivos a cada 30 segundos
  • As transações são coletadas e enviadas para a nuvem com latência de 30 segundos
  • Os webhooks são entregues à aplicação parceira nos intervalos de consulta

Comportamento offline (o computador intermediário perde a internet):

  • O serviço continua consultando os dispositivos e coletando transações localmente
  • O serviço enfileira os dados no armazenamento do computador intermediário
  • Quando a internet é restabelecida, o serviço sincroniza automaticamente os dados enfileirados com a nuvem
  • Todos os registros de ponto são entregues por webhooks, sem intervenção manual

Dependências de disponibilidade de dados:

  • Conectividade computador-dispositivo: o serviço deve alcançar os dispositivos na rede local (se o switch falhar, o WiFi cair ou o cabo for desconectado, a coleta é interrompida)
  • Operação do dispositivo: os dispositivos continuam registrando o ponto localmente durante quaisquer problemas de rede
  • Conectividade computador-nuvem: é necessária internet no computador intermediário para o envio à nuvem (os próprios dispositivos não precisam de internet)

Casos de uso para o Modo C:

  • Instalações industriais com redes de produção isoladas (air-gapped)
  • Instalações governamentais que proíbem o acesso de dispositivos à internet
  • Ambientes de saúde com redes isoladas de equipamentos médicos
  • Instituições financeiras com zonas seguras separadas
  • Ambientes industriais com isolamento da rede OT em relação às redes de TI

Modo D: Conexão com Banco de Dados por Serviço Local

O que este modo significa:

O serviço local se conecta a um servidor de banco de dados na rede local, lendo as transações de ponto que os dispositivos biométricos gravam no banco de dados. Isso combina a integração com banco de dados e a implantação on-premises, sendo adequado para ambientes altamente restritos.

Arquitetura técnica:

Biometric Device (writes to local database server)
    ↓ [Device database connection protocol]
    ↓
Database Server (on isolated network, no internet)
    ↓ [SQL queries every 30 seconds]
    ↓
Intermediary Computer with Local Service
    ↑ [Same local network, reads from database]
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

Como os dados fluem:

  1. O funcionário se autentica por reconhecimento facial no terminal de controle de acesso
  2. O dispositivo grava o evento de acesso em um banco de dados SQL Server local
  3. O serviço local consulta o banco de dados a cada 30 segundos com uma consulta SQL
  4. O serviço recupera os novos registros e formata os dados
  5. O serviço envia os dados para a API em nuvem pela conexão com a internet do computador intermediário
  6. A API em nuvem entrega o webhook à aplicação em nuvem do parceiro

Comportamento online (o computador intermediário tem internet):

  • O serviço consulta o banco de dados a cada 30 segundos
  • Os novos registros do banco de dados são enviados para a nuvem com latência de 30 segundos
  • Os webhooks são entregues nos intervalos de consulta

Comportamento offline (o computador intermediário perde a internet):

  • O serviço continua consultando o banco de dados, marcando os registros como pendentes
  • Os dados ficam em fila para sincronização com a nuvem quando a internet for restabelecida
  • Recuperação automática, sem perda de dados

Dependências de disponibilidade de dados:

  • Conectividade dispositivo-banco de dados: o dispositivo deve gravar com sucesso no banco de dados (se o dispositivo perder a conexão com o banco, não há armazenamento das transações)
  • Conectividade banco de dados-serviço: o serviço deve alcançar o servidor de banco de dados na rede local (se o servidor de banco de dados estiver fora do ar, não é possível ler os registros)
  • Conectividade computador-nuvem: é necessária internet no computador intermediário para a entrega dos webhooks (o banco de dados e os dispositivos não precisam de internet)

Limitação: sem suporte a REST API

Assim como o Modo B, o Modo D oferece apenas o fluxo de dados de transações. Não há API disponível para controle de dispositivos, gerenciamento de usuários ou configuração, devido às restrições da integração em nível de banco de dados.

Casos de uso para o Modo D:

  • Setores altamente regulamentados com requisitos de soberania de dados
  • Exigências de processamento de dados exclusivamente on-premises
  • Sistemas legados centrados em banco de dados com isolamento de rede
  • Organizações que proíbem qualquer conectividade de dispositivos com a internet

Comparação de Capacidades do Hybrid Push

CapacidadeModo A: Hardware com Encaminhamento de PortaModo B: Banco de Dados com Encaminhamento de PortaModo C: Hardware com Serviço LocalModo D: Banco de Dados com Serviço Local
Envio de transações✅ Consulta a cada 30 s✅ Consulta a cada 30 s✅ Consulta a cada 30 s✅ Consulta a cada 30 s
Enfileiramento offline✅ No computador✅ No computador✅ No computador✅ No computador
Adicionar usuários✅ Sem biometria*❌ Não suportado✅ Sem biometria*❌ Não suportado
Consultar dados de usuários❌ Não suportado❌ Não suportado❌ Não suportado❌ Não suportado
Configuração do dispositivo⚠️ Limitada❌ Não suportado⚠️ Limitada❌ Não suportado
Cadastro biométrico⚠️ Somente no dispositivo local⚠️ Somente no dispositivo local⚠️ Somente no dispositivo local⚠️ Somente no dispositivo local
Encaminhamento de porta necessário✅ Sim✅ Sim❌ Não❌ Não
Internet do dispositivo necessária❌ Não❌ Não❌ Não❌ Não
Internet do computador necessária✅ Sim✅ Sim✅ Sim✅ Sim

*Esclarecimento importante sobre "Adicionar Usuários Sem Biometria":

Nos Modos Hybrid A e C, o sistema pode criar registros de usuários no dispositivo biométrico (nome, ID do funcionário, número do cartão, departamento, permissões de acesso), mas não pode enviar templates biométricos remotamente. Os funcionários devem comparecer fisicamente ao dispositivo para cadastrar sua impressão digital, rosto ou íris. Essa limitação existe porque os dispositivos implantados em modo híbrido não possuem a conectividade com a nuvem necessária para a transferência remota de templates biométricos.

Entendendo a Latência de 30 Segundos

Por que 30 segundos em vez de tempo real?

A implantação híbrida usa arquitetura de consulta (polling) em vez de arquitetura de envio (push):

  • Native Push (tempo real): o dispositivo envia proativamente os dados para a nuvem imediatamente quando o evento ocorre
  • Hybrid Push (30 s): o computador intermediário pergunta repetidamente aos dispositivos "há novos dados?" a cada 30 segundos

Mecanismo de consulta:

Second 0: Service checks devices - finds 3 new transactions - sends to cloud
Second 30: Service checks devices - finds 1 new transaction - sends to cloud
Second 60: Service checks devices - finds 0 new transactions - no webhook sent
Second 90: Service checks devices - finds 5 new transactions - sends to cloud

Por que não consultar a cada 1 segundo?

Consultas mais frequentes consomem mais largura de banda, aumentam a carga de processamento dos dispositivos e trazem benefício mínimo para casos típicos de ponto. Sistemas de ponto geralmente não exigem precisão inferior a um segundo: a latência de 30 segundos é suficiente para o processamento da folha de pagamento, o controle de turnos e o registro de acessos.

O intervalo de consulta pode ser personalizado?

A frequência de consulta pode ser ajustada (10 segundos, 60 segundos etc.) de acordo com requisitos específicos, embora 30 segundos represente o equilíbrio ideal entre desempenho quase em tempo real e eficiência no uso dos recursos do sistema.

Entendendo as Limitações de Cadastro Biométrico no Modo Híbrido

Por que as biometrias não podem ser cadastradas remotamente nos modos híbridos?

A captura do template biométrico exige:

  1. Hardware de sensor de alta qualidade (leitor óptico de impressão digital, câmera IR para o rosto, leitor de íris)
  2. Presença física para o posicionamento correto do dedo, do rosto ou o alinhamento dos olhos
  3. Múltiplas capturas para verificação da qualidade do template (normalmente de 3 a 5 leituras por dedo)
  4. Detecção de vivacidade (liveness) para evitar fraudes (verificação se a biometria é real ou falsa)

Os dispositivos implantados em modo híbrido operam offline ou com conectividade limitada. Eles não podem receber templates biométricos da nuvem porque:

  • Segurança: templates biométricos transmitidos pela rede criam risco de interceptação
  • Qualidade: envios remotos de templates não conseguem verificar a qualidade da captura biométrica
  • Capacidade do dispositivo: dispositivos implantados em modo híbrido frequentemente não possuem firmware para recepção remota de templates
  • Limitação de protocolo: dispositivos legados não suportam formatos padronizados de template

Fluxo de cadastro de usuários na implantação híbrida:

  1. O administrador cria o registro do usuário (somente Modos A/C): o sistema adiciona o nome, o ID e o departamento do funcionário ao dispositivo, sem dados biométricos
  2. A API cria o registro do usuário no dispositivo biométrico, sem template biométrico
  3. O funcionário comparece fisicamente ao terminal biométrico
  4. Cadastro local: o funcionário passa a impressão digital 3 vezes no dispositivo ou cadastra o rosto
  5. O dispositivo captura o template biométrico e o armazena localmente
  6. O dispositivo verifica a qualidade do template e o salva na memória não volátil
  7. O funcionário já pode se autenticar no dispositivo para o registro de ponto

Cadastro nos modos de banco de dados (B/D):

Como os modos de banco de dados não possuem API de gerenciamento de usuários, o cadastro ocorre inteiramente na interface local do dispositivo:

  1. O administrador usa o teclado/tela sensível ao toque do dispositivo para adicionar o usuário
  2. O funcionário cadastra a biometria diretamente no dispositivo
  3. O dispositivo grava o registro de cadastro no banco de dados
  4. O serviço intermediário lê o cadastro do usuário no banco de dados e, opcionalmente, o sincroniza com a aplicação parceira

Comparação Completa de Capacidades: Native Push vs. Hybrid Push

Matriz Detalhada de Recursos

Categoria de recursoNative Push (Web API)Hybrid Modo A/C (Hardware)Hybrid Modo B/D (Banco de Dados)
Envio de transações de ponto
Dispositivo online, com internet disponívelInstantâneo (< 1 segundo)Consulta com intervalo de 30 segundosConsulta com intervalo de 30 segundos
Dispositivo online, sem internet disponívelEnfileirado no dispositivo, envio automático ao reconectarEnfileirado no computador, envio automático ao reconectar o computadorEnfileirado no computador, envio automático ao reconectar o computador
Dispositivo offline (desligado)Enfileirado no dispositivo quando ligadoNão é possível coletar até o dispositivo ligarNão é possível coletar até o dispositivo gravar no banco
Entrega de webhook/callback
Método de entregaPOST HTTPS em tempo realPOST HTTPS baseado em consultaPOST HTTPS baseado em consulta
URL do webhookEndpoint configurado pelo parceiroEndpoint configurado pelo parceiroEndpoint configurado pelo parceiro
Formato dos dadosJSON com detalhes completos da transaçãoJSON com detalhes completos da transaçãoJSON com detalhes completos da transação
Mecanismo de nova tentativaNova tentativa automática em caso de falhaNova tentativa automática em caso de falhaNova tentativa automática em caso de falha
Operações de gerenciamento de usuários
Adicionar usuário com dados biográficos✅ Suporte completo✅ Suporte básico❌ Não disponível
Cadastrar templates biométricos remotamente✅ Envio pela nuvem❌ Somente cadastro local❌ Somente cadastro local
Consultar a base de usuários do dispositivo✅ Lista completa❌ Não disponível❌ Não disponível
Atualizar informações de usuários✅ Modificação completa⚠️ Limitada via dispositivo❌ Não disponível
Excluir cadastros de usuários✅ Remoção pela nuvem⚠️ Limitada via dispositivo❌ Não disponível
Envio de usuários em lote✅ Operações em massa❌ Não disponível❌ Não disponível
Sincronização entre dispositivos✅ Sincronização automática❌ Não disponível❌ Não disponível
Operações de gerenciamento de dispositivos
Consultar status e saúde do dispositivo✅ Diagnóstico completo⚠️ Dados limitados❌ Não disponível
Configurar parâmetros do dispositivo✅ Controle completo⚠️ Somente configurações básicas❌ Não disponível
Atualizações remotas de firmware✅ Suportado❌ Não disponível❌ Não disponível
Consultar logs do sistema do dispositivo✅ Acesso completo❌ Não disponível❌ Não disponível
Enviar comandos ao dispositivo✅ Todos os comandos⚠️ Comandos limitados❌ Não disponível
Gerenciar agendas de acesso✅ Agendamento completo⚠️ Suporte básico❌ Não disponível
Operações de dados de ponto
Webhooks de transações em tempo real✅ Envio instantâneo✅ Entrega em 30 s✅ Entrega em 30 s
Consultar ponto histórico✅ Consultas por todo o período⚠️ Somente via webhooks⚠️ Somente via webhooks
Lançamento manual de ponto✅ Suporte via API❌ Não disponível❌ Não disponível
Excluir/modificar registros✅ Suportado❌ Não disponível❌ Não disponível
Requisitos de rede
Acesso à internet do dispositivo necessário✅ Sim (intermitente é aceitável)❌ Não❌ Não
Computador intermediário necessário❌ Não✅ Sim✅ Sim
Internet do intermediário necessária❌ N/A✅ Sim✅ Sim
Encaminhamento de porta necessário❌ Não✅ Somente Modos A/B❌ Modos C/D
Configuração de firewallSomente saída 443Saída 443 a partir do computadorSaída 443 a partir do computador
Resiliência offline
Onde os dados ficam enfileirados durante o offlineMemória interna do dispositivoArmazenamento do computador intermediárioArmazenamento do computador intermediário
Sincronização automática ao reconectar✅ Sim✅ Sim✅ Sim
Capacidade máxima de armazenamento offline50.000-100.000 registros (depende do dispositivo)Limitada pelo espaço em disco do computadorLimitada pelo espaço em disco do computador
Características de desempenho
Latência média (online)< 1 segundo~30 segundos~30 segundos
Largura de banda por dispositivo10-50 KbpsMínima (somente computador-nuvem)Mínima (somente computador-nuvem)
EscalabilidadeMilhares de dispositivosLimitada pela capacidade do computadorLimitada pela capacidade do computador

Recomendações de Uso

Escolha o Native Push quando:

  • ✅ Estiver implantando um novo sistema biométrico com dispositivos modernos
  • ✅ Os dispositivos forem aprovados na verificação de compatibilidade em developer.camsbiometrics.com
  • ✅ Os dispositivos puderem acessar a internet (diretamente ou pela rede corporativa)
  • ✅ A visibilidade do ponto em tempo real for importante
  • ✅ For necessária a capacidade de gerenciamento remoto de usuários
  • ✅ A estratégia de TI for focada na nuvem
  • ✅ For uma implantação em múltiplas localidades (varejo, filiais)
  • ✅ Houver preferência por SaaS (Software como Serviço)
  • ✅ For desejado investimento mínimo em infraestrutura de TI

Escolha o Hybrid Modo A (Encaminhamento de Porta no Hardware) quando:

  • ⚠️ Os dispositivos tiverem sido reprovados na verificação de compatibilidade
  • ⚠️ Forem dispositivos legados sem firmware de nuvem
  • ⚠️ A rede permitir a configuração de encaminhamento de portas
  • ⚠️ For possível a integração em nível de dispositivo
  • ⚠️ For necessária gestão básica de usuários
  • ⚠️ A latência de 30 segundos for aceitável
  • ⚠️ Houver um computador intermediário disponível

Escolha o Hybrid Modo B (Encaminhamento de Porta para Banco de Dados) quando:

  • ⚠️ Os dispositivos gravarem em banco de dados (SQL Server, MySQL etc.)
  • ⚠️ O acesso ao banco de dados for concedido, mas o acesso ao dispositivo for restrito
  • ⚠️ O encaminhamento de portas para o servidor de banco de dados for viável
  • ⚠️ For necessário apenas o fluxo de dados de transações (sem necessidade de controle do dispositivo)
  • ⚠️ Já existir software de ponto baseado em banco de dados
  • ⚠️ O DBA controlar todo o acesso aos dados

Escolha o Hybrid Modo C (Serviço Local no Hardware) quando:

  • ⚠️ Houver rede isolada (air-gapped) ou dispositivos isolados
  • ⚠️ A política de segurança proibir o acesso dos dispositivos à internet
  • ⚠️ O encaminhamento de portas não for permitido ou possível
  • ⚠️ Houver um servidor/PC on-premises disponível com acesso à internet
  • ⚠️ For possível a integração em nível de dispositivo
  • ⚠️ Forem ambientes industriais, governamentais ou de saúde com isolamento de rede
  • ⚠️ For necessário controle básico do dispositivo

Escolha o Hybrid Modo D (Serviço Local para Banco de Dados) quando:

  • ⚠️ For necessária somente integração via banco de dados
  • ⚠️ A rede (dispositivos e banco de dados) for totalmente isolada
  • ⚠️ Houver exigências de soberania de dados ou de conformidade
  • ⚠️ Houver exigência de processamento on-premises
  • ⚠️ Interessar apenas o fluxo de transações (sem necessidade de controle por API)
  • ⚠️ Forem sistemas legados sem caminho de modernização

Requisitos de Infraestrutura e Dependências de Rede

Requisitos de Infraestrutura do Native Push

No local do dispositivo:

  • Conectividade com a internet (WiFi, Ethernet, celular 4G/5G ou satélite)
  • A conexão de rede pode ser intermitente (os dispositivos enfileiram os dados durante as desconexões)
  • Largura de banda mínima: 10-50 Kbps por dispositivo
  • Latência de rede: < 5000 ms aceitável (funciona com satélite)

Regras de firewall:

  • Permitir HTTPS de saída (TCP porta 443) da sub-rede dos dispositivos para api.camsbiometrics.com
  • Não são necessárias regras de entrada (os dispositivos iniciam todas as conexões)
  • Compatível com NAT/PAT (Network/Port Address Translation)

Requisitos de DNS:

  • Os dispositivos devem resolver o domínio api.camsbiometrics.com
  • Servidores DNS corporativos padrão são aceitáveis
  • Alternativa: configurar DNS estático (8.8.8.8 DNS do Google etc.)

Compatibilidade com a topologia de rede:

  • ✅ Acesso direto à internet
  • ✅ Servidores proxy corporativos (com autenticação)
  • ✅ NAT/Firewall com HTTPS de saída permitido
  • ✅ Túneis VPN
  • ✅ VPC (Nuvem Privada Virtual) na nuvem com gateway de internet
  • ❌ Redes isoladas (air-gapped) (use o modo Hybrid)
  • ❌ Redes que bloqueiam todas as conexões de saída (use o modo Hybrid)

Requisitos de Infraestrutura do Hybrid Modo A

Especificações do computador intermediário:

  • SO: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+ ou Debian 11+
  • CPU: Dual-core de 2,0 GHz no mínimo (quad-core recomendado para mais de 50 dispositivos)
  • RAM: 4 GB no mínimo (8 GB recomendados)
  • Armazenamento: 20 GB disponíveis (para o SDK e o enfileiramento de dados)
  • Rede: Ethernet ou WiFi com conectividade estável

Topologia de rede:

Internet (Cloud API)
    ↑
    | [HTTPS outbound]
    |
Intermediary Computer (has internet access)
    ↑
    | [Port forwarding through router/firewall]
    |
Router/Firewall (forwards port 4370 to device)
    ↑
    | [Local network or cross-subnet routing]
    |
Biometric Device(s) (no internet required)

Configuração de encaminhamento de portas:

  • Configurar o roteador para encaminhar a porta TCP (normalmente 4370, dependendo do dispositivo) para o endereço IP do dispositivo
  • Recomenda-se IP estático ou reserva DHCP para os dispositivos biométricos
  • Não é necessário encaminhamento de portas a partir da interface WAN (rede de longa distância) — somente encaminhamento interno

Conectividade computador-dispositivo:

  • Dispositivos na mesma sub-rede LAN do intermediário: comunicação direta
  • Dispositivos em sub-rede diferente: é necessário encaminhamento de portas ou roteamento
  • Protocolos suportados: TCP/IP, RS485 (com conversor), USB (conexão local)

Conectividade computador-nuvem:

  • Conexão estável com a internet no computador intermediário
  • HTTPS de saída (porta 443) para api.camsbiometrics.com
  • Largura de banda mínima: 100 Kbps (aumenta com a quantidade de dispositivos)

Requisitos de Infraestrutura do Hybrid Modo B

Especificações do computador intermediário:

  • SO: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+
  • CPU: Dual-core de 2,0 GHz no mínimo
  • RAM: 4 GB no mínimo (8 GB para bancos de dados grandes)
  • Armazenamento: 10 GB disponíveis
  • Cliente de banco de dados: ferramentas do SQL Server, MySQL Connector, cliente PostgreSQL (conforme o tipo de banco de dados)

Topologia de rede:

Internet (Cloud API)
    ↑
    | [HTTPS outbound]
    |
Intermediary Computer (has internet access)
    ↑
    | [SQL connection via port forwarding]
    |
Router/Firewall (forwards SQL port to database server)
    ↑
    | [Database network]
    |
Database Server (SQL Server: 1433, MySQL: 3306, etc.)
    ↑
    | [Device-specific database protocol]
    |
Biometric Device(s) (write to database)

Requisitos de acesso ao banco de dados:

  • Credenciais do banco de dados: usuário e senha com permissões SELECT e UPDATE
  • String de conexão com o banco: IP do servidor, porta, nome do banco de dados
  • Encaminhamento de portas: o roteador encaminha a porta do banco de dados (1433, 3306 etc.) para o servidor de banco de dados
  • Bancos de dados suportados: SQL Server, MySQL, PostgreSQL, Oracle, SQLite, MS Access

Conectividade computador-banco de dados:

  • Caminho de rede do computador intermediário até o servidor de banco de dados
  • Porta do banco de dados acessível (diretamente ou por encaminhamento de portas)
  • Regras de firewall do banco de dados permitem o endereço IP do computador

Conectividade computador-nuvem:

  • Acesso à internet no computador intermediário
  • HTTPS de saída (porta 443) permitido

Importante: dependência dispositivo-banco de dados

A disponibilidade dos dados depende de os dispositivos gravarem com sucesso no banco de dados:

  • Se o dispositivo perder a conexão de rede com o servidor de banco de dados, as transações não são armazenadas
  • Se o servidor de banco de dados falhar, as transações são perdidas até a recuperação
  • O banco de dados deve estar acessível aos dispositivos para o registro das transações
  • Recomenda-se backup/redundância para o servidor de banco de dados

Requisitos de Infraestrutura do Hybrid Modo C

Especificações do computador intermediário:

  • SO: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+
  • CPU: Dual-core de 2,0 GHz no mínimo (quad-core para mais de 100 dispositivos)
  • RAM: 4 GB no mínimo (8 GB recomendados)
  • Armazenamento: 20 GB disponíveis
  • Rede: recomendadas duas interfaces de rede (uma para os dispositivos locais e outra para a internet)

Topologia de rede:

Internet (Cloud API)
    ↑
    | [HTTPS outbound via internet-connected interface]
    |
Intermediary Computer (dual-homed: local network + internet)
    |
    | [Local network interface - no port forwarding required]
    ↓
Local Network Switch/WiFi (isolated from internet)
    ↓
Biometric Device(s) (on isolated network, no internet)

Configuração de computador com dupla conexão (dual-homed):

Opção 1: duas interfaces de rede físicas

  • NIC 1: conectada à rede local isolada com os dispositivos biométricos (192.168.1.x)
  • NIC 2: conectada à rede corporativa com acesso à internet (10.0.0.x)
  • O serviço local se comunica com os dispositivos pela NIC 1
  • O serviço local envia os dados para a nuvem pela NIC 2

Opção 2: WiFi + Ethernet

  • Ethernet: conectada à rede isolada dos dispositivos
  • WiFi: conectado a uma rede sem fio com acesso à internet
  • O serviço se vincula à interface adequada para cada comunicação

Conectividade computador-dispositivo:

  • Mesma sub-rede local (sem necessidade de roteamento)
  • Dispositivos acessíveis pela LAN (teste de ping: ping 192.168.1.100)
  • Não é necessário encaminhamento de portas (acesso local direto)
  • Protocolos suportados: TCP/IP, RS485 (com conversor USB), Wiegand (com controlador)

Conectividade computador-nuvem:

  • Acesso à internet por interface de rede separada
  • HTTPS de saída (porta 443) para api.camsbiometrics.com
  • Rede corporativa ou conexão direta com a internet

Considerações sobre redes isoladas (air-gapped):

  • Dispositivos biométricos em uma rede totalmente isolada (sem acesso à internet)
  • O computador intermediário faz a ponte entre a rede isolada e a internet
  • Garante a conformidade com políticas de segurança que proíbem o acesso de IoT à internet
  • Fluxo de dados: Dispositivos → Rede Local → Computador → Internet → Nuvem

Requisitos de Infraestrutura do Hybrid Modo D

Especificações do computador intermediário:

  • SO: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+
  • CPU: Dual-core de 2,0 GHz no mínimo
  • RAM: 4 GB no mínimo (8 GB para bancos de dados grandes)
  • Armazenamento: 10 GB disponíveis
  • Cliente de banco de dados: ferramentas apropriadas para o tipo de banco de dados

Topologia de rede:

Internet (Cloud API)
    ↑
    | [HTTPS outbound via internet-connected interface]
    |
Intermediary Computer (dual-homed: local network + internet)
    |
    | [Local network interface - direct database access]
    ↓
Local Network (isolated from internet)
    ↓
Database Server (no internet access)
    ↑
    | [Device database protocol]
    |
Biometric Device(s) (isolated network, no internet)

Acesso ao banco de dados:

  • Servidor de banco de dados em rede local isolada
  • Computador intermediário na mesma rede (acesso SQL direto)
  • Não é necessário encaminhamento de portas (mesma sub-rede)
  • Credenciais do banco de dados com permissões SELECT e UPDATE

Conectividade computador-banco de dados:

  • Acesso à rede local até o servidor de banco de dados
  • Porta do banco de dados acessível (1433, 3306 etc.)
  • O firewall do banco de dados permite o IP do computador local

Conectividade computador-nuvem:

  • Internet por interface de rede separada
  • HTTPS de saída (porta 443) permitido

Dependência dispositivo-banco de dados:

  • Os dispositivos gravam as transações no servidor de banco de dados local
  • O banco de dados deve estar acessível aos dispositivos na rede local
  • Se o dispositivo perder a conexão com o banco, as transações não são armazenadas
  • O tempo de atividade do servidor de banco de dados é crítico para a disponibilidade dos dados

Dependências de Conectividade e Fluxo de Dados

Entendendo as Dependências Críticas

Cada modo de implantação possui dependências de conectividade específicas que determinam a disponibilidade dos dados:

Dependências de conectividade do Native Push

Ponto único de dependência:

Biometric Device ←→ Internet ←→ Cloud API

O que deve funcionar para o fluxo de dados:

  1. O dispositivo deve ter conectividade com a internet
  2. O dispositivo deve alcançar api.camsbiometrics.com (resolução DNS, firewall permite HTTPS)

Cenários de falha:

  • Dispositivo offline (desligado, cabo de rede desconectado): o dispositivo enfileira as transações internamente e as envia automaticamente quando for ligado e conectado
  • Internet fora do ar (falha do provedor, falha do roteador): o dispositivo enfileira as transações e as envia automaticamente quando a internet for restabelecida
  • API em nuvem indisponível (extremamente raro, manutenção programada): o dispositivo tenta reconectar e enfileira os dados até que a API esteja acessível

Prevenção de perda de dados:

  • Os dispositivos armazenam de 50.000 a 100.000 transações na memória interna
  • Mecanismo automático de nova tentativa com backoff exponencial
  • Os dados persistem após ciclos de energia (armazenamento não volátil)

Dependências de conectividade dos Modos A/C do Hybrid

Dois pontos de dependência:

Device ←→ Intermediary Computer ←→ Internet ←→ Cloud API

O que deve funcionar para o fluxo de dados:

  1. Dispositivo-computador: o computador deve alcançar o dispositivo (conectividade LAN, encaminhamento de portas ou acesso à rede local)
  2. Computador-nuvem: o computador deve ter acesso à internet para entregar os webhooks

Cenários de falha:

O dispositivo perde energia:

  • O dispositivo para de registrar transações
  • O computador não consegue consultar o dispositivo
  • Quando o dispositivo for ligado, o computador retoma as consultas e coleta as transações enfileiradas

O computador perde a conexão com o dispositivo:

  • O computador não consegue coletar novas transações
  • Os dispositivos continuam registrando e armazenando localmente
  • Quando a conectividade for restabelecida, o computador consulta e recupera as transações acumuladas

O computador perde a internet:

  • O computador continua consultando os dispositivos e coletando transações
  • O computador enfileira localmente as transações coletadas
  • Quando a internet for restabelecida, o computador envia automaticamente os dados enfileirados para a nuvem

Dispositivo e computador offline:

  • Nenhuma coleta ou transmissão de dados
  • Os dispositivos enfileiram as transações internamente
  • Quando ambos forem restabelecidos, o computador coleta os dados dos dispositivos e os envia para a nuvem

Limitação de disponibilidade de dados: se um dispositivo estiver offline ou inacessível para o computador, este não consegue coletar as transações desse dispositivo até que a conectividade entre eles seja restabelecida. O computador só pode enviar para a nuvem aquilo que coletou com sucesso dos dispositivos.

Dependências de conectividade dos Modos B/D do Hybrid

Três pontos de dependência:

Device ←→ Database ←→ Intermediary Computer ←→ Internet ←→ Cloud API

O que deve funcionar para o fluxo de dados:

  1. Dispositivo-banco de dados: o dispositivo deve gravar com sucesso as transações no banco de dados
  2. Banco de dados-computador: o computador deve ler o banco de dados (acesso de consulta)
  3. Computador-nuvem: o computador deve ter internet para entregar os webhooks

Cenários de falha:

O dispositivo perde a conexão com o banco de dados:

  • O dispositivo não consegue armazenar transações no banco de dados
  • As transações são perdidas ou enfileiradas no dispositivo (comportamento dependente do dispositivo)
  • O computador não consegue recuperar dados que nunca foram gravados no banco de dados

O servidor de banco de dados falha:

  • Os dispositivos não conseguem gravar novas transações
  • O computador não consegue ler as transações existentes
  • Os dados gravados no banco antes da falha podem ficar disponíveis quando o banco for restabelecido

O computador perde o acesso ao banco de dados:

  • O computador não consegue ler novas transações
  • Os dispositivos continuam gravando no banco de dados (se o banco estiver acessível aos dispositivos)
  • Quando a conectividade computador-banco de dados for restabelecida, o computador lê os registros acumulados

O computador perde a internet:

  • O computador continua lendo o banco de dados
  • O computador enfileira localmente os registros do banco
  • Quando a internet for restabelecida, o computador envia os dados enfileirados para a nuvem

Entendimento crítico para os Modos B/D:

O banco de dados funciona como armazenamento intermediário entre os dispositivos e o computador. O fluxo de dados depende de:

  1. Os dispositivos gravarem com sucesso no banco de dados
  2. O banco de dados permanecer acessível ao computador
  3. O computador ler o banco de dados e enviar os dados para a nuvem

Se os dispositivos não conseguirem gravar no banco de dados (problema de rede, banco fora do ar), as transações não são armazenadas e não podem ser recuperadas depois. Essa é a principal limitação dos modos dependentes de banco de dados.

Tratamento de Dados Offline e Recuperação Automática

Tratamento offline no Native Push:

Exemplo de cenário — queda de internet em uma loja de varejo:

9:00 AM - Internet outage begins
9:05 AM - Employee scans fingerprint → Device stores locally (queue: 1 transaction)
9:15 AM - Employee scans fingerprint → Device stores locally (queue: 2 transactions)
9:30 AM - Employee scans fingerprint → Device stores locally (queue: 3 transactions)
11:00 AM - Internet restored
11:00:05 AM - Device detects connectivity, automatically pushes all 3 queued transactions
11:00:06 AM - Cloud API receives transactions, triggers webhooks
11:00:07 AM - Partner application receives all 3 attendance records

Não é necessária intervenção manual. O dispositivo cuida do enfileiramento, da detecção da restauração da conectividade e da sincronização automática.

Tratamento offline nos Modos A/C do Hybrid:

Exemplo de cenário — unidade industrial com conectividade intermitente com o servidor:

2:00 PM - Intermediary computer loses internet (local network still operational)
2:05 PM - Service polls devices, collects 5 new transactions, queues locally
2:35 PM - Service polls devices, collects 3 new transactions, queues locally (total: 8)
3:05 PM - Service polls devices, collects 2 new transactions, queues locally (total: 10)
4:00 PM - Internet restored to computer
4:00:10 PM - Service detects connectivity, pushes first batch of queued transactions
4:00:40 PM - Service pushes second batch
4:01:10 PM - Service pushes third batch
4:01:40 PM - All queued data delivered, service resumes normal 30-second polling

Enfileiramento automático no armazenamento do computador, detecção automática da restauração da internet e entrega automática em lotes dos dados enfileirados.

Tratamento offline nos Modos B/D do Hybrid:

Exemplo de cenário — unidade de saúde com manutenção do servidor de banco de dados:

10:00 PM - Database server taken offline for maintenance
10:30 PM - Devices cannot write to database (transactions lost if not stored on device)
11:00 PM - Database server brought back online
11:00:05 PM - Devices resume writing to database
11:30 PM - Computer polls database, retrieves transactions written since 11:00 PM
11:30:05 PM - Computer pushes retrieved transactions to cloud via webhooks

Diferença crítica: as transações que ocorrem enquanto o banco de dados está indisponível (22h00 – 23h00) dependem do comportamento do dispositivo:

  • Dispositivos com enfileiramento interno: armazenam as transações e gravam no banco quando acessível (sem perdas)
  • Dispositivos sem enfileiramento interno: transações perdidas durante a indisponibilidade do banco de dados

É por isso que os Modos B/D exigem uma avaliação cuidadosa das capacidades dos dispositivos e da confiabilidade do banco de dados.

Cenários Reais de Implantação e Exemplos

Cenário 1: Rede Nacional de Varejo — Native Push

Perfil da organização:

  • Mais de 500 lojas de varejo em todo o país
  • Terminais ZKTeco MultiBio 800 de face + impressão digital em cada localidade
  • HRMS corporativo baseado em nuvem (SAP SuccessFactors)
  • Requisito: visibilidade do ponto em tempo real para a gestão de turnos

Infraestrutura:

  • Cada loja possui rede WiFi com acesso à internet
  • O firewall corporativo permite HTTPS de saída
  • Dispositivos verificados como compatíveis em developer.camsbiometrics.com

Implantação:

  • Modo: Native Push com Web API completa
  • Configuração do dispositivo: dispositivos configurados com o endpoint da API em nuvem e chaves de API exclusivas por localidade
  • Rede: os dispositivos se conectam pelo WiFi da loja e se comunicam diretamente com a nuvem
  • Gerenciamento de usuários: a equipe de RH envia os dados dos funcionários pela API, e os funcionários cadastram suas biometrias nos dispositivos da loja

Fluxo de dados:

Employee scans face at 9:00:00 AM
    ↓ [< 1 second]
Device pushes to cloud at 9:00:00.5 AM
    ↓ [< 0.5 seconds]
Cloud triggers webhook at 9:00:01 AM
    ↓ [< 1 second]
SAP SuccessFactors receives attendance at 9:00:02 AM
Total latency: 2 seconds from scan to HRMS

Benefícios obtidos:

  • Os gerentes de loja veem o ponto em tempo real para a programação de turnos
  • Alertas instantâneos para atrasos ou faltas sem aviso
  • Controle centralizado de mais de 500 dispositivos a partir da matriz
  • Solução de problemas e atualizações de configuração remotas
  • Zero sincronização manual de dados

Tratamento de quedas de internet nas lojas:

  • A internet da loja cai às 10h
  • Os dispositivos continuam registrando o ponto localmente (armazenado na memória do dispositivo)
  • A internet é restabelecida às 14h
  • Os dispositivos enviam automaticamente, em poucos segundos, as 4 horas de registros de ponto enfileirados
  • Sem perda de dados, sem intervenção manual

Cenário 2: Unidade Industrial — Hybrid Modo C (Isolada, Air-Gapped)

Perfil da organização:

  • Fábrica de autopeças automotivas
  • 200 funcionários em 3 turnos
  • Chão de fábrica em rede isolada (air-gapped por segurança)
  • Dispositivos legados Suprema BioEntry Plus (com mais de 10 anos, sem capacidade de nuvem)
  • ERP corporativo (Oracle) exige integração do ponto

Infraestrutura:

  • Rede de produção: 192.168.10.x (completamente isolada, sem internet)
  • Rede corporativa: 10.0.5.x (com internet)
  • Servidor gateway com duas interfaces de rede faz a ponte entre as duas redes
  • A política de segurança proíbe qualquer acesso à internet pelos dispositivos de produção

Implantação:

  • Modo: Hybrid Modo C (Serviço Local para Hardware)
  • Intermediário: Windows Server 2019 com duas NICs (uma por rede)
  • Serviço local: Cams Local Service instalado, consulta os dispositivos a cada 30 segundos
  • Acesso aos dispositivos: comunicação TCP/IP direta na rede de produção (sem necessidade de encaminhamento de portas)

Topologia de rede:

Production Floor (Air-Gapped: 192.168.10.x)
    |
    |- Biometric Device 1: 192.168.10.101
    |- Biometric Device 2: 192.168.10.102
    |- Biometric Device 3: 192.168.10.103
    |- Gateway Server NIC 1: 192.168.10.200
          |
          |- (Same physical server)
          |
    Gateway Server NIC 2: 10.0.5.50
    |
Corporate Network (Internet-Enabled: 10.0.5.x)
    |
Internet → Cloud API → Oracle ERP

Fluxo de dados:

9:00:00 AM - Employee scans fingerprint at Device 1 (192.168.10.101)
9:00:00 AM - Device stores transaction locally
9:00:15 AM - Local Service polls Device 1: "Any new transactions?"
9:00:15.5 AM - Device responds with transaction data
9:00:16 AM - Service sends transaction to cloud via NIC 2 (10.0.5.50)
9:00:17 AM - Cloud triggers webhook to Oracle ERP
9:00:18 AM - ERP receives attendance record
Total latency: ~18 seconds (within 30-second polling window)

Benefícios obtidos:

  • Mantém a política de segurança air-gapped (os dispositivos nunca acessam a internet)
  • Funciona com dispositivos legados que não puderam ser atualizados
  • Dados de ponto centralizados, apesar do isolamento da rede
  • O servidor gateway gerencia a travessia da fronteira de segurança
  • A equipe de segurança de TI aprovou a implantação (sem violações de política)

Tratamento de queda do servidor gateway:

  • O servidor gateway perde a internet às 14h (a rede de produção continua operacional)
  • Os dispositivos continuam registrando o ponto na rede isolada
  • O Serviço Local continua consultando os dispositivos e coletando transações
  • O serviço enfileira os dados coletados no armazenamento do servidor gateway
  • A internet é restabelecida às 16h
  • O serviço envia automaticamente as 2 horas de dados enfileirados para a nuvem
  • O ERP recebe todos os registros de ponto, sem perda de dados

Cenário 3: Escritório Corporativo com Múltiplas Localidades — Hybrid Modo A (Encaminhamento de Portas)

Perfil da organização:

  • Empresa de serviços profissionais com 50 filiais
  • Mix de dispositivos: eSSL K21 Pro, Anviz FacePass, modelos ZKTeco F18 mais antigos
  • Alguns dispositivos verificados como compatíveis, outros reprovados na verificação
  • Política da empresa: todos os dispositivos devem usar o mesmo método de integração (consistência)
  • Plataforma de RH baseada em nuvem (Workday)

Infraestrutura:

  • Cada filial possui um servidor local (Windows Server ou Linux)
  • VPN corporativa conecta todas as localidades
  • Dispositivos na rede local de cada filial (192.168.x.x)
  • Os servidores locais têm acesso à internet
  • Encaminhamento de portas configurado nos roteadores das filiais

Implantação:

  • Modo: Hybrid Modo A (Hardware via Encaminhamento de Portas com SDK)
  • Intermediário: servidor em cada filial executando o SDK da Cams
  • Configuração do SDK: conecta-se aos dispositivos por encaminhamento de portas
  • Motivo para o Hybrid: mix de dispositivos compatíveis e incompatíveis; implantação padronizada em todas as localidades

Exemplo de configuração de rede — filial:

Branch Office Network (192.168.1.x)
    |
    |- Device 1: 192.168.1.50 (eSSL K21 Pro - compatible but using hybrid for consistency)
    |- Device 2: 192.168.1.51 (Anviz FacePass - failed verification, requires hybrid)
    |- Branch Server: 192.168.1.100 (runs SDK, has internet)
    |
Branch Router (port forwarding)
    |- Forwards port 4370 → 192.168.1.50
    |- Forwards port 4371 → 192.168.1.51
    |
Internet → Cloud API → Workday

Configuração de consulta do SDK:

SDK polls Device 1 every 30 seconds at 192.168.1.50:4370
SDK polls Device 2 every 30 seconds at 192.168.1.51:4371

Fluxo de dados:

10:30:00 AM - Employee scans at Device 2 (Anviz FacePass)
10:30:00 AM - Device stores transaction
10:30:15 AM - SDK polls Device 2, retrieves transaction
10:30:16 AM - SDK sends to cloud API
10:30:17 AM - Cloud triggers webhook to Workday
10:30:18 AM - Workday receives attendance
Latency: ~18 seconds

Fluxo de gerenciamento de usuários:

HR adds new employee in Workday
Workday triggers system to create user
    ↓
System adds user on Device 2 (without biometric)
    ↓
Employee visits branch office, enrolls fingerprint locally at Device 2
    ↓
Device stores template, employee can now authenticate

Benefícios obtidos:

  • Integração padronizada em todas as 50 filiais, apesar da compatibilidade mista dos dispositivos
  • Funcionamento com dispositivos que foram reprovados na verificação em nuvem
  • Gestão centralizada a partir da matriz
  • Experiência consistente para a equipe de RH
  • Uma única integração mantida entre tipos e idades de dispositivos

Cenário 4: Campus Hospitalar — Hybrid Modo D (Banco de Dados, Conformidade)

Perfil da organização:

  • Hospital com 5 prédios e mais de 1.000 funcionários
  • Terminais de impressão digital Realtime T502 (15 dispositivos no total)
  • Dispositivos gravam em um banco SQL Server local
  • A conformidade com a HIPAA exige processamento de dados on-premises
  • Nenhum dispositivo biométrico tem permissão para acessar a internet (política de segurança)
  • Integração necessária com o sistema de gestão de força de trabalho do hospital

Infraestrutura:

  • Todos os dispositivos estão na rede interna do hospital (172.16.x.x)
  • Banco SQL Server 2019 no data center do hospital (172.16.10.50)
  • Os dispositivos gravam o ponto em uma tabela do banco de dados
  • Servidor de aplicação com acesso à internet para integração com a nuvem (172.16.20.100)
  • Requisito de soberania de dados: dados biométricos nunca saem das instalações

Implantação:

  • Modo: Hybrid Modo D (Serviço Local para Banco de Dados)
  • Intermediário: servidor de aplicação executando o Cams Local Service
  • Acesso ao banco: o serviço lê do SQL Server a cada 30 segundos
  • Sem controle de dispositivos: o serviço apenas lê; não pode gerenciar os dispositivos

Topologia de rede:

Hospital Internal Network (172.16.x.x)
    |
    |- Biometric Devices (15 devices, various buildings)
    |    ↓ [Write attendance to SQL Server]
    |
    |- SQL Server: 172.16.10.50
    |    ↑ [Service reads attendance table]
    |
    |- Application Server: 172.16.20.100 (has internet)
         ↓ [HTTPS to cloud]
         |
Internet → Cloud API → Workforce Management System

Consulta ao banco de dados:

-- Service executes every 30 seconds
SELECT 
    PunchID, EmployeeID, PunchTime, DeviceID, VerifyMode
FROM AttendanceDB.dbo.PunchLog
WHERE SyncStatus = 'Pending'
ORDER BY PunchTime ASC;

-- After successful cloud push
UPDATE AttendanceDB.dbo.PunchLog
SET SyncStatus = 'Synced', SyncTime = GETDATE()
WHERE PunchID IN (...);

Fluxo de dados:

7:00:00 AM - Nurse scans fingerprint at Building A device
7:00:00.5 AM - Device writes to SQL Server attendance table
7:00:15 AM - Local Service polls database, finds new record
7:00:16 AM - Service sends transaction to cloud
7:00:17 AM - Cloud triggers webhook to workforce system
7:00:18 AM - Workforce system receives attendance
Latency: ~18 seconds from scan to system

Conformidade com a HIPAA mantida:

  • Os templates biométricos nunca saem da rede do hospital (armazenados somente nos dispositivos)
  • Somente transações de ponto (carimbo de data/hora, ID do funcionário) são transmitidas para a nuvem
  • Nenhuma PHI (Informação de Saúde Protegida) nos dados de ponto
  • Dispositivos isolados da internet (não podem ser acessados remotamente)
  • Registros de acesso ao banco de dados mantidos para trilha de auditoria

Limitação aceita:

  • Sem recursos de gerenciamento de usuários (usuários gerenciados na interface local do dispositivo)
  • Sem configuração remota de dispositivos
  • Somente fluxo de dados de transações (aceitável para os requisitos do hospital)

Benefícios obtidos:

  • Conformidade total com as políticas de segurança de dados de saúde
  • Integração com o sistema de força de trabalho em nuvem sem violações de política
  • Funcionamento com a infraestrutura de banco de dados existente
  • Nenhuma alteração na implantação dos dispositivos ou nos fluxos dos usuários
  • Trilha de auditoria de todos os eventos de sincronização de dados

Cenário 5: Instalação Governamental — Hybrid Modo C (Segurança Máxima)

Perfil da organização:

  • Instalação de empreiteira de defesa com áreas classificadas
  • 50 funcionários com credenciais de segurança
  • Leitores de impressão digital Morpho MSO 1300 nos pontos de controle de acesso
  • Instalação em rede isolada (SCIF — Instalação de Informações Sensíveis e Compartimentadas — requisitos)
  • Nenhum dispositivo conectado à internet é permitido nas áreas seguras
  • Integração necessária com o sistema de gestão de terceirizados

Infraestrutura:

  • Rede da área segura: 10.20.30.x (completamente isolada, sem conectividade externa)
  • Rede administrativa: 10.50.60.x (acesso limitado à internet para sistemas aprovados)
  • Separação física (air gap) entre as redes, imposta pela política de segurança
  • Diodo de dados unidirecional da rede segura para a administrativa (considerado e rejeitado — o caso de uso exige comunicação bidirecional)
  • Servidor com dupla conexão: somente o sistema autorizado faz a ponte entre as redes

Implantação:

  • Modo: Hybrid Modo C (Serviço Local para Hardware)
  • Intermediário: Windows Server reforçado com duas placas de rede (certificado para operação entre domínios)
  • Credencial de segurança: servidor fisicamente localizado em sala de acesso controlado
  • Registro de auditoria: todas as transferências de dados são registradas para conformidade de segurança

Arquitetura de rede:

Secure Area Network (10.20.30.x - NO INTERNET)
    |
    |- Access Control Point 1: 10.20.30.101
    |- Access Control Point 2: 10.20.30.102
    |- Access Control Point 3: 10.20.30.103
    |- Dual-Homed Server NIC 1: 10.20.30.200
          |
          |- (Physical server in secure control room)
          |
    Dual-Homed Server NIC 2: 10.50.60.50
    |
Administrative Network (10.50.60.x - LIMITED INTERNET)
    |
Internet (through security gateway) → Cloud API → Contractor Management System

Controles de segurança:

  • O Serviço Local é executado com permissões restritas (não pode acessar a área segura além dos dispositivos definidos)
  • Todas as transferências de dados são registradas no SIEM (Gerenciamento de Informações e Eventos de Segurança)
  • Os templates biométricos nunca são transmitidos (permanecem nos dispositivos da rede segura)
  • Somente dados de ponto não classificados (carimbo de data/hora, número do crachá) cruzam a fronteira da rede
  • Auditorias de segurança mensais dos logs de transferência de dados
  • Senha da conta de serviço trocada trimestralmente

Fluxo de dados com registro de segurança:

8:00:00 AM - Employee badges in at Access Point 1 (fingerprint verification)
8:00:00.5 AM - Device stores transaction on secure network
8:00:15 AM - Service polls device on secure NIC (10.20.30.200)
              [AUDIT LOG: Service accessed device 10.20.30.101]
8:00:15.5 AM - Service receives transaction data
              [AUDIT LOG: Data retrieved: Badge 1234, Time 08:00:00]
8:00:16 AM - Service sanitizes data (removes any potentially sensitive fields)
8:00:16.5 AM - Service sends to cloud via admin NIC (10.50.60.50)
              [AUDIT LOG: Data transmitted to cloud API]
8:00:17 AM - Cloud API receives, triggers webhook
8:00:18 AM - Contractor management system receives attendance
              [AUDIT LOG: Webhook delivery confirmed]

Benefícios obtidos:

  • Conformidade total com os requisitos de SCIF
  • Os dados biométricos permanecem na rede segura isolada
  • Somente o servidor autorizado com dupla conexão faz a ponte entre as redes
  • Trilha de auditoria completa para conformidade de segurança
  • Sistema de controle de acesso integrado ao gerenciamento de terceirizados sem comprometer a postura de segurança

Resposta a incidentes de segurança: se a equipe de segurança detectar uma anomalia:

  1. O serviço pode ser desativado imediatamente pela rede administrativa
  2. Os logs de auditoria são revisados para identificar os dados acessados ou transmitidos
  3. Os dispositivos da área segura continuam operando de forma independente (autenticação local)
  4. A investigação é concluída antes da reativação do serviço

Palavras-chave e Conceitos Otimizados para SEO

Este artigo trata de soluções para:

Integração de dispositivos biométricos: API de sistema de ponto por impressão digital, integração de reconhecimento facial, conectividade de leitor de íris, integração na nuvem de leitor de veia da palma da mão, API biométrica multimodal, integração de sistema de controle de acesso, API de dispositivo de controle de ponto, conectividade em nuvem de dispositivos biométricos, integração de API de máquina de ponto, API de relógio de ponto biométrico

Fabricantes de dispositivos: integração de API ZKTeco, integração na nuvem Suprema BioStar, conectividade de dispositivos Anviz, API de ponto eSSL Matrix, integração Realtime Startek, API de controle de acesso Virdi, API de impressão digital Nitgen, integração Morpho IDEMIA, conectividade de dispositivos Mantra, API Secugen, integração de ponto Hikvision, integração Biomax, integração de hardware biométrico

Desafios de integração: solução para dependência de fornecedor (vendor lock-in), compatibilidade de protocolos proprietários, conectividade em nuvem de dispositivos legados, integração biométrica em redes air-gapped, integração de dispositivos com firewall restritivo, sistema de ponto em rede isolada, interoperabilidade de dispositivos biométricos, integração biométrica multifornecedor

Métodos de implantação: API biométrica em nuvem, integração biométrica on-premises, implantação em nuvem híbrida, edge computing para biometria, conector biométrico de serviço local, integração de ponto em nível de banco de dados, integração biométrica baseada em webhooks, API de ponto em tempo real

Arquiteturas de rede: sistemas biométricos air-gapped, implantação biométrica em DMZ, integração de ponto por VPN, conectividade de dispositivos com restrição de proxy, integração biométrica com NAT e firewall, implantação de servidor com dupla conexão, solução biométrica em rede isolada

Conformidade e segurança: integração biométrica em conformidade com a HIPAA, sistema de ponto PCI-DSS, solução biométrica de soberania de dados, controle de acesso em conformidade com SCIF, integração de ponto com registro de auditoria, arquitetura biométrica zero-trust, transmissão segura de dados biométricos

Aplicações de negócio: integração biométrica com HRMS, conector de ponto para ERP, API biométrica Workday, SAP SuccessFactors para ponto, integração biométrica Oracle HCM, conector de sistema de folha de pagamento, integração de gestão de força de trabalho, integração de API de controle de jornada

Soluções por setor: controle de ponto no chão de fábrica, integração biométrica em redes de varejo, controle de acesso em saúde, biometria para instalações governamentais, controle de ponto em instituições de ensino, gestão de ponto para BPO, integração em armazéns logísticos, controle de jornada em hotelaria

Capacidades técnicas: webhooks de ponto em tempo real, sincronização de templates biométricos, cadastro remoto de usuários, API de configuração de dispositivos, gerenciamento de múltiplos dispositivos, enfileiramento de dados offline, sincronização automática, consulta de dados de ponto

Perguntas Frequentes (FAQ)

P: Como saber se meus dispositivos suportam Native Push ou exigem implantação Hybrid?

R: Para dispositivos fabricados pela Cams Biometrics, o Native Push já vem integrado e pronto para uso. Para dispositivos de terceiros (ZKTeco, Suprema, Anviz etc.), acesse developer.camsbiometrics.com para executar a verificação de compatibilidade. Informe o modelo e o número de série do dispositivo, e o sistema testará os protocolos de comunicação. Se a verificação for bem-sucedida, seu dispositivo suporta Native Push. Se a verificação falhar ou apresentar erros, a implantação Hybrid é necessária.

P: Posso combinar Native Push e implantação Hybrid na mesma organização?

R: Sim. As organizações normalmente usam Native Push para dispositivos modernos compatíveis e implantação Hybrid para dispositivos legados ou incompatíveis. O Biometric Gateway oferece suporte a implantações mistas, entregando os webhooks em formato consistente, independentemente do modo de implantação subjacente. O código de integração do seu HRMS ou ERP não precisa saber qual modo de implantação cada dispositivo utiliza.

P: O que acontece com os dados de ponto se a conectividade com a internet for perdida?

R:

  • Native Push: os dispositivos enfileiram as transações na memória interna (normalmente de 50.000 a 100.000 registros). Quando a internet é restabelecida, os dispositivos enviam automaticamente todos os dados enfileirados para a nuvem.
  • Modo Hybrid: o computador intermediário enfileira as transações localmente. Quando a conexão com a internet do computador é restabelecida, ele envia automaticamente os dados enfileirados para a nuvem. Observação: nos modos Hybrid, o computador deve conseguir alcançar os dispositivos para coletar as transações durante o período offline.

P: Os funcionários podem cadastrar biometrias remotamente, sem ir até o dispositivo?

R:

  • Native Push: Sim. Os templates biométricos podem ser capturados em qualquer local e enviados por API. A nuvem envia os templates aos dispositivos de destino, possibilitando o cadastro remoto.
  • Modo Hybrid: Não. Os funcionários devem comparecer fisicamente ao dispositivo biométrico para cadastrar impressões digitais, rostos ou íris localmente. O sistema pode criar os registros de usuários, mas a captura biométrica deve ocorrer no dispositivo.

P: Por que há um atraso de 30 segundos na implantação Hybrid?

R: A implantação Hybrid utiliza arquitetura de consulta (polling). O computador intermediário ou o serviço verifica os dispositivos a cada 30 segundos, perguntando "há novas transações?". Esse intervalo equilibra desempenho quase em tempo real com eficiência de rede. Consultas mais rápidas (por exemplo, a cada 5 segundos) consomem mais largura de banda e recursos do dispositivo, com benefício mínimo para casos típicos de ponto. O intervalo de 30 segundos pode ser personalizado, caso requisitos específicos o exijam.

P: Qual a diferença entre o Modo A e o Modo C na implantação Hybrid?

R: Ambos se conectam ao hardware do dispositivo, mas diferem nos requisitos de rede:

  • Modo A (Encaminhamento de Porta): exige a configuração do roteador/firewall para encaminhar portas. Usado quando o computador intermediário e os dispositivos estão em segmentos ou sub-redes de rede diferentes.
  • Modo C (Serviço Local): não exige encaminhamento de portas. Usado quando o computador intermediário e os dispositivos estão na mesma rede local ou quando o encaminhamento de portas não é permitido pela política de rede.

Escolha o Modo A quando o encaminhamento de portas estiver disponível e os dispositivos estiverem em redes diferentes. Escolha o Modo C quando tudo estiver na mesma rede local ou quando a política de rede proibir o encaminhamento de portas.

P: Os Modos Hybrid B ou D podem ser usados para gerenciamento de usuários e configuração de dispositivos?

R: Não. Os Modos B e D se integram no nível do banco de dados, oferecendo apenas o fluxo de dados de transações. Eles não podem enviar comandos aos dispositivos nem gerenciar usuários. O cadastro de usuários e a configuração do dispositivo devem ser feitos na interface local do dispositivo ou pelo software do fabricante. Esses modos são adequados quando apenas os dados de transações de ponto são necessários e o controle do dispositivo não é exigido.

P: Qual largura de banda é necessária para a conectividade dos dispositivos biométricos?

R:

  • Native Push: 10-50 Kbps por dispositivo. Uma transação típica de ponto tem de 1 a 2 KB. Mesmo implantações grandes (100 dispositivos) exigem largura de banda mínima (< 5 Mbps no total).
  • Modo Hybrid: a conexão computador-nuvem precisa de 100 Kbps a 1 Mbps, dependendo da quantidade de dispositivos. A largura de banda dispositivo-computador depende do protocolo de comunicação (geralmente mínima).

Conexões de internet comerciais padrão suportam facilmente centenas de dispositivos.

P: Como o sistema trata a sincronização de relógio e os fusos horários?

R:

  • Todas as transações de ponto incluem carimbos de data/hora do horário local do dispositivo
  • A API em nuvem aceita os carimbos de data/hora e os converte para UTC para armazenamento
  • Os webhooks entregues às aplicações parceiras incluem o UTC e o horário local do dispositivo
  • A configuração de fuso horário é gerenciada via API para implantações em múltiplas localidades
  • Recomenda-se sincronização NTP (Network Time Protocol) para a precisão dos dispositivos

P: O que acontece se o computador intermediário falhar na implantação Hybrid?

R:

  • Os dispositivos biométricos continuam operando normalmente, registrando o ponto localmente
  • Os dispositivos armazenam as transações na memória local
  • Quando um novo computador intermediário for implantado (ou o computador com falha for reparado):
    • O computador consulta os dispositivos
    • Os dispositivos fornecem todas as transações armazenadas
    • O computador envia os dados acumulados para a nuvem
    • Nenhuma perda de dados (dentro dos limites de capacidade de armazenamento do dispositivo)

Recomendação: monitore o tempo de atividade do computador intermediário e mantenha backup/redundância para implantações críticas.

P: O mesmo template biométrico pode ser usado em vários dispositivos?

R:

  • Native Push: Sim. Envie o template biométrico uma vez por API, e a nuvem o distribui para todos os dispositivos designados. Cadastro único, autenticação em múltiplos dispositivos.
  • Modo Hybrid: Não há distribuição automática. O funcionário deve se cadastrar em cada dispositivo separadamente, ou a organização deve copiar manualmente os templates entre os dispositivos usando as ferramentas do fabricante.

P: Como a segurança dos dados é tratada durante a transmissão?

R: Todos os modos usam criptografia HTTPS (TLS 1.2+) para a comunicação com a nuvem:

  • Native Push: criptografado do dispositivo para a nuvem
  • Modo Hybrid: criptografado do computador para a nuvem
  • Entrega de webhooks às aplicações parceiras: HTTPS recomendado (configurável)
  • Autenticação da API: assinatura baseada em chave com validação de requisição
  • Templates biométricos: criptografados em repouso nos dispositivos e criptografados em trânsito, se transmitidos

P: Posso acessar dados históricos de ponto?

R:

  • Native Push: Sim. Os registros históricos de ponto podem ser consultados via API com filtros por intervalo de datas, funcionário e dispositivo
  • Modo Hybrid: os dados históricos são acessados somente via webhooks (entrega em tempo real conforme as transações ocorrem). As aplicações parceiras devem armazenar os dados recebidos por webhook para acesso histórico.

P: Quais recursos de monitoramento e diagnóstico de dispositivos estão disponíveis?

R:

  • Native Push: status completo do dispositivo disponível (online/offline, uso de memória, versão do firmware, logs de erro, data/hora da última comunicação, métricas de saúde do dispositivo)
  • Hybrid Modo A/C: status limitado do dispositivo (horário da última consulta, quantidade de transações, estado básico de conectividade)
  • Hybrid Modo B/D: sem diagnóstico de dispositivo (somente integração com banco de dados)

O Native Push oferece recursos abrangentes de monitoramento e solução de problemas remotos.

Suporte Técnico e Assistência na Implementação

Dúvidas sobre arquitetura de implantação, compatibilidade de dispositivos ou planejamento de integração? Publique os detalhes do seu cenário específico nesta thread do fórum:

Inclua na sua pergunta:

  • Fabricante e números de modelo dos dispositivos
  • Topologia de rede atual (acesso à internet, regras de firewall, redes isoladas)
  • Requisitos de integração (tempo real vs. latência de 30 segundos aceitável, necessidade de controle do dispositivo vs. somente fluxo de transações)
  • Restrições de conformidade ou segurança (requisitos air-gapped, soberania de dados etc.)
  • Quantidade de dispositivos e de localidades

A equipe técnica da Cams Biometrics monitora este fórum diariamente e fornece recomendações específicas com base na sua infraestrutura e nos seus requisitos.

Para a verificação de compatibilidade de dispositivos, acesse developer.camsbiometrics.com para testar seus dispositivos.

Para a documentação detalhada da API, acesse documentação da Biometric Web API.


The Biometric Gateway | One API. Any Device. Any Network. Any ERP.

Arquitetura adaptativa. Compatibilidade universal. Zero dependência de fornecedor.

Was this article helpful?