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, який виробник розповсюджує для взаємодії з ним, є скомпільованою DLL для Windows, потребує конкретного середовища виконання Visual C++, не працює в контейнері Docker, а ваші розробники користуються Mac або Linux. Проблема не в пристрої. Проблема в SDK. Ця стаття пояснює, чому так відбувається, чому кожне обхідне рішення, яке пробувала ваша команда, зрештою виявляється невдалим, і як виглядає архітектурна альтернатива.

 

Скарги є однаковими в усіх інженерних командах

Деталі різняться, але закономірність завжди та сама. Організація інтегрує біометричне обладнання, пізно виявляє обмеження SDK і витрачає значний інженерний час на обхід проблеми, якої не мало б бути. Ось як ці скарги звучать на практиці.

Що кажуть інженерні команди, щоразу
“SDK поставляється лише як Windows DLL. Уся наша backend-частина працює на 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 залишився DLL для Windows, оскільки його переписування для крос-платформенного розповсюдження потребує інженерних інвестицій, які виробник обладнання має мало комерційних стимулів робити.

“SDK не був розроблений як ворожий до Linux або Mac. Він створювався для світу, в якому Linux і Mac не були там, де працювало корпоративне програмне забезпечення. Цього світу більше не існує. SDK залишився позаду.”

Що SDK лише для Windows блокує в сучасному стеку

Наслідки SDK лише для Windows поширюються на кожен рівень сучасного середовища розробки та розгортання. Кожне з наведених нижче обмежень є реальним бар'єром, з яким стикаються інженерні команди, коли намагаються інтегрувати біометричне обладнання в актуальний програмний стек.

Docker і контейнеризація
Контейнери Docker працюють на Linux. DLL для Windows неможливо завантажити всередині контейнера 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. Серверлесс-архітектура для біометричної інтеграції неможлива з DLL для Windows. Усю функцію потрібно замінити на довготривалий процес 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 Subsystem for Linux
WSL2 дозволяє процесам Linux працювати на Windows і навпаки. Деякі команди встановлюють SDK на машину Windows і надають до нього доступ через міст WSL2. Це інструмент для зручності розробників, який використовується як підхід до інтеграції у продуктивному середовищі. Він не призначений для продуктивних навантажень і спричиняє нестабільність на межі WSL за тривалого навантаження.
Виходить з ладу, коли оновлення WSL ламають міст або навантаження спричиняє нестабільність на рівні межі.
05
Python ctypes або cffi
Бібліотека ctypes у Python дозволяє викликати C-функції зі скомпільованої DLL безпосередньо з коду Python. Це може працювати в Windows для простих інтерфейсів DLL. Це потребує ручного управління пам'яттю, ретельного відображення типів і глибокого знання угод про виклики DLL. Такий підхід крихкий, у більшості випадків не задокументований і повністю непортабельний на будь-яку платформу, відмінну від Windows.
Виходить з ладу, коли інтерфейс DLL змінюється в оновленні, а це відбудеться без жодних гарантій версіонування.
Спільна закономірність усіх обхідних рішень

Кожне обхідне рішення приймає DLL для Windows як фіксоване обмеження і будує навколо нього. Жодне з них не усуває обмеження. Усі вони додають складності, збільшують площу обслуговування і створюють нові режими відмов. Правильне рішення полягає не в тому, щоб створити кращий обхідний шлях. Його суть — повністю усунути залежність від DLL.

Як виглядає альтернативна архітектура

DLL для Windows існує тому, що виробнику пристрою потрібно було дати розробникам спосіб взаємодії із пропрietарним бінарним протоколом пристрою, не розкриваючи сам протокол. DLL є рівнем абстракції між бінарним форматом передачі та кодом розробника.

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

Підхід через SDK

DLL для Windows встановлюється на конкретну машину. Викликається за допомогою FFI або обгортки конкретної мови. Прив'язаний до операційної системи та версії середовища виконання. Не можна контейнеризувати. Не можна тестувати в CI. Ламається під час оновлень ОС. Один SDK на кожен бренд пристроїв.

Підхід через Biometric Gateway

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

Жоден тип API не вимагає змін на самому пристрої. Пристрій і далі використовує свій пропрietарний бінарний протокол. Biometric Gateway знаходиться між вашими пристроями та вашим застосунком і внутрішньо обробляє всі перетворення протоколу. Його Protocol Engine керує безпечною автентифікацією, журналюванням транзакцій даних, перетворенням протоколу, а також офлайн-кешем і чергою на випадок тимчасової недоступності пристроїв. Його стандартизований рівень API забезпечує керування ідентифікацією, інтеграцію з AI та 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 працює у зворотному напрямку: Gateway викликає ваш сервер, щоб передати подію в реальному часі. Ваш розробник пише отримувач для одного і відправника для іншого. Обидва використовують JSON через HTTP/HTTPS. Жоден не потребує DLL, машини Windows або встановлення SDK.

Callback API, запит, надсилається Gateway на ваш сервер
{
  "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, відповідь, ваш сервер має повернути її Gateway
{ "status": "done" }

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

Що це означає саме для вашої команди

Розробник, який приєднається до вашої команди наступного тижня, може клонувати репозиторій, додати облікові дані Gateway до файлу середовища і зробити перший успішний виклик до біометричного пристрою протягом кількох хвилин після початку роботи. Для RESTful API він пише стандартний HTTP POST. Для Callback API він пише стандартний HTTP-отримувач. Жоден з них не потребує машини Windows, інсталятора SDK, ліцензійного ключа постачальника або знання бінарних протоколів пристроїв. Вони інтегруються з Gateway так само, як інтегрують будь-який інший 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-endpoint після відновлення з'єднання. Надійність з'єднання з пристроєм визначається інфраструктурою Gateway, а не тим, чи ваш застосунок взаємодіє з ним через HTTP чи через виклики DLL. Добре керований gateway матиме вищу доступність, ніж більшість команд досягають із самостійно керованою інсталяцією SDK на одній ВМ Windows.
А як щодо затримки? Чи додає зайвий мережевий перехід суттєву затримку?
Для більшості біометричних операцій додатковий мережевий перехід додає одноцифрові мілісекунди. Callback-події відвідуваності доставляються в реальному часі, коли gateway надсилає їх на ваш webhook-endpoint, тому модель затримки схожа на пряме з'єднання через SDK, що отримує подію. Для операцій запису, таких як додавання користувача, загальний час обходу визначається власним часом обробки пристрою, який становить від 1 до 3 секунд незалежно від того, як надійшла інструкція. HTTP-перехід не є вузьким місцем.
Чи можемо ми використовувати API з нашого наявного backend на Python або Node.js без спеціальної клієнтської бібліотеки?
Так. API використовує стандартний HTTP з тілами JSON. Будь-яка HTTP-клієнтська бібліотека будь-якою мовою працює без змін. Вам не потрібен спеціальний SDK, клієнтська бібліотека, опублікована постачальником gateway, або будь-який пакет для конкретної мови. Якщо ви можете виконати HTTP POST-запит з тілом JSON, ви можете викликати API. Це вся поверхня інтеграції з точки зору вашого застосунку.

Висновок: проблема SDK має чистe рішення

Біометричний SDK, що працює лише у Windows, не є фактом життя, з яким ваша інженерна команда має вічно обходити обмеження. Це наслідок рішення щодо розповсюдження, ухваленого два десятиліття тому в іншому інфраструктурному ландшафті. Це рішення можна замінити gateway, який поглинає складність бінарного протоколу і надає доступ до пристрою через стандартний 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?