Manual Driver Facial – Senior X

1 INTRODUÇÃO

1.1 Apresentação

O Driver Facial Topdata é um middleware desenvolvido pela Topdata para integrar os dispositivos de controle de acesso Topdata ao sistema de gestão Senior X. Ele atua como 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 reúne as orientações para instalação, configuração, integração e utilização do Driver Facial Topdata. Inclui requisitos de ambiente, parametrização, manutenção e procedimentos de diagnóstico, e é destinado 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 fornece as instruções necessárias para:

  • Instalar o Driver Facial Topdata – Senior X;
  • Configurar o Driver Facial Topdata – Senior X;
  • Operar e monitorar o ambiente do Driver Facial Topdata – Senior X;
  • Diagnosticar e solucionar problemas de comunicação entre o Driver Facial Topdata e o Senior X (Ronda X).

1.3 Conhecimentos necessários

Recomenda-se que o profissional responsável tenha conhecimento sobre:

  • Sistema operacional Windows: instalação de serviços e gerenciamento de permissões de usuários;
  • Redes TCP/IP: configuração de firewall, roteamento, endereçamento IP e uso de proxy corporativo;
  • Plataforma Senior X: cadastro de dispositivos e configuração de propriedades extensíveis.

1.4 Características

Principais características do Driver Facial Topdata – Senior X:

  • Suporte a múltiplas tecnologias de leitura: compatível com leitores de proximidade, código de barras e SmartCard. Os crachás devem ter no máximo 12 dígitos para que a comunicação entre o crachá e o leitor facial ocorra corretamente.
  • Integração com o Senior X: sincronização de usuários e credenciais, com suporte a comandos como ajuste de data e hora, envio de listas de usuários e consulta de status dos dispositivos.
  • Cadastro de usuários com credencial e biometria facial: envio dos dados de crachá e da biometria facial para o leitor.
  • Validação de acesso online: disponível quando o leitor é configurado para operar com catraca Easy.
  • Atualização de credenciais: permite alterar e reatribuir crachás, além de atualizar fotos e demais informações do usuário.
  • Interpretação de respostas: os comandos retornam respostas detalhadas, indicando sucesso, erro de processamento ou pendência.

2 REQUISITOS DO SISTEMA

2.1 Permissões

A conta utilizada para instalar e executar o serviço do driver deve ter permissão de administrador local do Windows.

2.2 Firewall e portas de comunicação

ServiçoPortaProtocoloDescrição
API do Senior X443HTTPSComunicação REST com os serviços Senior
WebSocket de notificações443WSSRecebimento de pendências do Senior X
WebSocket do leitor facial7792 (ou a definida na configuração)WSSComunicação com os leitores faciais Topdata
Catraca Topdata3570 (ou a definida no Driver Acesso)TCP/IPComunicação com as catracas Topdata

Libere essas portas no firewall nos dois sentidos (entrada e saída).

2.3 Endereços e domínios utilizados

ServiçoEndereço
API do Senior Xhttps://sam-api.senior.com.br/sdk/v1/
WebSocket de notificaçõeswss://sam-api.senior.com.br/websocket/pendency

Para validar a conectividade, execute no Prompt de Comando:

curl.exe -I https://sam-api.senior.com.br/sdk/v1/

O retorno esperado é HTTP 404. Esse código confirma que o servidor da Senior foi alcançado; a URL base da API não tem conteúdo próprio, por isso responde 404. Se o comando apresentar erro de tempo esgotado, de conexão recusada ou de resolução de nome, verifique firewall, proxy e DNS.

Use curl.exe, e não apenas curl: no Windows PowerShell, curl é um alias de outro comando e não aceita o parâmetro -I.

2.4 Sistemas operacionais suportados

  • Windows 10 (64 bits)
  • Windows 11 (64 bits)
  • Windows Server (versões compatíveis com o .NET Desktop Runtime 8.0.8)

Todos os sistemas devem estar atualizados com os pacotes de correção e de segurança mais recentes.

2.5 Dependências

  • .NET Desktop Runtime 8.0.8 (x86) ou superior.

O .NET Desktop Runtime é necessário para executar o serviço do driver e deve ser instalado antes da configuração do sistema.

