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
- 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.cmde responda Sim. - 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.
- 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. - 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.
- 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. - 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.1e 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 diagnosticsgera 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.