Support Hub/Learn & Insights/Ваш SDK поставщика работает только в Windows, и это в…
Translated from the English article and reviewed by a person. Read the English original
Article

Ваш SDK поставщика работает только в Windows, и это в десятилетии ИИ?

Ваш SDK поставщика работает только в Windows, и это в десятилетии ИИ?

Если вы читаете это, ваша команда, вероятно, уже это говорила. Ваше биометрическое оборудование работает исправно. Устройство делает именно то, что должно. Но SDK, который производитель распространяет для связи с ним, — это скомпилированная Windows DLL, она требует определённую среду выполнения Visual C++, не запускается в контейнере Docker, а ваши разработчики работают на Mac или Linux. Проблема не в устройстве. Проблема в SDK. В этой статье объясняется, почему это происходит, почему каждое обходное решение, которое пробовала ваша команда, в итоге даёт сбой, и как выглядит архитектурная альтернатива.

 

Жалобы одинаковы во всех инженерных командах

Конкретные детали различаются, но закономерность всегда одна и та же. Организация интегрирует биометрическое оборудование, обнаруживает ограничения SDK на поздних этапах и тратит значительное время инженеров на обход проблемы, которой не должно было быть. Вот как эти жалобы звучат на практике.

Что инженерные команды говорят каждый раз
«SDK поставляется только как Windows DLL. Весь наш бэкенд работает на Linux. Нам пришлось поднять отдельную виртуальную машину с Windows только для того, чтобы запустить интеграцию с биометрией.»
«Мы не можем поместить это в контейнер. Docker недоступен. Kubernetes недоступен. Каждое развёртывание — ручной процесс на машине, которую нельзя заменить без переустановки SDK и получения новой лицензии.»
«Ваши разработчики все работают на Mac или Linux. Никто не может запустить интеграцию локально. Для тестирования нужно подключаться удалённо к единственной Windows-машине в офисе, на которой установлен SDK.»
«SDK требует Visual C++ Redistributable 2010. Новому разработчику понадобилось три дня, чтобы настроить окружение, прежде чем он написал хотя бы одну строку кода интеграции.»
«Мы обновили сервер до Windows Server 2022, и SDK перестал работать. Поставщику понадобилось две недели, чтобы выпустить обновлённую версию, и всё это время у нас не было данных о посещаемости.»
«Наш конвейер CI/CD не может протестировать интеграцию с биометрией вообще. Каждый тест выполняется вручную. Каждый релиз интеграции требует, чтобы кто-то физически сидел за Windows-машиной и запускал её.»

Почему биометрические SDK работают только в Windows: настоящая причина

Легко предположить, что связь с биометрическим оборудованием настолько сложна, что требует системных API, специфичных для Windows. Это не так. Настоящая причина, по которой биометрические SDK работают только в Windows, гораздо проще и обиднее: это среда, для которой SDK изначально был написан, и с тех пор никто не вкладывался в её изменение.

Большинство SDK для биометрических устройств были написаны на C или C++ в начале 2000-х годов с расчётом на Windows как доминирующую корпоративную настольную ОС той эпохи. Результатом компиляции стала DLL — Dynamic Link Library, двоичный формат, специфичный для Windows. Логика связи, функции, которые открывают TCP-соединение с устройством, декодируют формат двоичных пакетов и возвращают структурированные данные, была скомпилирована в эту DLL и распространена среди клиентов.

В то время это было разумное решение. Корпоративное ПО работало на Windows. Серверы работали на Windows. Разработчики использовали Windows. Формат DLL был стандартным механизмом распространения многократно используемого скомпилированного кода в этой экосистеме. Ничего неправильного в этом выборе с учётом контекста не было.

Проблема в том, что контекст полностью изменился, а SDK — нет. Linux стал доминирующей серверной ОС. Mac стал доминирующей рабочей станцией разработчика. Контейнеры Docker стали стандартной единицей развёртывания. Облачная инфраструктура заменила локальные серверы Windows. Но биометрический SDK остался Windows DLL, потому что переписывание его для кроссплатформенного распространения требует инженерных вложений, к которым у производителя оборудования мало коммерческого стимула.