2.6 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 livres para a instalação e o armazenamento dos logs.

Esses requisitos garantem o desempenho mínimo para a execução do driver e sua integração com o Senior X.


3 CONFIGURAÇÃO DOS LEITORES FACIAIS NO SENIOR X

Antes de instalar o Driver Facial Topdata, é necessário cadastrar no Senior X:

  1. o driver que será usado pelos leitores faciais Topdata. Esse cadastro gera uma chave (Driver Key), que será informada durante a instalação;
  2. um dispositivo para cada leitor facial, vinculado a esse driver.

3.1 Modos de operação

O Driver Facial pode operar de duas formas:

  • Modo Easy: o próprio leitor facial valida o acesso e aciona 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 um segundo driver para validar o acesso:
    • Driver Acesso Topdata, para equipamentos de controle de acesso;
    • Driver REP Topdata, para relógios de ponto (REP).

3.2 Gerar a Driver Key

  1. No Senior X, acesse Gestão de Riscos e Segurança → Ronda X → Controle de Acesso.
  2. Adicione um novo driver e, no campo Fabricante, selecione Driver SDK.
  3. Clique em Salvar. A chave será exibida automaticamente em um campo, conforme a figura abaixo.

Copie essa chave; ela será usada no passo de configuração da instalação (seção 4).

3.3 Cadastro do dispositivo

Cadastre um dispositivo para cada leitor facial, vinculado ao driver exclusivo criado na seção 3.2.

CampoValor
NomeNome do dispositivo, usado para identificá-lo e organizar o ambiente no Senior X
Identificação da redeEndereço IP do leitor facial
DriverDriver exclusivo dos leitores faciais
Tipo gerenciadorControle de Acesso
Propriedades extensíveisConforme a seção 3.4
Leitor biométrico facial1 leitor biométrico facial
Leitor de cartão1 leitor de cartão de proximidade (quando necessário para enviar a credencial corretamente)

Modelos suportados:

  • Facial T4
  • Facial F4
  • Facial T4 50K

3.4 Propriedades extensíveis

3.4.1 Operação em modo Easy

Para que o leitor valide o acesso (catraca Easy ou porta Easy), cadastre:

IdentificadorValor
Tipo7

Para controlador de porta, defina também o tempo de acionamento:

IdentificadorValor
TEMPO_PORTATempo, em segundos

3.4.2 Formato do cartão quando integrado a outros dispositivos

Estas propriedades só estão disponíveis quando o leitor facial comunica diretamente com o driver ou está ligado a dispositivos Controle Catraca ou Inner Acesso II.

Leitor Abatrack — no Driver REP ou no Driver Acesso, o formato do cartão também deve ser Abatrack (geralmente TopProx):

IdentificadorValor
FORMATO_WIEGAND2
SAIDA_WIEGAND0

Leitor Wiegand (com Facility Code) — os equipamentos da linha Inner Acesso, já descontinuada, funcionam somente com esta configuração:

IdentificadorValor
FORMATO_WIEGAND0
SAIDA_WIEGAND1

3.5 Direção do dispositivo

Quando a validação de acesso é feita pelo leitor facial, ele deve estar configurado corretamente no Senior X como entrada ou saída. Como o equipamento não informa o sentido do giro, a resposta de acesso é registrada de acordo com a direção definida no cadastro do dispositivo no Senior X.

Nesta versão, isso se aplica a dois tipos de equipamento:

  • Catraca Easy;
  • Catraca Topdata com leitores faciais.

4 INSTALAÇÃO DO DRIVER FACIAL

