1.1 INTRODUÇÃO
O Driver Facial Topdata é um middleware desenvolvido pela Topdata para viabilizar a integração entre os dispositivos de controle de acesso da Topdata e o sistema de gestão Senior X. Sua função é atuar como um canal de comunicação bidirecional entre os equipamentos e a plataforma Senior, garantindo a troca organizada e segura de dados operacionais, registros de acesso e comandos administrativos.
Este manual apresenta as orientações necessárias para a instalação, configuração, integração e utilização do Driver Facial Topdata. Contém instruções sobre requisitos de ambiente, parametrização, manutenção e procedimentos de diagnóstico, sendo direcionado a profissionais de TI, técnicos de integração e equipes responsáveis pela operação do sistema integrado.
1.2 OBJETIVO DO MANUAL
Este manual tem como objetivo fornecer instruções necessárias para a:
- Instalação do Driver Facial Topdata – Senior X.
- Configuração do Driver Facial Topdata – Senior X.
- Operação e monitoramento do Ambiente do Driver Facial Topdata – Senior X.
- Diagnóstico e solução de problemas entre o Driver Facial Topdata – Senior X e o Sistema Ronda Senior X.
1.3 CONHECIMENTOS MÍNIMOS NECESSÁRIOS.
Para a correta utilização do manual, é recomendado um profissional com conhecimento sobre.
- Sistema operacional Windows: Instalação de serviços, gerenciamento de permissões de usuários.
- Redes TCP/IP: configuração de firewall, roteamento, endereçamento IP e uso de proxy corporativo.
- Infraestrutura Senior: Noções sobre o cadastro dos dispositivos, configurações de propriedades extensíveis.
1.4 Características
A seguir, as principais características do Driver Facial Topdata – Senior X:
Suporte a múltiplas tecnologias de leitura:
- Compatível com leitores de proximidade, barras e SmartCards.
- Requer o uso de crachás com no máximo 12 dígitos para correta comunicação entre o crachá e o leitor facial.
Integração com Senior X:
- Sincronização com o sistema Senior X para gerenciamento de usuários e credenciais.
- Comandos como configuração de data/hora, envio de listas de usuários, e status de dispositivos são suportados.
Cadastro de usuários com credenciais e biometria facial:
- Permite o envio de dados de crachá e biometria facial para o leitor.
Validação de acesso:
- Permite validação de acesso Online quando configurado como catraca Easy.
Suporte a atualizações de credenciais:
- Permite a alteração e retribuição de crachás, bem como a atualização de fotos e outras informações do usuário.
Interpretação de respostas:
- Respostas detalhadas dos comandos para identificar sucesso, erro de processamento ou pendências.
2 Requisitos do Sistema
A conta utilizada para instalar e executar o serviço do driver deve ter permissões de administrador do banco de dados.
2.1 CONFIGURAÇÃO DE FIREWALL E PORTAS DE COMUNICAÇÃO.
| Serviço | Porta | Protocolo | Descrição |
|---|---|---|---|
| API do Senior | 443 | HTTPS | Comunicação Rest com os serviços Senior |
| Websocket notificações | 443 | WSS | Recebimento de pendências da Senior |
| WebSocket Leitor Facial | 7792 ou definida na configuração | WSS | Comunicação com leitores Faciais Topdata. |
| Catraca Topdata | 3570 ou Definida no Driver Acesso | TCP/IP | Porta de comunicação com catracas Topdata. |
2.2 ENDEREÇOS E DOMINIOS UTILIZADOS.
| Serviço | Endereço/Domínio |
|---|---|
| API do Senior X | https://sam-api.senior.com.br/sdk/v1/ |
| WebSocket de Notificações | wss://sam-api.senior.com.br/websocket/pendency |
Valide a conectividade no prompt de comando, executando:
Curl –I https://sam-api.senior.com.br/sdk/v1/
O retorno deve ser HTTP/200
2.3 SISTEMAS OPERACIONAIS SUPORTADOS
- Windows 10 (versões de 64 bits)
- Windows 11 (versões de 64 bits)
- Windows Server
Ambos os sistemas operacionais devem estar atualizados com os últimos pacotes de correção e atualizações de segurança.
2.4 DEPENDÊNCIAS:
- .NET Desktop Runtime: Versão 8.0.8 (x86) ou superior.
- O .NET Desktop Runtime é necessário para a execução do serviço driver e deve estar devidamente instalado antes da configuração do sistema.
2.5 REQUISITOS MÍNIMOS DE HARDWARE
- Processador: Dual-core de 1.6 GHz ou superior.
- Memória RAM: 8 GB ou mais.
- Espaço em Disco: Pelo menos 5 GB de espaço livre no disco para instalação e
armazenamento de logs de operação.
Esses requisitos garantem a performance mínima para a execução do driver e sua integração com o
Senior X, permitindo o gerenciamento de acessos e usuários de forma eficiente.
3 CONFIGURAÇÃO DE LEITORES FACIAIS NA SENIOR X
Antes de instalar o Driver Facial Topdata, é necessário cadastrar o leitor facial no sistema Senior X.
O primeiro passo é cadastrar o driver que será utilizado pelos dispositivos faciais da Topdata.
Durante esse processo, será gerada uma chave (key), que deverá ser informada posteriormente nas configurações do Driver Facial Topdata.
Com o driver já definido no Senior X, cadastre o dispositivo correspondente ao leitor facial.
O Driver Facial pode operar de duas maneiras:
- Modo Easy – o próprio equipamento facial realiza a validação do acesso, acionando
um relé para abrir uma porta ou liberar uma catraca Easy Topdata. Em ambos os casos, não há controle do giro da catraca, apenas a liberação do acesso. - Modo de manutenção de dados – o driver atua apenas como mantenedor de fotos e
credenciais. Nesse cenário, é necessário utilizar um segundo driver para realizar a
validação de acesso:
- Driver Acesso Topdata – para equipamentos de controle de acesso.
- Driver REP Topdata – para validação em relógios de ponto (REPs).
3.1 DRIVER EXCLUSIVO PARA LEITORES FACIAIS.
Para representar os leitores faciais é necessário cadastrar um Driver exclusivo para eles, e um dispositivo para cada leitor facial.
Parâmetros essenciais para cada dispositivo:
| Campo | Descrição |
|---|---|
| Nome | Endereço do dispositivo no Senior X |
| Identificação da rede | Endereço IP do leitor facial. |
| Driver | Definir um Driver Exclusivo para os leitores faciais |
| Tipo Gerenciador | Controle de Acesso |
| Propriedades Extensíveis | Conforme a seção 3.2 |
| Leitor Biométrico Facial | 1 Leitor Biométrico Facial |
| Leitor de Cartão | 1 Leitor de Cartão Proximidade (Se necessário para enviar a credencial corretamente). |
Modelos Suportados:
- Facial T4
- Facial F4
- Facial T4 50K
3.2 CONFIGURAÇÃO DAS PROPRIEDADES EXTENSÍVEIS.
Para o funcionamento Easy, onde o leitor valida o acesso.
Propriedade para catraca Easy ou porta Easy:
| Identificador | Valor |
| Tipo | 7 |
Quando integrado a outros dispositivos é importante a configuração conforme segue:
Somente disponível para leitor facial comunicando diretamente, ou dispositivos Controle
Catraca ou Inner Acesso II. No Driver Rep ou Driver Acesso o formato do cartão deverá ser abatrack também (Geralmente TopProx).
Utilizar leitor Abatrack:
| Identificador | Valor |
|---|---|
| FORMATO_WIEGAND | 2 |
| SAIDA_WIEGAND | 0 |
Para cartão Wiegand Facility Code é necessário inserir as seguintes propriedades extensíveis.
Equipamentos da descontinuada Linha Inner Acesso funcionaram somente com esta configuração.
Utilizar leitor Wiegand:
| Identificador | Valor |
|---|---|
| FORMATO_WIEGAND | 0 |
| SAIDA_WIEGAND | 1 |
3.3 AJUSTE DA DIREÇÃO DO DISPOSITIVO.
Na validação de acesso realizada pelo leitor facial, é fundamental que, no Senior X, o leitor esteja corretamente configurado como entrada ou saída. Como o equipamento não envia informações sobre o sentido do giro, a resposta de acesso será transmitida de acordo com a configuração definida no próprio dispositivo. Nesta versão teremos dois tipos de equipamentos.
- Catraca Easy.
- Catraca Topdata com Leitores Faciais.
4 INSTALAÇÃO DO DRIVER FACIAL
A instalação do Driver Facial envolve etapas essenciais para a correta configuração do sistema, que incluem a instalação do serviço no Windows e os ajustes iniciais realizados por meio da Configuração do Driver Passo a Passo da Instalação.
1. Faça o Download do Driver Facial Topdata – Senior X.
2. Executar o Instalador:
3. Localize o arquivo de instalação e clique duas vezes para executá-lo, e, se solicitado,
conceda privilégios administrativos.
4. Verificar Pré-requisitos:
- No início a instalação, o instalador verificará automaticamente se o .NET Desktop Runtime (versão 8.0.8 ou superior) está instalado. Caso contrário, uma mensagem será exibida: “Esta instalação requer o x86 Runtime do .NET versão 8.0.0. Instale o Runtime do .NET e execute a instalação novamente. O Runtime do .NET pode ser obtido na Web. Deseja fazer isso agora?”
- Se você confirmar, será redirecionado para a página de downloads do componente. É importante baixar e instalar o “.NET Desktop Runtime 8.0.8” na versão x86, pois a versão de 64 bits não é compatível.
Nota
Certifique-se de instalar a versão Desktop Runtime; versões como Core Runtime ou Runtime não funcionarão. Embora a versão SDK possa ser instalada, ela não é recomendada, pois contém componentes adicionais desnecessários para o funcionamento do Driver Facial Topdata – Senior X.
5. Iniciar o Processo de Instalação:
- Na tela inicial do instalador, clique em Avançar para iniciar o processo.
6. Selecionar o Local de Instalação:
- Escolha o diretório onde o Driver Facial será instalado. O caminho padrão é o recomendado.
7. Configuração com o DriverFaceConfig:
Neste momento serão configurados todos os dados necessário para a comunicação com o Senior-X.
- “Driver Key”: A chave gerada no cadastro do driver no sistema Senior X.
- Chave de integração do parceiro: Informações de autenticação para comunicação com a Senior X, o Driver leva esta informação como padrão. Podendo ser alterada somente com solicitação da Senior.
- Host – Senior (URL): Endereço da API Senior para comunicação com o driver.
- Websocket (Pendencias Senior): Endereço Websocket para recebimento de pendencias da sênior.
Caso precise acessar novamente este item você poderá entrar no diretório de instalação do Driver, por exemplo: C:\Program Files (x86)\Topdata\Driver Facial Topdata – Senior X\Servico\Configuracao\DriverFaceConfig.exe.
Após a configuração, os dados serão salvos diretamente nos registros do Windows.
8. Finalizar a Instalação:
9. Após preencher as configurações iniciais na Configuração do Driver, o instalador continuará copiando os arquivos e configurando o serviço no sistema.
10. Clique em Fechar para finalizar o processo de instalação.
5. LOCALIZAÇÃO DOS REGISTROS NO WINDOWS
Durante a instalação, o Driver Facial Topdata armazena informações importantes de configuração nos registros do Windows. Essas informações são usadas pelo sistema para garantir que as configurações sejam preservadas e que o software funcione corretamente.
Localização dos Registros
Os dados de configuração do Driver Facial Topdata podem ser encontrados na seguinte chave de registro:
Computador\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Topdata\DriverFacialSeniorX
Como Acessar os Registros
- Pressione Windows + R, digite “regedit” e pressione “Enter” para abrir o “Editor de Registro”.
- Navegue até o caminho:
- HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Topdata\DriverFacialSeniorX
- Verifique as chaves e valores armazenados para assegurar que os dados do Driver Facial foram corretamente registrados.
Importância dos Registros
Essas informações nos registros são essenciais para garantir a comunicação correta entre o Driver Facial Topdata, os dispositivos faciais e o sistema Senior X. Alterar manualmente essas chaves sem o conhecimento adequado pode causar problemas de funcionamento.
O Driver Facial é instalado como um serviço do Windows, o que permite que seu gerenciamento seja feito diretamente pelo sistema operacional. Essa abordagem facilita o controle de execução e garante que ele opere automaticamente em segundo plano.
A seguir, apresentamos as instruções para iniciar, parar e desinstalar o serviço Driver Facial por meio do utilitário services.msc.
Acessando o Gerenciador de Serviços (services.msc)
Para gerenciar o serviço Driver Facial, siga os passos abaixo:
1. Pressione Windows + R para abrir a janela Executar.
2. Digite “services.msc” e pressione Enter.
3. O Gerenciador de Serviços do Windows será aberto, exibindo uma lista de todos os serviços instalados no sistema.
5.1 INICIAR O SERVIÇO DRIVER FACIAL
Se o serviço Driver Facial não estiver em execução ou foi parado manualmente, siga os passos para iniciá-lo
1. No services.msc, role a lista até encontrar o serviço chamado Driver Facial.
2. Clique com o botão direito sobre o nome do serviço.3.
3. Selecione a opção iniciar.
4. O status do serviço mudará para Em Execução (Running), indicando que o Driver Facial está funcionando corretamente.
5.2 PARAR O SERVIÇO DRIVER FACIAL
Em caso de necessidade de manutenção ou resolução de problemas, pode ser necessário parar o serviço Driver Facial temporariamente:
1. No services.msc, localize o Driver Facial.
2. Clique com o botão direito sobre o serviço.
3. Selecione a opção Parar.
OBSERVAÇÃO
Parar o serviço interromperá a comunicação com o sistema Senior X e os dispositivos faciais conectados. Certifique-se de que não há operações críticas em andamento antes de parar o serviço.
6 CONFIGURAÇÃO DO DRIVER FACIAL
A configuração do Driver Facial é essencial para garantir a correta integração com a plataforma de controle de acesso desejada. A ferramenta responsável por essas configurações iniciais é a configuração do driver, um software embutido no Driver Facial, que permite selecionar qual programa o leitor facial irá se integrar, ajustando parâmetros de comunicação e funcionamento.
6.1 CONFIGURAÇÃO DO DRIVER
6.1.1.1 INTEGRAÇÃO SENIOR X
- Porta Leitor(es) Facial(s): Define a porta de comunicação que será utilizada para se conectar aos leitores faciais. No exemplo da imagem, está configurada como 7792.
6.1.1.2 DADOS SENIOR RONDA X
Área destinada à configuração dos dados de integração com o Senior Ronda X:
- Código do Driver na Senior: Token (ou chave) de autenticação do driver cadastrado na Senior. É um valor criptografado que identifica o driver no sistema Senior.
- Chave de integração do parceiro: Outro token de autenticação, usado para identificar a parceria entre sistemas e garantir a comunicação segura.
- Endereço do banco de dados Senior (URL): URL para acesso à API da Senior, onde o sistema consulta dados e realiza integrações. Exemplo da imagem: https://sam-api.senior.com.br/sdk/v1/
- Endereço do WebSocket de comunicação da Senior: URL do canal WebSocket usado para comunicação em tempo real com a Senior, possibilitando envio e recebimento instantâneo de mensagens. Exemplo da imagem: wss://sam-api.senior.com.br/websocket/pendency
BOTÕES:
· CANCELAR: Fecha a tela sem salvar as informações.
· SALVAR: Armazena os dados informados para uso posterior na comunicação com o Senior X.
7 ANALISE DOS LOGS DO DRIVER FACIAL.
Os logs do Driver sempre ficam em um local dentro do diretório padrão de instalação do Driver, nele você consegue analisar todos os pontos do Driver.
O Driver ficará geralmente na pasta de instalação do Driver, acrescentado da data atual no formato ano, mês , dia.
C:\Program Files (x86)\Topdata\Driver Facial Topdata – Senior X\Servico\Logs\20250814
Os arquivos contidos nestes logs representam:
- AYSD07033777_1 -> Número de série do Leitor Facial este log representa toda a comunicação com o leitor.
- CommunicationSenior -> Este log exibe todos os endpoints recebidos e enviados na comunicação com a Senior.
- Info – [AYSD07033777] -> Este log exibe todos os passos de cada leitor Fa-cial.
- Info – Todas as informações de comunicação entre Driver e Senior X.
8 CADASTRO DE BIOMETRIAS FACIAIS NO EQUIPAMENTO.
8.1. PRÉ REQUISITOS PARA CADASTRO.
Para que a biometria seja cadastrada no equipamento é necessário que a pessoa tenha credencial cadastrada. Pessoas sem Credenciais não são aceitas no equipamento. Ao cadastrar uma pessoa com permissão o Driver irá cadastrar os dados diretamente no equipamento, se este estiver cadastrado e On-line.
8.2 – ENVIO DE CARGA PARA O EQUIPAMENTO.
Se for necessário que o Driver realize a liberação de crachás cadastrados no leitor facial, é imprescindível enviar previamente a lista de liberação para o equipamento. Após o envio dessa lista, o Driver armazenará as informações em sua base interna. Somente depois de concluir o carregamento da lista de biometrias faciais é que os dados da lista de liberação serão enviados ao dispositivo.
Caso a capacidade máxima do leitor seja excedida, a prioridade de armazenamento será sempre para a credencial facial.
Antes de receber a carga o equipamento remove todas as biometrias faciais cadastradas no mesmo.
9 PARTICULARIDADES DO LEITOR.
9.1 CREDENCIAIS DE CRACHÁ.
O Leitor Facial permite apenas uma credencial de Crachá para cada usuário, sendo assim, pessoas com suas credenciais o acesso será realizado com a primeira credencial cadastrada.
9.2 EMERGÊNCIA.
O leitor facial responde ao comando de emergência, mas libera o acesso somente uma vez, não ficando com o relé acionado a todo tempo devido a configurações internas.
9.3 ACESSO NEGADO.
Quando uma credencial facial não está cadastrada, o leitor não exibe a mensagem de “acesso negado”. Isso acontece porque, ao não reconhecer a pessoa, o equipamento não consegue gerar um código associado a ela. Sem esse código, o dispositivo fica impossibilitado de re-tornar ao usuário a informação de que foi identificada uma credencial inválida.
9.4 USUÁRIO ADMINISTRADOR DO LEITOR.
Se o cliente desejar que o acesso ao menu do leitor facial seja restrito apenas a administradores, é necessário configurar um nome de usuário e senha no cadastro do dispositivo. Com essa configuração, somente quem possuir a senha cadastrada poderá acessar o menu do equipamento. A senha deve conter apenas números, com tamanho entre 1 e 8 dígitos.
No cadastro do dispositivo é possível inserir um usuário e senha específicos. O código do usuário será sempre “99999999”, devendo ser o primeiro número registrado no equipamento.