«SDK не был создан враждебным по отношению к Linux или Mac. Он был создан для мира, в котором Linux и Mac не были средой работы корпоративного ПО. Этого мира больше не существует. SDK остался позади.»

Что SDK только для Windows блокирует в современном стеке

Последствия SDK только для Windows распространяются на каждый уровень современной среды разработки и развёртывания. Каждое ограничение ниже — реальная проблема, с которой сталкиваются инженерные команды при попытке интегрировать биометрическое оборудование в актуальный программный стек.

Docker и контейнеризация
Контейнеры Docker работают на Linux. Windows DLL нельзя загрузить внутри контейнера Linux. Любой сервис, которому нужно обращаться к SDK, должен работать на отдельной машине с Windows или в контейнере Windows, что тяжелее, менее переносимо и дороже в эксплуатации, чем стандартный контейнер Linux.
Облачные серверы на Linux
AWS, Google Cloud и Azure предлагают виртуальные машины Linux как стандартный и самый дешёвый вариант сервера. Запуск виртуальной машины с Windows специально для размещения интеграции с биометрическим SDK стоит дороже и добавляет эксплуатационные расходы, которые не имеют отношения к самой биометрической функции.
Среды разработки на Mac
Разработчики не могут загружать, запускать или тестировать SDK на своих локальных машинах. Каждый тест интеграции требует доступа к единственной машине с Windows, на которой установлен SDK. Локальные циклы обратной связи в разработке, базовое требование продуктивной инженерной работы, для этой части стека исключаются.
Конвейеры CI/CD
Автоматизированные конвейеры тестирования работают на агентах Linux. Модульные тесты, интеграционные тесты и автоматические проверки развёртывания не могут включать какой-либо путь кода, который вызывает SDK. Интеграция с биометрией полностью находится вне процесса автоматического контроля качества.
Serverless-функции
AWS Lambda, Google Cloud Functions и Azure Functions работают на управляемых средах выполнения Linux. Serverless-архитектура для биометрической интеграции невозможна с Windows DLL. Функцию необходимо полностью заменить долго работающим процессом в Windows, что сводит на нет экономическую и эксплуатационную модель serverless.
Оркестрация Kubernetes
Kubernetes управляет контейнерами в кластерах. Сервис, зависящий от SDK для Windows, не может участвовать в стандартной оркестрации Kubernetes без пулов узлов Windows, настройка которых значительно сложнее и эксплуатация дороже, чем стандартных пулов узлов Linux.

Обходные решения, которые создают команды, и почему они в итоге всегда выходят из строя

Столкнувшись с SDK только для Windows и современным стеком, инженерные команды строят обходные решения. Каждое из них решает непосредственную проблему, но создаёт новую структурную зависимость, которая со временем породит другую проблему.

01
Выделенная виртуальная машина с Windows
Виртуальная машина с Windows выделяется специально для запуска SDK. Сервис интеграции с биометрией работает на этой ВМ и предоставляет внутренний API, к которому обращается остальной стек. Это создаёт постоянную единую точку отказа, которую нельзя автоматически заменить при сбое, нельзя масштабировать горизонтально и которую нужно обновлять и обслуживать как отдельную инфраструктурную задачу.
Выходит из строя, когда: ВМ выводится из эксплуатации, обновляется или мигрирует, и SDK перестаёт работать.
02
Обёртка COM interop
На C# пишется тонкая обёртка, которая загружает DLL и предоставляет её как объект COM или локальный HTTP-сервис, к которому могут обращаться другие процессы. Это добавляет языковую границу, границу процесса и новую кодовую базу, которую нужно поддерживать. Разработчик, который её написал, обычно единственный, кто её понимает, и в итоге он уходит.
Выходит из строя, когда: SDK обновляется и обёртка ломается или первоначальный разработчик покидает команду.
03
Wine в Linux
Wine — это слой совместимости, который позволяет некоторым двоичным файлам Windows работать в Linux. Некоторые команды пытаются запустить DLL биометрического SDK под Wine. Это работает периодически для простых SDK и непредсказуемо ломается для сложных, которые опираются на системные вызовы, специфичные для Windows. Поддержки от поставщика SDK для развёртываний на базе Wine нет.
Выходит из строя, когда: SDK вызывает API Windows, который Wine не реализует, что случается часто.
04
Подсистема Windows для Linux
WSL2 позволяет процессам Linux работать в Windows и наоборот. Некоторые команды устанавливают SDK на машину с Windows и открывают к нему доступ через мост WSL2. Это инструмент удобства для разработчиков, применённый как подход к интеграции в производстве. Он не предназначен для производственных нагрузок и вносит нестабильность на границе WSL при устойчивой нагрузке.
Выходит из строя, когда: обновления WSL ломают мост или нагрузка вызывает нестабильность на уровне границы.
05
Python ctypes или cffi
Библиотека ctypes в Python позволяет напрямую вызывать C-функции из скомпилированной DLL из кода Python. Это может работать в Windows для простых интерфейсов DLL. Требуется ручное управление памятью, аккуратное сопоставление типов и глубокое знание соглашений о вызовах DLL. Это хрупко, в большинстве случаев не документировано и совершенно непереносимо на любую платформу, отличную от Windows.
Выходит из строя, когда: интерфейс DLL меняется в обновлении, что и произойдёт без каких-либо гарантий версионирования.
Закономерность, общая для всех обходных решений