A instalação inclui a instalação do serviço no Windows e a configuração inicial feita no DriverFaceConfig.

  1. Faça o download do Driver Facial Topdata – Senior X.
  2. Execute o instalador: localize o arquivo de instalação, clique duas vezes nele e, se solicitado, conceda privilégios de administrador.
  3. Verificação de pré-requisitos: o instalador verifica automaticamente se o .NET Desktop Runtime 8.0.8 (x86) ou superior está instalado. Caso não esteja, será exibida a mensagem: “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?” Ao confirmar, você será redirecionado para a página de download. Baixe e instale o .NET Desktop Runtime 8.0.8 na versão x86; a versão de 64 bits não é compatível. NOTA: instale o Desktop Runtime. As opções .NET Runtime e ASP.NET Core Runtime não funcionam. O SDK também funciona, mas não é recomendado, pois contém componentes desnecessários para o driver.
  4. Inicie a instalação: na tela inicial do instalador, clique em Avançar.
  5. Selecione o local de instalação: escolha o diretório de instalação. Recomenda-se manter o caminho padrão.
  6. Configure o driver (DriverFaceConfig): informe os dados de comunicação com o Senior X, descritos na seção 5. Os dados são gravados no Registro do Windows (seção 6).
  7. Conclua a instalação: o instalador copia os arquivos e registra o serviço no Windows. Clique em Fechar para finalizar.

5 CONFIGURAÇÃO DO DRIVER FACIAL

O DriverFaceConfig é o utilitário de configuração que acompanha o Driver Facial. Ele é aberto automaticamente durante a instalação e pode ser executado novamente a qualquer momento em:

C:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\Servico\Configuracao\DriverFaceConfig.exe

5.1 Comunicação com os leitores faciais

CampoDescrição
Porta Leitor(es) Facial(is)Porta usada na comunicação com os leitores faciais. Padrão: 7792.

5.2 Dados do Senior Ronda X

CampoDescrição
Código do Driver na Senior (Driver Key)Chave gerada no cadastro do driver no Senior X (seção 3.2). Identifica o driver na plataforma.
Chave de integração do parceiroChave que identifica a Topdata como parceira na integração. Já vem preenchida e só deve ser alterada mediante solicitação da Senior.
Endereço do banco de dados Senior (URL)Endereço da API do Senior X, por meio da qual o driver consulta e envia dados. Padrão: https://sam-api.senior.com.br/sdk/v1/
Endereço do WebSocket de comunicação da SeniorCanal WebSocket usado para receber as pendências do Senior X em tempo real. Padrão: wss://sam-api.senior.com.br/websocket/pendency

Botões:

  • Cancelar: fecha a tela sem salvar as alterações.
  • Salvar: grava os dados para uso na comunicação com o Senior X.

6 REGISTRO DO WINDOWS

Durante a instalação, o Driver Facial grava suas configurações no Registro do Windows, na chave:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Topdata\DriverFacialSeniorX

Para consultar:

  1. Pressione Windows + R, digite regedit e pressione Enter.
  2. Navegue até a chave acima.
  3. Verifique se os valores foram gravados corretamente.
ValorTipoPadrãoDescrição
CaminhoInstalacaoREG_SZC:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\...Diretório de instalação do driver.
DriverKeyREG_SZ—Driver Key gerada no Senior X (campo Código do Driver na Senior).
LogCaminhoREG_SZC:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\...Pasta onde os logs são gravados (seção 8).
LogMesesApagarREG_DWORD3Quantidade de meses que os logs são mantidos antes de serem apagados.
PartnerKeyREG_SZ—Chave de integração do parceiro.
PortaLeitorREG_DWORD7792Porta de comunicação com os leitores faciais.
ProjetoREG_DWORD1Parâmetro interno do driver. Não alterar.
TempoComunicacaoInicialREG_DWORD1000Parâmetro interno de temporização da comunicação. Não alterar.
UrlDBSeniorREG_SZhttps://sam-api.senior.com.br/sdk/v1/Endereço da API do Senior X.
UrlWebSocketREG_SZwss://sam-api.senior.com.br/websocket/pendencyEndereço do WebSocket de pendências do Senior X.

ATENÇÃO: essas informações são essenciais para a comunicação entre o driver, os leitores faciais e o Senior X. Alterar essas chaves manualmente sem o conhecimento adequado pode comprometer o funcionamento do driver. Para alterar a configuração, prefira o DriverFaceConfig (seção 5).


7 GERENCIAMENTO DO SERVIÇO

O Driver Facial é instalado como um serviço do Windows e é executado automaticamente em segundo plano. O gerenciamento é feito pelo console de Serviços:

  1. Pressione Windows + R.
  2. Digite services.msc e pressione Enter.

