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