Каждое обходное решение принимает Windows DLL как фиксированное ограничение и строит вокруг неё. Ни одно из них не устраняет ограничение. Все они добавляют сложность, увеличивают объём обслуживания и создают новые режимы отказа. Правильное решение — не построить лучшее обходное решение, а полностью устранить зависимость от DLL.

Как выглядит альтернативная архитектура

Windows DLL существует потому, что производителю устройства нужно было дать разработчикам способ связи с проприетарным двоичным протоколом устройства, не раскрывая сам протокол. DLL — это уровень абстракции между двоичным форматом передачи и кодом разработчика.

Этот уровень абстракции не обязан быть DLL. Это может быть HTTP-сервер, который работает с JSON. Сервер обрабатывает двоичный протокол с одной стороны и предоставляет API с другой. Разработчики вызывают API, используя стандартные HTTP-клиентские библиотеки, которые работают на любой платформе, на любом языке, внутри любого контейнера, через любой конвейер CI/CD, на любом ноутбуке разработчика независимо от операционной системы.

Подход с SDK

Windows DLL установлена на конкретной машине. Вызывается через FFI или обёртку, специфичную для языка. Привязана к операционной системе и версии среды выполнения. Не может быть контейнеризирована. Не может быть протестирована в CI. Ломается при обновлениях ОС. Один SDK на каждый бренд устройств.

Подход с биометрическим шлюзом

Два типа API, каждый выполняет свою задачу. Callback API передаёт события в реальном времени от устройства на ваш сервер с нулевой задержкой. RESTful API принимает команды с вашего сервера на устройство со временем выполнения около 15 секунд. Оба используют JSON поверх HTTP/HTTPS с опциональным шифрованием AES-256. Любой язык, любая ОС, полная возможность контейнеризации, тестирование в любой среде CI.

Ни один из типов API не требует изменения устройства. Устройство по-прежнему использует свой проприетарный двоичный протокол. Биометрический шлюз стоит между вашими устройствами и приложением, внутри себя выполняя всю трансляцию протокола. Его Protocol Engine управляет безопасной обработкой аутентификации, журналированием транзакций данных, трансляцией протокола, а также кэшем и очередью в офлайн-режиме на случай временной недоступности устройств. Его Standardised API Layer обеспечивает управление идентификацией, интеграцию с ИИ и MCP, диспетчеризацию callback-вызовов, маршрутизацию REST-команд и нормализацию данных для всех поддерживаемых брендов устройств.

Что меняется для вашей команды разработки

Когда SDK заменяется API, практические изменения в рабочем процессе разработки становятся значительными. Это не постепенные улучшения. Это устранение целых категорий трудностей, к которым ваша команда уже привыкла.