7.1 Iniciar o serviço

Se o serviço não estiver em execução ou tiver sido parado manualmente:

  1. Localize o serviço DriverFacialTopdata_RondaSeniorXT.
  2. Clique com o botão direito sobre ele e selecione Iniciar.
  3. O status mudará para Em execução.

7.2 Parar o serviço

Para manutenção ou diagnóstico:

  1. Localize o serviço DriverFacialTopdata_RondaSeniorXT.
  2. Clique com o botão direito sobre ele e selecione Parar.

OBSERVAÇÃO: parar o serviço interrompe a comunicação com o Senior X e com os leitores faciais. Certifique-se de que não há operações críticas em andamento.

7.3 Desinstalar o driver

O Driver Facial é removido como qualquer outro programa do Windows:

  1. Acesse Configurações → Aplicativos → Aplicativos instalados (ou Painel de Controle → Programas e Recursos).
  2. Localize Driver Facial Topdata – Senior X.
  3. Clique em Desinstalar e siga as instruções.

8 ANÁLISE DOS LOGS

Os logs ficam na pasta Servico\Logs do diretório de instalação, em uma subpasta por dia, no formato AAAAMMDD. Exemplo:

C:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\Servico\Logs\20250814
ArquivoConteúdo
AYSD07033777_1Comunicação com o leitor facial. O nome corresponde ao número de série do leitor.
CommunicationSeniorRegistro bruto da comunicação com o Senior X: os comandos recebidos e enviados exatamente como trafegaram. Indicado para análise técnica detalhada.
Info - [AYSD07033777]Descrição legível das etapas de processamento de cada leitor facial (identificado pelo número de série).
InfoDescrição legível do que está acontecendo na comunicação entre o driver e o Senior X — uma “tradução” do conteúdo do CommunicationSenior. Indicado como ponto de partida no diagnóstico.

Os logs são mantidos por 3 meses por padrão; após esse período, são apagados automaticamente. O prazo é definido pelo valor LogMesesApagar no Registro do Windows (seção 6).


9 CADASTRO DE BIOMETRIAS FACIAIS NO EQUIPAMENTO

9.1 Pré-requisitos

A pessoa precisa ter uma credencial (crachá) cadastrada; o equipamento não aceita pessoas sem credencial. Ao cadastrar uma pessoa com permissão de acesso, o driver envia os dados diretamente ao equipamento, desde que ele esteja cadastrado e online.

9.2 Envio de carga para o equipamento

ATENÇÃO: antes de receber a carga, o equipamento remove todas as biometrias faciais nele cadastradas.

Para que o leitor facial libere o acesso por crachá, é preciso enviar antes a lista de liberação ao equipamento. O driver armazena essa lista em sua base interna e só a envia ao dispositivo depois de concluir o carregamento das biometrias faciais.

Se a capacidade máxima do leitor for excedida, a prioridade de armazenamento é sempre da credencial facial.


10 PARTICULARIDADES DO LEITOR

10.1 Credenciais de crachá

O leitor facial aceita apenas uma credencial de crachá por usuário. Se a pessoa tiver duas ou mais credenciais, o acesso será feito com a primeira cadastrada.

10.2 Emergência

O leitor facial responde ao comando de emergência, mas libera o acesso apenas uma vez: por configuração interna do equipamento, o relé não permanece acionado.

10.3 Acesso negado

Quando a face da pessoa não está cadastrada, o leitor não exibe a mensagem “Acesso negado”. Como o equipamento não reconhece a pessoa, ele não consegue associar um código a ela e, portanto, não tem como informar que a credencial é inválida.

10.4 Usuário administrador do leitor

Para restringir o acesso ao menu do leitor facial a administradores, cadastre um usuário e uma senha no cadastro do dispositivo no Senior X. Com essa configuração, somente quem souber a senha poderá acessar o menu do equipamento.

  • Código do usuário administrador: sempre 99999999. Ele deve ser o primeiro usuário registrado no equipamento.
  • Senha: somente números, de 1 a 8 dígitos.

O cadastro do administrador não apaga os usuários nem altera as informações já armazenadas no equipamento.

Esse artigo foi útil?

Artigos relacionados