Solavel Документы
Русский

Установка коннектора Device Connect

Последнее обновление

Коннектор — небольшая программа для Windows, которая считывает ваши терминалы учёта и отправляет отметки в SolaHR. Эта страница описывает скачивание, установку, привязку, обновление и удаление, а также что проверить, если что-то не работает. Если сначала хотите понять идею, прочтите обзор.

Предварительная версия. Коннектор собран и проверен на симуляторах и одной реальной модели терминала. Он пока не подписан, поэтому Windows предупредит вас при запуске. Сначала попробуйте на одном ПК и одном устройстве.

#Прежде чем начать

Нужно Подробности
ПК или сервер с Windows Windows 10 или 11, либо Windows Server 2016 и новее, 64-разрядная. Windows 7/8, 32-разрядная Windows и ARM не поддерживаются.
Всегда включён ПК должен оставаться включённым и не засыпать и находиться в той же сети (и VLAN), что и терминалы. Подойдёт небольшой офисный ПК или сервер.
Права администратора Для установки, а позже — для регистрации SDK производителя.
Интернет Исходящий HTTPS на адрес вашего SolaHR (например, https://solavel.com/hr). Входящий порт не нужен.
Пользователь SolaHR с правом управлять устройствами Владелец или HR-менеджер.
IP-адрес терминала И его ключ связи, если он есть. См. Добавление устройства.

Специальное оборудование не нужно; достаточно обычного офисного ПК (измеренные минимальные требования мы пока не публиковали).

#Выбор пакета

В SolaHR откройте Время и посещаемость → Устройства учёта → Коннекторы → Добавить коннектор. Предлагаются две загрузки для Windows 10 / 11 · 64-разрядная, у каждой указаны версия и размер.

Пакет Что это такое Использовать, когда
Установщик для Windows .exe (рекомендуется) Устанавливает коннектор как службу Windows: она запускается сама при загрузке, перезапускается после сбоя и сохраняет данные при обновлении. Обычное использование.
Портативный ZIP Без установщика. Распакуйте и запустите install.cmd — будет зарегистрировано запланированное задание, запускающее коннектор при загрузке. Это не служба Windows. Быстрая проверка или ПК, где нельзя запускать установщик.

Оба помечены как Предварительная версия. Если на странице написано «Установщик для Windows скоро появится здесь.», пакет ещё не опубликован.

Проверьте загрузку. В разделе Подробности есть примечания к выпуску и команда PowerShell. Выполните её и сравните: результат Get-FileHash должен совпадать со значением SHA-256 на странице.

#Установка и привязка по шагам

  1. Запустите установщик от имени администратора (правый клик, Запуск от имени администратора). Для ZIP: правый клик по ZIP, Извлечь всё, двойной клик по install.cmd и ответьте Да.
  2. SmartScreen. Поскольку предварительная версия не подписана, Windows может показать «Windows защитил ваш компьютер». Проверив SHA-256, нажмите Подробнее, затем Всё равно выполнить. Это предупреждение исчезнет, когда программа будет подписана; до тех пор оно ожидаемо и не говорит о проблеме.
  3. Откроется страница коннектора в браузере по адресу http://127.0.0.1:8790. Эта страница доступна только на этом ПК. В меню «Пуск» также есть SolaHR Device Connect.
  4. Получите код привязки. В SolaHR нажмите Добавить коннектор и скопируйте Код привязки. Он действует один раз и истекает через 15 минут; при истечении создайте новый.
  5. Привяжите. На странице коннектора введите адрес вашего SolaHR (например, https://solavel.com/hr) и код, затем нажмите Pair.
  6. В SolaHR коннектор появится как В сети в течение минуты. Теперь добавьте устройство и назначьте его этому коннектору.

Для ИТ-команд установщик также работает в тихом режиме, при желании с адресом и кодом:

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

#Что установщик размещает на ПК

Товар Где
Программа C:\Program Files\SolaHR Device Connect
Служба Windows SolaHRDeviceConnect (автозапуск, сама перезапускается после сбоя)
Данные: настройки, зашифрованные секреты, ещё не отправленные отметки, журналы C:\ProgramData\SolaHR Device Connect (доступно для чтения только администраторам Windows и системе)
Локальная страница http://127.0.0.1:8790 (только этот ПК)
Вспомогательная программа командной строки solahr-dc (pair, status, diagnostics, run, version)

Проверьте, что она работает: в командной строке Windows sc query SolaHRDeviceConnect должна показать RUNNING.

#Межсетевой экран и сеть

Направление Что Примечания
ПК с коннектором → SolaHR HTTPS (443) Только исходящие. Если в офисе используется прокси или фильтрация сайтов, разрешите адрес вашего SolaHR.
ПК с коннектором → терминал ZKTeco TCP и UDP 4370 Собственный порт терминала.
ПК с коннектором — терминал Anviz TCP 5010 Порт Anviz по умолчанию; проверьте его на устройстве.
ПК с коннектором — терминал Hikvision HTTP/HTTPS (веб-порт устройства, по умолчанию 80)
ПК с коннектором — сервер Suprema BioStar 2 HTTPS (по умолчанию 443) Чтение идёт через сервер BioStar 2, а не через терминал.
Остальные устройства — ПК с коннектором Нет Ничего не подключается к коннектору.

Брандмауэр Windows обычно разрешает исходящие подключения. Если ваша сеть разделяет ПК и терминалы (разные VLAN), разрешите эти порты между ними.

#Страница коннектора

Откройте http://127.0.0.1:8790 (или пункт в меню «Пуск»). Она показывает, привязан ли коннектор и находится ли он в сети, его устройства и сколько отметок ждёт отправки. Страница работает на английском и арабском языках, в светлой и тёмной теме. Здесь также можно:

  • Найти устройства: поиск поддерживаемых терминалов в локальной сети только для чтения. Результаты появляются в SolaHR в разделе Найдено вашим коннектором.
  • Настроить необходимое ПО: пошаговая настройка SDK производителя. См. Настройка SDK производителя.
  • Разрешить изменения устройств: по умолчанию отключено. Пока параметр выключен, SolaHR может только читать данные, но не может изменять, включать, отключать, удалять или передавать пользователей, и показывает «Изменения этого устройства отключены на ПК с коннектором.»
  • Отвязать.

#Обновление

Запустите новый установщик. Он заменит файлы программы и перезапустит службу. Привязка, настройки и ожидающие отметки сохраняются, поэтому повторно привязывать не нужно. Переход с портативного ZIP на установщик выполняется так же: старая запланированная задача удаляется, чтобы два коннектора никогда не работали одновременно.

#Перенос, отзыв и удаление

  • Перенос на другой ПК. Установите и привяжите новый коннектор, затем в SolaHR измените у устройства поле Коннектор. Отзовите старый на вкладке Коннекторы.
  • Отзыв. В SolaHR нажмите Отозвать у коннектора. Его устройства перестанут синхронизироваться. Отметки, ожидающие на этом ПК, остаются там и не отправляются, пока вы не привяжете коннектор снова.
  • Удаление. В Windows откройте Параметры → Приложения. Вас спросят «Также удалить данные коннектора?». По умолчанию выбрано Нет: данные, включая ещё не отправленные отметки, сохраняются, чтобы при переустановке всё продолжилось. Да удаляет неотправленные отметки.

#Безопасность вкратце

  • Страница коннектора слушает только 127.0.0.1 и отклоняет другие адреса.
  • Токен привязки и Comm Key хранятся в зашифрованном виде. Любой, у кого есть права администратора на этом ПК, всё же может до них добраться: относитесь к этому ПК как к серверу.
  • В журналах токены и ключи удаляются. solahr-dc diagnostics создаёт пакет для поддержки без секретов.
  • Отпечатки пальцев и лица никогда не отправляются в SolaHR.

#Устранение проблем при установке

Симптом Что проверить
Windows блокирует файл или предупреждает о нём Это ожидаемо для неподписанной предварительной версии. Проверьте SHA-256, затем нажмите Подробнее → Выполнить в любом случае. Если политика вашей компании блокирует неподписанные программы, попросите ИТ разрешить её или дождитесь подписанного выпуска.
Установщик сообщает, что нужны права администратора Нажмите правой кнопкой мыши и выберите Запуск от имени администратора.
«Срок действия кода истёк» при привязке Код действует 15 минут и срабатывает один раз. Создайте новый.
Не удаётся выполнить привязку Адрес SolaHR введён точно (с https://)? Открывается ли он в браузере на этом ПК? Не блокирует ли его прокси?
Коннектор остаётся Не в сети в SolaHR ПК включён и подключён к сети? Служба запущена (sc query SolaHRDeviceConnect)? Страница коннектора сообщит, нужно ли привязать его снова.
127.0.0.1:8790 не открывается Возможно, порт 8790 занят другой программой. Служба продолжает синхронизироваться и без страницы.
«Коннектор нужно привязать заново» / «Коннектор был отозван» Создайте новый код привязки и привяжите коннектор снова. Ожидающие отметки сохраняются.
Служба останавливается сразу после запуска Выполните solahr-dc run в командной строке от имени администратора, чтобы увидеть ошибку на экране, и отправьте вывод solahr-dc diagnostics в поддержку.

Подробнее в разделе Устранение неполадок и вопросы и ответы.