Solavel Documentos
Português

Instalar o conector do Device Connect

Última atualização

O conector é o pequeno programa para Windows que lê os seus terminais de ponto e envia as marcações ao SolaHR. Esta página mostra como baixar, instalar, emparelhar, atualizar e remover, e o que verificar quando algo não funciona. Se quiser entender a ideia primeiro, leia a visão geral.

Pré-visualização. O conector foi construído e verificado com simuladores e um modelo de terminal real. Ele ainda não tem assinatura de código, então o Windows vai avisar ao executá-lo. Experimente primeiro em um PC e um dispositivo.

#Antes de começar

Necessário Detalhe
Um PC ou servidor Windows Windows 10 ou 11, ou Windows Server 2016 e posteriores, 64 bits. Windows 7/8, Windows 32 bits e ARM não são compatíveis.
Sempre ligado O PC deve ficar ligado e ativo, na mesma rede (e VLAN) dos terminais. Um PC de escritório pequeno ou um servidor serve.
Direitos de administrador Para instalar e, depois, para registrar um SDK de fabricante.
Internet HTTPS de saída para o endereço do seu SolaHR (por exemplo https://solavel.com/hr). Nenhuma porta de entrada é necessária.
Um usuário do SolaHR autorizado a gerenciar dispositivos O proprietário ou um gerente de RH.
O endereço IP do terminal E a chave de comunicação, se houver. Veja Adicionar um dispositivo.

Não é preciso hardware especial; um PC de escritório comum basta (ainda não publicamos mínimos medidos).

#Escolher um pacote

No SolaHR, abra Tempo e presença → Dispositivos de ponto → Conectores → Adicionar conector. São oferecidos dois downloads para Windows 10 / 11 · 64 bits, cada um com versão e tamanho.

Pacote O que é Use quando
Instalador do Windows .exe (recomendado) Instala o conector como um serviço do Windows: inicia sozinho na inicialização, reinicia após uma falha e mantém seus dados nas atualizações. Uso normal.
ZIP portátil Sem instalador. Extraia e execute install.cmd, que registra uma tarefa agendada que inicia o conector na inicialização. Não é um serviço do Windows. Um teste rápido, ou um PC onde não se pode executar um instalador.

Ambos estão marcados como Pré-visualização. Se a página disser «O instalador do Windows estará disponível aqui em breve.», nenhum pacote foi publicado ainda.

Confira o download. Em Detalhes estão as notas da versão e um comando do PowerShell. Execute e compare: o resultado de Get-FileHash deve ser igual ao valor SHA-256 exibido na página.

#Instalar e emparelhar, passo a passo

  1. Execute o instalador como administrador (clique com o botão direito, Executar como administrador). Para o ZIP: botão direito no ZIP, Extrair tudo, clique duas vezes em install.cmd e responda Sim.
  2. SmartScreen. Como a pré-visualização não é assinada, o Windows pode mostrar «O Windows protegeu o computador». Depois de conferir o SHA-256, clique em Mais informações e depois em Executar assim mesmo. O aviso some quando o programa for assinado; até lá é esperado e não indica problema.
  3. A página do conector abre no navegador em http://127.0.0.1:8790. Essa página só está disponível naquele PC. O menu Iniciar também tem SolaHR Device Connect.
  4. Gere um código de emparelhamento. No SolaHR, clique em Adicionar conector e copie o Código de emparelhamento. Ele vale uma vez e expira em 15 minutos; gere outro se expirar.
  5. Emparelhe. Na página do conector, digite o endereço do seu SolaHR (por exemplo https://solavel.com/hr) e o código, e pressione Pair.
  6. No SolaHR o conector aparece como Online em até um minuto. Agora adicione um dispositivo e atribua-o a este conector.

Para equipes de TI, o instalador também roda em modo silencioso, opcionalmente com o endereço e o código:

SolaHR-Device-Connect-Setup-<version>.exe /S /SERVER=https://solavel.com/hr /CODE=<pairing code>

#O que o instalador coloca no PC

Artigo Onde
Programa C:\Program Files\SolaHR Device Connect
Serviço do Windows SolaHRDeviceConnect (início automático, reinicia sozinho após uma falha)
Dados: configurações, segredos criptografados, marcações ainda não enviadas, logs C:\ProgramData\SolaHR Device Connect (legível apenas por administradores do Windows e pelo sistema)
Página local http://127.0.0.1:8790 (somente este PC)
Auxiliar de linha de comando solahr-dc (pair, status, diagnostics, run, version)

Confira se está rodando: em um prompt de comando do Windows, sc query SolaHRDeviceConnect deve dizer RUNNING.

#Firewall e rede

Direção O que Notas
PC do conector para o SolaHR HTTPS (443) Somente de saída. Se o seu escritório usa proxy ou filtra sites, libere o endereço do seu SolaHR.
PC do conector para um terminal ZKTeco TCP e UDP 4370 A porta própria do terminal.
PC do conector para um terminal Anviz TCP 5010 Porta padrão da Anviz; confira no dispositivo.
PC do conector para um terminal Hikvision HTTP/HTTPS (a porta web do dispositivo, 80 por padrão)
PC do conector para um servidor Suprema BioStar 2 HTTPS (443 por padrão) Lê pelo servidor BioStar 2, não pelo terminal.
Outros dispositivos para o PC do conector Nenhum Nada se conecta ao conector.

O firewall do Windows normalmente permite conexões de saída. Se a sua rede separa o PC e os terminais (VLANs diferentes), libere estas portas entre eles.

#A página do conector

Abra http://127.0.0.1:8790 (ou o item do menu Iniciar). Ela mostra se o conector está emparelhado e online, seus dispositivos e quantas marcações aguardam envio. Funciona em inglês e árabe, em modo claro e escuro. Também oferece:

  • Procurar dispositivos: uma busca somente de leitura na rede local por terminais compatíveis. Os resultados aparecem no SolaHR em Encontrados pelo seu conector.
  • Configurar o software necessário: configuração guiada de um SDK de fabricante. Veja Configurar o SDK do fabricante.
  • Permitir alterações nos dispositivos: desativado por padrão. Enquanto estiver desativado, o SolaHR pode ler, mas não pode editar, ativar, desativar, excluir nem enviar usuários, e mostra «As alterações neste dispositivo estão desativadas no PC do conector.»
  • Desemparelhar.

#Atualização

Execute o instalador mais novo. Ele substitui os arquivos do programa e reinicia o serviço. Emparelhamento, configurações e marcações em espera são mantidos, então não é preciso emparelhar de novo. Passar do ZIP portátil para o instalador funciona do mesmo jeito: a tarefa agendada antiga é removida para que dois conectores nunca rodem juntos.

#Mover, revogar e desinstalar

  • Mudar para outro PC. Instale e emparelhe o novo conector e, no SolaHR, altere o Conector do dispositivo. Revogue o antigo na aba Conectores.
  • Revogar. No SolaHR, Revogar no conector. Seus dispositivos param de sincronizar. As marcações em espera naquele PC ficam lá e só são enviadas se você emparelhar de novo.
  • Desinstalar. Windows Configurações → Aplicativos. Pergunta-se «Also delete the connector data?». O padrão é Não: os dados, inclusive marcações ainda não enviadas, são mantidos para que uma reinstalação continue. Sim apaga as marcações não enviadas.

#Segurança em resumo

  • A página do conector escuta apenas em 127.0.0.1 e recusa outros endereços.
  • O token de emparelhamento e as chaves de comunicação são guardados criptografados. Quem tem direitos de administrador nesse PC ainda consegue acessá-los: trate o PC como um servidor.
  • Os logs têm tokens e chaves removidos. solahr-dc diagnostics gera um pacote de suporte sem segredos.
  • Digitais e rostos nunca são enviados ao SolaHR.

#Solução de problemas de instalação

Sintoma O que verificar
O Windows bloqueia o arquivo ou avisa sobre ele Esperado na pré-visualização sem assinatura. Confira o SHA-256 e depois Mais informações → Executar assim mesmo. Se a política da empresa bloqueia programas sem assinatura, peça à TI para liberar ou aguarde a versão assinada.
O instalador diz que precisa de direitos de administrador Clique com o botão direito, Executar como administrador.
«Código expirado» ao emparelhar O código dura 15 minutos e funciona uma vez. Gere um novo.
O emparelhamento falha O endereço do SolaHR foi digitado exatamente (com https://)? O PC consegue abri-lo no navegador? Um proxy o bloqueia?
O conector continua Offline no SolaHR PC ligado e online? Serviço em execução (sc query SolaHRDeviceConnect)? A página do conector informa se ele precisa emparelhar de novo.
127.0.0.1:8790 não abre Outro programa pode estar usando a porta 8790. O serviço continua sincronizando sem a página.
«O conector precisa ser emparelhado de novo» / «O conector foi revogado» Gere um novo código de emparelhamento e emparelhe de novo. As marcações em espera são mantidas.
O serviço para logo depois de iniciar Execute solahr-dc run em um prompt de comando de administrador para ver o erro na tela e envie a saída de solahr-dc diagnostics ao suporte.

Mais em Solução de problemas e perguntas frequentes.