Solavel Dokumente
Deutsch

Den Device-Connect-Connector installieren

Zuletzt aktualisiert

Der Connector ist das kleine Windows-Programm, das Ihre Zeiterfassungsterminals liest und die Stempelungen an SolaHR sendet. Diese Seite führt durch Herunterladen, Installieren, Koppeln, Aktualisieren und Entfernen und listet auf, was Sie bei Problemen prüfen. Wenn Sie zuerst die Idee verstehen möchten, lesen Sie den Überblick.

Vorschau. Der Connector wurde mit Simulatoren und einem echten Terminalmodell gebaut und geprüft. Er ist noch nicht code-signiert, daher warnt Windows beim Start. Probieren Sie ihn zuerst auf einem PC und einem Gerät aus.

#Bevor Sie beginnen

Benötigt Detail
Ein Windows-PC oder Server Windows 10 oder 11 oder Windows Server 2016 und neuer, 64 Bit. Windows 7/8, 32-Bit-Windows und ARM werden nicht unterstützt.
Immer eingeschaltet Der PC muss eingeschaltet und aktiv bleiben und im selben Netzwerk (und VLAN) wie die Terminals stehen. Ein kleiner Büro-PC oder ein Server genügt.
Administratorrechte Zum Installieren und später zum Registrieren eines Hersteller-SDK.
Internet Ausgehendes HTTPS zu Ihrer SolaHR-Adresse (zum Beispiel https://solavel.com/hr). Es wird kein eingehender Port benötigt.
Ein SolaHR-Benutzer mit Berechtigung zur Geräteverwaltung Der Besitzer oder eine Personalleitung.
Die IP-Adresse des Terminals Und sein Comm Key, falls vorhanden. Siehe Gerät hinzufügen.

Es ist keine besondere Hardware nötig; ein normaler Büro-PC genügt (gemessene Mindestwerte haben wir noch nicht veröffentlicht).

#Ein Paket wählen

Öffnen Sie in SolaHR Zeit & Anwesenheit → Zeiterfassungsgeräte → Connectors → Connector hinzufügen. Es werden zwei Downloads für Windows 10 / 11 · 64 Bit angeboten, jeweils mit Version und Größe.

Paket Was es ist Verwenden Sie dies, wenn
Windows-Installer .exe (empfohlen) Installiert den Connector als Windows-Dienst: Er startet beim Hochfahren von selbst, startet nach einem Fehler neu und behält seine Daten bei Updates. Normaler Gebrauch.
Portables ZIP Kein Installer. Entpacken und install.cmd ausführen; das registriert eine geplante Aufgabe, die den Connector beim Hochfahren startet. Es ist kein Windows-Dienst. Ein schneller Test oder ein PC, auf dem kein Installer ausgeführt werden darf.

Beide sind als Vorschau gekennzeichnet. Steht auf der Seite „Der Windows-Installer ist hier bald verfügbar.“, wurde noch kein Paket veröffentlicht.

Download prüfen. Unter Details finden Sie die Versionshinweise und einen PowerShell-Befehl. Führen Sie ihn aus und vergleichen Sie: Das Ergebnis von Get-FileHash muss dem auf der Seite angezeigten SHA-256-Wert entsprechen.

#Installieren und koppeln, Schritt für Schritt

  1. Installer als Administrator ausführen (Rechtsklick, Als Administrator ausführen). Beim ZIP: Rechtsklick auf das ZIP, Alle extrahieren, doppelklicken Sie auf install.cmd und antworten Sie mit Ja.
  2. SmartScreen. Da die Vorschau nicht signiert ist, zeigt Windows eventuell „Der PC wurde durch Windows geschützt“. Klicken Sie nach der SHA-256-Prüfung auf Weitere Informationen und dann auf Trotzdem ausführen. Diese Warnung verschwindet, sobald das Programm signiert ist; bis dahin ist sie normal und kein Hinweis auf ein Problem.
  3. Die Connector-Seite öffnet sich im Browser unter http://127.0.0.1:8790. Diese Seite ist nur auf diesem PC erreichbar. Im Startmenü gibt es außerdem SolaHR Device Connect.
  4. Kopplungscode holen. Klicken Sie in SolaHR auf Connector hinzufügen und kopieren Sie den Kopplungscode. Er gilt einmal und läuft nach 15 Minuten ab; erzeugen Sie bei Bedarf einen neuen.
  5. Koppeln. Geben Sie auf der Connector-Seite Ihre SolaHR-Adresse (zum Beispiel https://solavel.com/hr) und den Code ein und drücken Sie Pair.
  6. In SolaHR erscheint der Connector innerhalb einer Minute als Online. Jetzt fügen Sie ein Gerät hinzu und weisen es diesem Connector zu.

Für IT-Teams: Der Installer läuft auch unbeaufsichtigt, optional mit Adresse und Code:

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

#Was der Installer auf dem PC ablegt

Artikel Wo
Programm C:\Program Files\SolaHR Device Connect
Windows-Dienst SolaHRDeviceConnect (automatischer Start, startet nach einem Fehler selbst neu)
Daten: Einstellungen, verschlüsselte Geheimnisse, noch nicht gesendete Stempelungen, Protokolle C:\ProgramData\SolaHR Device Connect (nur für Windows-Administratoren und das System lesbar)
Lokale Seite http://127.0.0.1:8790 (nur dieser PC)
Befehlszeilenhilfe solahr-dc (pair, status, diagnostics, run, version)

Prüfen, ob er läuft: In einer Windows-Eingabeaufforderung muss sc query SolaHRDeviceConnect RUNNING melden.

#Firewall und Netzwerk

Richtung Was Notizen
Connector-PC zu SolaHR HTTPS (443) Nur ausgehend. Nutzt Ihr Büro einen Proxy oder filtert Websites, geben Sie Ihre SolaHR-Adresse frei.
Connector-PC zu einem ZKTeco-Terminal TCP und UDP 4370 Der eigene Port des Terminals.
Connector-PC zu einem Anviz-Terminal TCP 5010 Standardport von Anviz; am Gerät prüfen.
Connector-PC zu einem Hikvision-Terminal HTTP/HTTPS (der Webport des Geräts, standardmäßig 80)
Connector-PC zu einem Suprema-BioStar-2-Server HTTPS (standardmäßig 443) Liest über den BioStar-2-Server, nicht über das Terminal.
Andere Geräte zum Connector-PC Keine Nichts verbindet sich mit dem Connector.

Die Windows-Firewall erlaubt ausgehende Verbindungen normalerweise. Trennt Ihr Netzwerk PC und Terminals (verschiedene VLANs), geben Sie diese Ports dazwischen frei.

#Die Connector-Seite

Öffnen Sie http://127.0.0.1:8790 (oder den Startmenüeintrag). Sie zeigt, ob der Connector gekoppelt und online ist, seine Geräte und wie viele Stempelungen auf den Versand warten. Sie funktioniert auf Englisch und Arabisch, hell und dunkel. Außerdem bietet sie:

  • Geräte suchen: eine lesende Suche im lokalen Netzwerk nach unterstützten Terminals. Die Ergebnisse erscheinen in SolaHR unter Vom Connector gefunden.
  • Erforderliche Software einrichten: geführte Einrichtung eines Hersteller-SDK. Siehe Hersteller-SDK einrichten.
  • Änderungen an Geräten erlauben: standardmäßig aus. Solange es aus ist, kann SolaHR lesen, aber keine Benutzer bearbeiten, aktivieren, deaktivieren, löschen oder übertragen, und zeigt „Änderungen an diesem Gerät sind auf dem Connector-PC ausgeschaltet.“
  • Kopplung aufheben.

#Aktualisieren

Führen Sie den neueren Installer aus. Er ersetzt die Programmdateien und startet den Dienst neu. Kopplung, Einstellungen und wartende Stempelungen bleiben erhalten, Sie koppeln nicht erneut. Der Wechsel vom portablen ZIP zum Installer funktioniert genauso: Die alte geplante Aufgabe wird entfernt, damit nie zwei Connectors gleichzeitig laufen.

#Verschieben, widerrufen und deinstallieren

  • Auf einen anderen PC umziehen. Installieren und koppeln Sie den neuen Connector und ändern Sie in SolaHR den Connector des Geräts. Widerrufen Sie den alten auf dem Tab Connectors.
  • Widerrufen. Klicken Sie in SolaHR beim Connector auf Widerrufen. Seine Geräte synchronisieren nicht mehr. Auf diesem PC wartende Stempelungen bleiben dort und werden nur gesendet, wenn Sie erneut koppeln.
  • Deinstallieren. Windows Einstellungen → Apps. Sie werden gefragt „Also delete the connector data?“. Standard ist Nein: Die Daten, auch noch nicht gesendete Stempelungen, bleiben erhalten, sodass eine Neuinstallation nahtlos weiterläuft. Ja löscht ungesendete Stempelungen.

#Sicherheit in Kürze

  • Die Connector-Seite lauscht nur auf 127.0.0.1 und weist andere Adressen ab.
  • Das Kopplungstoken und die Comm Keys werden verschlüsselt gespeichert. Wer Administratorrechte auf dem PC hat, kommt trotzdem heran: Behandeln Sie den PC wie einen Server.
  • Aus Protokollen werden Tokens und Schlüssel entfernt. solahr-dc diagnostics erzeugt ein Support-Paket ohne Geheimnisse.
  • Fingerabdrücke und Gesichter werden nie an SolaHR gesendet.

#Fehlerbehebung bei der Installation

Symptom Was zu prüfen ist
Windows blockiert die Datei oder warnt davor Bei der unsignierten Vorschau zu erwarten. Prüfen Sie den SHA-256, dann Weitere Informationen → Trotzdem ausführen. Blockiert Ihre Firmenrichtlinie unsignierte Programme, bitten Sie die IT um Freigabe oder warten Sie auf die signierte Version.
Der Installer verlangt Administratorrechte Rechtsklick, Als Administrator ausführen.
„Code abgelaufen“ beim Koppeln Der Code gilt 15 Minuten und nur einmal. Erzeugen Sie einen neuen.
Die Kopplung schlägt fehl Ist die SolaHR-Adresse exakt eingegeben (mit https://)? Kann der PC sie im Browser öffnen? Blockiert ein Proxy sie?
Der Connector bleibt in SolaHR Offline PC an und online? Dienst läuft (sc query SolaHRDeviceConnect)? Die Connector-Seite zeigt, ob erneut gekoppelt werden muss.
127.0.0.1:8790 öffnet sich nicht Möglicherweise verwendet ein anderes Programm den Port 8790. Der Dienst synchronisiert auch ohne die Seite weiter.
„Connector muss neu gekoppelt werden“ / „Connector wurde widerrufen“ Erzeugen Sie einen neuen Kopplungscode und koppeln Sie erneut. Wartende Stempelungen bleiben erhalten.
Der Dienst beendet sich gleich nach dem Start Führen Sie solahr-dc run in einer Eingabeaufforderung als Administrator aus, um den Fehler auf dem Bildschirm zu sehen, und senden Sie die Ausgabe von solahr-dc diagnostics an den Support.

Mehr unter Fehlerbehebung und FAQ.