Задача разработки С SDK для Windows С API
Настройка окружения нового разработчика Часы или дни: ВМ с Windows + установка SDK + лицензия + зависимости среды выполнения Минуты: добавить базовый URL API и токен аутентификации в переменные окружения
Локальная разработка и тестирование Требуется удалённый доступ к машине с Windows, где установлен SDK Работает на любом ноутбуке, в любой ОС, с любым HTTP-клиентом
Интеграция в конвейер CI/CD Невозможно на стандартных агентах Linux Стандартные HTTP-вызовы, работает в любой среде CI
Контейнеризованное развёртывание Требуется контейнер Windows или выделенная ВМ Любой контейнер Linux любого размера, полная возможность оркестрации
Добавление второго бренда устройств Новый SDK, новая DLL, новая обёртка, новая документация Тот же набор Callback и RESTful API независимо от бренда
Отладка неудачной операции Журналы двоичного протокола, часто не документированы Стандартные HTTP-коды ответов и тела ошибок в JSON
Влияние обновления ОС или среды выполнения Может нарушить совместимость с SDK, требуется обновление от поставщика Нет влияния на клиентский код

Два типа API: что на самом деле пишет ваш разработчик

Чтобы сделать различие наглядным, вот как работают два типа API на практике. RESTful API вызывается вашим сервером для отправки команды на устройство. Callback API работает наоборот: шлюз вызывает ваш сервер, чтобы передать событие в реальном времени. Ваш разработчик пишет получатель для одного и инициатор вызовов для другого. Оба используют JSON поверх HTTP/HTTPS. Ни один не требует DLL, машины с Windows или установки какого-либо SDK.

Callback API, запрос, отправляется вашему серверу шлюзом
{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}
Callback API, ответ, ваш сервер должен вернуть его шлюзу
{ "status": "done" }

Вызов API выполняется с помощью любой HTTP-библиотеки на любом языке: requests в Python, fetch в Node, net/http в Go, cURL в shell-скрипте. Он работает одинаково на ноутбуке Mac, на Linux-раннере CI, в контейнере Docker в Kubernetes и в serverless-функции. Полезная нагрузка Callback API поступает на тот webhook-эндпоинт, который открыт вашим сервером, в одном и том же формате JSON независимо от того, какой бренд устройства или тип ввода сгенерировал событие. Отпечаток пальца, распознавание лица, вены ладони, RFID-карта, PIN, QR-код или штрихкод: структура, которую получает ваш сервер, всегда одна и та же. Никакой DLL. Никакой зависимости от среды выполнения. Никакого требования Windows. Никакого файла лицензии для управления.

Что это означает именно для вашей команды

Разработчик, который придёт в вашу команду на следующей неделе, может клонировать репозиторий, добавить учётные данные шлюза в файл окружения и выполнить первый успешный вызов к биометрическому устройству в течение нескольких минут после начала работы. Для RESTful API он пишет стандартный HTTP POST. Для Callback API он пишет стандартный HTTP-приёмник. Ни одному из них не нужна машина с Windows, установщик SDK, лицензионный ключ поставщика или знание двоичных протоколов устройств. Они интегрируются с шлюзом точно так же, как с любым другим JSON-сервисом в вашем стеке.

Часто задаваемые вопросы

