Большинство терминалов читаются напрямую по сети, и больше ничего не нужно. Несколько типов подключения используют собственное программное обеспечение производителя для Windows («SDK») на ПК с коннектором. Сейчас это только ZKTeco SDK. На этой странице объясняется, когда оно нужно, как установить его шаг за шагом, что означают проверки и какие действуют правила лицензии.
Предварительная версия и честное замечание. Путь через SDK создан и проверен только на программных симуляциях. Он не запускался с реальной установкой SDK на ПК с Windows и не проверялся на реальных терминалах всех моделей. На реальном ПК могут отличаться: структура реестра, поведение
regsvr32, точные ответы SDK на некоторые вызовы. Сначала попробуйте на одном устройстве. Если не получится, встроенное прямое подключение всегда доступно.
#Нужно ли оно вам?
Скорее всего, нет. Для большинства терминалов ZKTeco выбирайте ZKTeco (напрямую): он читает отметки и пользователей, устанавливает часы, перезапускает устройство и изменяет пользователей, и проверен на реальном iFace702. Используйте тип SDK, только если вам нужно то, чего прямое подключение не умеет:
| Функция | ZKTeco напрямую | ZKTeco SDK |
|---|---|---|
| Чтение отметок, пользователей и часов устройства | Да | Да |
| Изменение, добавление, удаление пользователей; установка часов; перезапуск | Да | Да |
| Включение / отключение пользователя на устройстве | Нет («здесь не поддерживается») | Да |
| Копирование лиц и отпечатков между двумя устройствами | Нет | Да |
| Фото пользователей, снимки при отметках | Нет | Да |
| События отметок в реальном времени | Нет (опрос) | Да, только программно протестировано (лучше всего с 64-разрядным SDK) |
| Нужно программное обеспечение на ПК | Нет | Да: ZKTeco SDK, зарегистрированный |
| Проверено на реальном устройстве | Да (iFace702, функции только для чтения) | Нет (только симуляция) |
Изменения устройств также должны быть разрешены на странице коннектора (см. Установка), а для расширенных нужен владелец.
#Пошагово: 64-разрядный SDK (рекомендуется)
ПК с коннектором должен работать под Windows (64-разрядной), и нужны права администратора.
- Скачайте ZKTeco Standalone SDK самостоятельно, у ZKTeco. SolaHR никогда не включает и не распространяет его. Скачивая, вы принимаете условия лицензии ZKTeco. Используйте версию 6.3.1.37 или новее: в ней есть папка
64bitс настоящей 64-разряднойzkemkeeper.dll, соответствующей 64-разрядному коннектору. О том, где её взять, см. примечание ниже. - Распакуйте пакет в любое место на ПК (например, в папку «Загрузки»).
- Откройте папку
64bit, щёлкните правой кнопкой мыши Register_SDK_x64.bat и выберите Запуск от имени администратора. Он скопирует файлы SDK в системную папку Windows и зарегистрируетzkemkeeper.dllза вас. - В SolaHR (страница устройства, Настроить необходимое ПО) или на странице коннектора нажмите Проверить установку.
- Прочитайте результаты проверок. Когда все они Готово, карточка устройства перестаёт показывать Требуется настройка, и Проверить подключение работает.
Где взять SDK. ZKTeco публикует материалы по SDK в своём Центре загрузок (категория SDK) и ведёт репозиторий Standalone-SDK в своём аккаунте GitHub. На момент написания нам удалось проверить, что в репозитории лежит более старый 32-разрядный пакет (Communication Protocol SDK 6.2.4.11) и что в списке SDK Центра загрузок показаны другие SDK (модули отпечатков и видимого света); публичную ссылку на 6.3.1.37 подтвердить не удалось. Для некоторых загрузок ZKTeco нужен бесплатный вход участника. Если найти не получается, обратитесь в ZKTeco или к своему дистрибьютору ZKTeco и запросите «Standalone SDK 6.3.1.37 или новее, 64-разрядный». Ссылка, показанная в SolaHR, также независимо не проверена.
#Что означают проверки готовности
| Проверьте | Значение | Если написано «Отсутствует» |
|---|---|---|
| Windows | ПК работает под управлением Windows. | Тип SDK не может работать в другой системе («Этот тип подключения не может работать на этом ПК»). |
| Компонент Python COM | Коннектор может взаимодействовать с компонентами Windows (pywin32). | Входит в состав коннектора. Переустановите или обновите коннектор. |
| SDK зарегистрирован | Windows знает об SDK (zkemkeeper). |
Запустите Register_SDK_x64.bat от имени администратора. |
| Файл DLL | Зарегистрированная zkemkeeper.dll существует на диске. |
Зарегистрируйте снова; не перемещайте и не удаляйте файлы после этого. |
| Разрядность | SDK 32- или 64-разрядный, а коннектор 64-разрядный. | Только 32-разрядный SDK напрямую не подходит: используйте 64-разрядный SDK или запасной вариант ниже. |
Проверка готовности выполняется перед каждой проверкой подключения и опросом. Отсутствие SDK — это статус «Требуется настройка»: SolaHR не повторяет попытки в цикле и не считает устройство недоступным.
#Запасной вариант: более старый, только 32-разрядный SDK
В старых пакетах есть только 32-разрядный компонент, который 64-разрядный коннектор не может загрузить напрямую. Тогда страница коннектора предлагает Выбрать DLL / Зарегистрировать (нужны права администратора; Windows попросит подтверждение). Она делает ровно это и ничего больше:
- проверяет, что выбранный файл — локальный файл с именем строго
zkemkeeper.dllи настоящая библиотека DLL для Windows; - регистрирует этот единственный файл в Windows (
regsvr32); - если файл 32-разрядный, заставляет Windows запускать его в отдельном 32-разрядном вспомогательном процессе.
Она ничего не скачивает, не запускает другие файлы и не изменяет устройства. В целях безопасности, когда коннектор работает как служба, он регистрирует DLL только из Program Files или Windows; для DLL в другом месте администратор запускает solahr-dc sdk-setup --dll <path> из командной строки с повышенными правами. solahr-dc readiness выводит текущий отчёт, а solahr-dc sdk-setup --candidates перечисляет найденные копии DLL. События в реальном времени по этому пути могут быть ненадёжны; для них используйте 64-разрядный SDK. Чтобы отменить: regsvr32 /u <path to dll>. Удаление Device Connect не затрагивает регистрацию вашего SDK.
#Если SDK не работает: используйте встроенное подключение
В панели Настроить необходимое ПО нажмите Использовать встроенное подключение. После вашего подтверждения SolaHR меняет тип подключения на прямое, сохраняет IP-адрес и порт, сбрасывает настройки SDK и снова проверяет устройство. Отметки и сопоставления сотрудников сохраняются. Без вашего подтверждения ничего не переключается.
#Лицензионные ограничения производителей и другие производители
| SDK производителя | Статус в Device Connect | Ограничения, о которых стоит знать |
|---|---|---|
ZKTeco Standalone SDK (zkemkeeper) |
Реализован, только программно протестирован | Лицензируется ZKTeco. Не входит в поставку и не может распространяться нами: вы скачиваете его у ZKTeco и принимаете её условия (в проверенном нами репозитории GitHub текста лицензии нет, поэтому прочитайте условия, поставляемые с вашей загрузкой). Только для Windows. Регистрация действует на всей машине и требует прав администратора. |
| Suprema G-SDK | Запланирован, не реализован | В репозитории G-SDK Suprema сказано, что загрузки переносятся в Центр загрузок Suprema (с 2 марта 2026 года), а лицензия там не указана; для загрузки может потребоваться вход партнёра. Сейчас устройства Suprema читаются через сервер BioStar 2. |
| Hikvision Device Network SDK | Не планируется | Не нужен: терминалы Hikvision читаются по ISAPI (веб-протокол). Страницы SDK Hikvision предназначены для ваших собственных проектов; для руководств разработчика ISAPI на портале TPP нужны подписанное соглашение и данные партнёра. |
| Anviz CrossChex SDK | Не планируется | Не нужен: Anviz читается по своему сетевому протоколу или через CrossChex Cloud. У Anviz есть страница загрузки SDK для ваших собственных проектов. |
Ничто здесь не является юридической консультацией: всегда читайте лицензию, поставляемую с загрузкой от производителя.