Означает ли замена SDK на API потерю какой-либо функциональности устройства?
Cams Biometrics Gateway предоставляет 38 биометрических операций для обоих типов API. RESTful API обрабатывает команды, которые ваш сервер отправляет на устройство, например добавление пользователей, удаление записей, загрузку журналов и регистрацию биометрических данных. Callback API передаёт события в реальном времени от устройства на ваш сервер, включая отметки посещаемости с отпечатка пальца, распознавания лица, вен ладони, RFID-карт, PIN-кодов, QR-кодов и штрихкодов. В большинстве случаев Gateway предоставляет больше возможностей, чем конкретная версия SDK производителя, потому что работает напрямую с протоколом устройства. Перед миграцией проверьте совместимость для вашей конкретной модели устройства с командой поддержки Cams.
Мы уже создали значительную обёртку вокруг SDK. Сколько из неё придётся выбросить?
Бизнес-логика в вашей обёртке — правила о том, какие уровни доступа получают сотрудники, сопоставление идентификаторов HRMS с идентификаторами пользователей устройств, обработка ошибок и логика повторных попыток — всё это можно использовать повторно. Заменяется слой, который вызывает функции DLL. Вместо вызова функций SDK вы выполняете HTTP-запросы. Логика над этим слоем остаётся прежней. В большинстве случаев замена SDK — меньшее изменение, чем кажется со стороны.
Надёжнее ли API, чем прямое подключение через SDK?
Не по своей сути. Gateway поддерживает постоянное соединение с устройством и включает кэш и очередь для офлайн-режима, которые буферизуют операции, когда устройство временно недоступно. События не теряются при перебоях связи и доставляются на ваш Callback-эндпоинт после восстановления соединения. Надёжность соединения с устройством определяется инфраструктурой Gateway, а не тем, обращается ли ваше приложение к нему через HTTP или через вызовы DLL. Хорошо управляемый шлюз обеспечивает более высокую доступность, чем большинство команд достигает при самостоятельной установке SDK на одной виртуальной машине с Windows.
Что насчёт задержки? Добавляет ли дополнительный сетевой переход значимую задержку?
Для большинства биометрических операций дополнительный сетевой переход добавляет однозначное количество миллисекунд. Callback-события в отметках посещаемости доставляются в реальном времени, когда шлюз передаёт их на ваш webhook-эндпоинт, поэтому модель задержки похожа на прямое получение события через SDK. Для операций записи, например добавления пользователя, общее время кругового пути определяется собственным временем обработки устройства, составляющим от 1 до 3 секунд независимо от того, как поступила инструкция. HTTP-переход не является узким местом.
Можем ли мы использовать API из нашего существующего бэкенда на Python или Node.js без какой-либо специальной клиентской библиотеки?
Да. API использует стандартный HTTP с телами в формате JSON. Любая HTTP-клиентская библиотека на любом языке работает без изменений. Вам не нужен специальный SDK, клиентская библиотека, опубликованная поставщиком шлюза, или какой-либо пакет для конкретного языка. Если вы можете выполнить HTTP POST-запрос с телом JSON, вы можете вызывать API. С точки зрения вашего приложения это вся поверхность интеграции.

Заключение: у проблемы SDK есть простое решение

SDK для биометрии, работающий только в Windows, — не данность, с которой ваша инженерная команда должна бороться вечно. Это следствие решения о распространении, принятого два десятилетия назад в другой инфраструктурной среде. Это решение может быть заменено шлюзом, который берёт на себя сложность двоичного протокола и предоставляет устройство через стандартный API.

Когда этот переход произойдёт, выделенную виртуальную машину с Windows выведут из эксплуатации. Конвейер CI/CD снова получит возможность тестировать интеграцию с биометрией. Новый разработчик настроит локальное окружение за несколько минут. Контейнер Docker запустится без специальной конфигурации. Разработчики на Mac перестанут подключаться удалённо к единственной машине в офисе, на которой установлена лицензия SDK. Это не незначительные улучшения удобства. Это устранение структурного ограничения, которое на протяжении многих лет отнимало время и терпение вашей инженерной команды.

Cams Biometrics Gateway полностью заменяет SDK для Windows. Он подключается к вашим биометрическим устройствам Cams, ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime, Biomax, Secugen, eSSL, Matrix и другим, используя их собственные протоколы, без установки SDK где-либо в вашей инфраструктуре. Он предоставляет 38 операций через два типа API: Callback API, который передаёт события устройств в реальном времени на ваш сервер с нулевой задержкой, и RESTful API, который принимает команды с вашего сервера на устройство. Вся связь выполняется через JSON поверх HTTP/HTTPS с опциональным шифрованием AES-256. Встроенная интеграция MCP означает, что Claude, Gemini и ChatGPT могут напрямую вызывать биометрические операции. Кэш и очередь для офлайн-режима автоматически обрабатывают перебои связи. Gateway работает одинаково, независимо от того, работает ли ваш стек на Linux, Mac, Windows, Docker, Kubernetes или serverless-функциях. Никакой DLL. Никакого Visual C++ Redistributable. Никакой выделенной машины с Windows. Никакого файла лицензии. Изучите полный API на CamsBiometrics.com или узнайте о миграции существующей интеграции с SDK.

 

Was this article helpful?