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++ runtime مشخص نیاز دارد، در یک Docker container اجرا نمی‌شود و توسعه‌دهندگان شما روی Mac یا Linux کار می‌کنند. مشکل از دستگاه نیست. مشکل از SDK است. این مقاله توضیح می‌دهد که دقیقاً چرا این اتفاق می‌افتد، چرا هر راه‌حل موقتی که تیم شما امتحان کرده در نهایت شکست می‌خورد، و جایگزین معماری چگونه است.

 

شکایت‌ها در همه‌ی تیم‌های مهندسی یکسان است

جزئیات متفاوت است، اما الگو همیشه یکسان است. یک سازمان سخت‌افزار بایومتریک را یکپارچه می‌کند، محدودیت‌های SDK را دیر متوجه می‌شود و زمان مهندسی قابل توجهی را صرف دور زدن مشکلی می‌کند که نباید وجود داشته باشد. در عمل، این شکایت‌ها به این شکل شنیده می‌شوند.

تیم‌های مهندسی هر بار این را می‌گویند
“SDK فقط به صورت Windows DLL ارائه می‌شود. کل backend ما روی Linux اجرا می‌شود. مجبور شدیم فقط برای اجرای یکپارچه‌سازی بایومتریک یک Windows VM اختصاصی راه‌اندازی کنیم.”
“نمی‌توانیم آن را در container قرار دهیم. Docker کنار گذاشته شده است. Kubernetes هم کنار گذاشته شده است. هر استقرار یک فرایند دستی روی دستگاهی است که بدون نصب مجدد SDK و دریافت لایسنس جدید نمی‌توان آن را جایگزین کرد.”
“همه‌ی توسعه‌دهندگان شما روی Mac یا Linux کار می‌کنند. هیچ‌کس نمی‌تواند یکپارچه‌سازی را به صورت محلی اجرا کند. برای تست باید به تنها دستگاه Windows دفتر که SDK روی آن نصب است متصل شد.”
“SDK به Visual C++ Redistributable 2010 نیاز دارد. توسعه‌دهنده‌ی جدید سه روز صرف آماده‌سازی محیط کرد، قبل از اینکه حتی یک خط کد یکپارچه‌سازی بنویسد.”
“سرور را به Windows Server 2022 به‌روزرسانی کردیم و SDK از کار افتاد. فروشنده دو هفته برای انتشار نسخه‌ی به‌روز زمان برد و در این مدت هیچ داده‌ی حضور و غیابی نداشتیم.”
“پایplan CI/CD ما اصلاً نمی‌تواند یکپارچه‌سازی بایومتریک را تست کند. هر تست دستی است. برای هر انتشار این یکپارچه‌سازی، باید کسی به‌طور فیزیکی پشت دستگاه Windows بنشیند و آن را اجرا کند.”

چرا SDKهای بایومتریک فقط روی Windows هستند: دلیل واقعی

این وسوسه وجود دارد که فکر کنیم ارتباط سخت‌افزار بایومتریک آن‌قدر پیچیده است که به APIهای سیستمی مخصوص Windows نیاز دارد. این درست نیست. دلیل واقعی اینکه SDKهای بایومتریک فقط روی Windows هستند ساده‌تر و آزاردهنده‌تر است: این محیطی است که SDK در ابتدا برای آن نوشته شده، و از آن زمان تاکنون کسی برای تغییر آن سرمایه‌گذاری نکرده است.

بیشتر SDKهای دستگاه‌های بایومتریک در اوایل دهه‌ی ۲۰۰۰ با C یا C++ نوشته شده‌اند و Windows را به عنوان سیستم‌عامل غالب دسکتاپ سازمانی آن دوران هدف قرار داده‌اند. خروجی کامپایل‌شده یک DLL بود، یعنی Dynamic Link Library، که یک فرمت باینری مخصوص Windows است. منطق ارتباط، یعنی توابعی که یک اتصال TCP به دستگاه باز می‌کنند، بسته‌ی باینری را رمزگشایی می‌کنند و داده‌ی ساختاریافته برمی‌گردانند، در این DLL کامپایل شد و به مشتریان توزیع شد.

در آن زمان، این تصمیم منطقی بود. نرم‌افزار سازمانی روی Windows اجرا می‌شد. سرورها Windows داشتند. توسعه‌دهندگان از Windows استفاده می‌کردند. فرمت DLL روش استاندارد توزیع کد کامپایل‌شده‌ی قابل استفاده مجدد در آن اکوسیستم بود. با توجه به شرایط آن زمان، هیچ‌چیز در این انتخاب اشتباه نبود.

مشکل این است که زمینه‌ی کار کاملاً تغییر کرد، اما SDK تغییر نکرد. Linux به سیستم‌عامل غالب سرورها تبدیل شد. Mac به workstation غالب توسعه‌دهندگان تبدیل شد. Docker containerها به واحد استاندارد استقرار تبدیل شدند. زیرساخت‌های cloud-native جای سرورهای Windows محلی را گرفتند. اما SDK بیومتریک همچنان یک Windows DLL باقی ماند، چون بازنویسی آن برای توزیع چندسکویی به سرمایه‌گذاری مهندسی نیاز دارد که سازنده‌ی سخت‌افزار انگیزه‌ی تجاری کمی برای انجام آن دارد.

“SDK برای خصمانه بودن با Linux یا Mac طراحی نشده بود. برای دنیایی طراحی شده بود که Linux و Mac جایی برای اجرای نرم‌افزار سازمانی نبودند. آن دنیا دیگر وجود ندارد. SDK در گذشته باقی ماند.”

SDK فقط روی Windows در یک stack مدرن چه چیزهایی را مسدود می‌کند

پیامدهای SDK فقط روی Windows در هر لایه‌ی یک محیط توسعه و استقرار مدرن گسترش می‌یابد. هر مانع زیر نشان‌دهنده‌ی یک محدودیت واقعی است که تیم‌های مهندسی هنگام تلاش برای یکپارچه‌سازی سخت‌افزار بایومتریک در یک stack نرم‌افزاری نسل فعلی با آن روبه‌رو می‌شوند.

Docker و کانتینری‌سازی
Docker containerها روی Linux اجرا می‌شوند. یک Windows DLL را نمی‌توان داخل یک Linux container بارگذاری کرد. هر سرویسی که نیاز به فراخوانی SDK دارد باید روی یک ماشین Windows یا یک Windows container اجرا شود، که نسبت به یک Linux container استاندارد سنگین‌تر، کم‌قابل‌حمل‌تر و اجرای آن گران‌تر است.
سرورهای ابری Linux
AWS، Google Cloud و Azure همگی ماشین‌های مجازی Linux را به عنوان گزینه‌ی استاندارد و ارزان‌تر سرور ارائه می‌دهند. اجرای یک Windows VM فقط برای میزبانی یکپارچه‌سازی SDK بایومتریک هزینه‌ی بیشتری دارد و سربار عملیاتی اضافه می‌کند که ربطی به خود عملکرد بایومتریک ندارد.
محیط‌های توسعه‌ی Mac
توسعه‌دهندگان نمی‌توانند SDK را روی ماشین‌های محلی خود بارگذاری، اجرا یا تست کنند. هر تست یکپارچه‌سازی نیازمند دسترسی به تنها ماشین Windows است که SDK روی آن نصب شده. حلقه‌های بازخورد توسعه‌ی محلی، که یک نیاز اساسی برای مهندسی بهره‌ور است، برای این بخش از stack حذف می‌شوند.
پایplanهای CI/CD
پایplanهای تست خودکار روی agentهای Linux اجرا می‌شوند. تست‌های واحد، تست‌های یکپارچگی و بررسی‌های استقرار خودکار نمی‌توانند هیچ مسیر کدی را که SDK را فراخوانی می‌کند شامل شوند. یکپارچه‌سازی بایومتریک کاملاً خارج از فرایند خودکار تضمین کیفیت قرار دارد.
توابع Serverless
AWS Lambda، Google Cloud Functions و Azure Functions روی runtimeهای مدیریت‌شده‌ی Linux اجرا می‌شوند. یک معماری serverless برای یکپارچه‌سازی بایومتریک با یک Windows DLL غیرممکن است. کل تابع باید با یک فرایند Windows طولانی‌مدت جایگزین شود، که مدل هزینه و عملیات serverless را از بین می‌برد.
ارکستراسیون Kubernetes
Kubernetes containerها را در خوشه‌ها مدیریت می‌کند. سرویسی که به یک SDK ویندوزی وابسته است، بدون node pool های Windows نمی‌تواند در ارکستراسیون استاندارد Kubernetes شرکت کند. پیکربندی و اجرای node pool های Windows به مراتب پیچیده‌تر و گران‌تر از node pool های استاندارد Linux است.

راه‌حل‌های موقتی که تیم‌ها می‌سازند و چرا همه در نهایت شکست می‌خورند

در مواجهه با یک SDK فقط روی Windows و یک stack مدرن، تیم‌های مهندسی راه‌حل‌های موقتی می‌سازند. هر راه‌حل موقتی مشکل فوری را حل می‌کند، اما یک وابستگی ساختاری جدید ایجاد می‌کند که بعداً مشکل متفاوتی به وجود می‌آورد.

01
Windows VM اختصاصی
یک ماشین مجازی Windows مخصوص اجرای SDK راه‌اندازی می‌شود. سرویس یکپارچه‌سازی بایومتریک روی این VM اجرا می‌شود و یک API داخلی ارائه می‌دهد که بقیه‌ی stack آن را فراخوانی می‌کنند. این یک نقطه‌ی شکست واحد دائمی ایجاد می‌کند که در صورت از کار افتادن نمی‌تواند خودکار جایگزین شود، نمی‌تواند به صورت افقی مقیاس‌پذیر باشد و باید به عنوان یک مسئولیت زیرساختی جداگانه وصله و نگهداری شود.
شکست می‌خورد وقتی: VM از سرویس خارج شود، وصله شود یا منتقل شود و SDK از کار بیفتد.
02
wrapper تعاملی COM
یک wrapper نازک با C# نوشته می‌شود که DLL را بارگذاری کرده و آن را به صورت یک شیء COM یا یک سرویس HTTP محلی در دسترس سایر فرایندها قرار می‌دهد. این کار یک مرز زبان، یک مرز فرایند و یک codebase جدید اضافه می‌کند که باید نگهداری شود. توسعه‌دهنده‌ای که آن را نوشته معمولاً تنها کسی است که آن را می‌فهمد و در نهایت تیم را ترک می‌کند.
شکست می‌خورد وقتی: SDK به‌روزرسانی شود و wrapper از کار بیفتد، یا توسعه‌دهنده‌ی اصلی تیم را ترک کند.
03
Wine روی Linux
Wine یک لایه‌ی سازگاری است که به برخی باینری‌های Windows اجازه می‌دهد روی Linux اجرا شوند. برخی تیم‌ها تلاش می‌کنند DLL مربوط به SDK بایومتریک را زیر Wine اجرا کنند. این روش برای SDKهای ساده به صورت متناوب کار می‌کند و برای SDKهای پیچیده که به system call های مخصوص Windows وابسته‌اند، به شکل غیرقابل پیش‌بینی شکست می‌خورد. پشتیبانی فروشنده‌ی SDK برای استقرارهای مبتنی بر Wine وجود ندارد.
شکست می‌خورد وقتی: SDK یک Windows API را فراخوانی کند که Wine آن را پیاده‌سازی نکرده است، که امری رایج است.
04
Windows Subsystem for Linux
WSL2 اجازه می‌دهد فرایندهای Linux روی Windows و برعکس اجرا شوند. برخی تیم‌ها SDK را روی یک ماشین Windows نصب می‌کنند و آن را از طریق یک پل WSL2 در دسترس قرار می‌دهند. این یک ابزار راحتی توسعه‌دهنده است که به عنوان یک روش یکپارچه‌سازی تولیدی به کار گرفته شده است. برای بارهای کاری تولیدی طراحی نشده و تحت بار مداوم در مرز WSL ناپایداری ایجاد می‌کند.
شکست می‌خورد وقتی: به‌روزرسانی‌های WSL پل را خراب کنند یا بار کاری باعث ناپایداری در لایه‌ی مرزی شود.
05
Python ctypes یا cffi
کتابخانه‌ی ctypes پایتون امکان فراخوانی توابع C از یک DLL کامپایل‌شده را مستقیماً از کد Python فراهم می‌کند. این روش برای رابط‌های ساده‌ی DLL روی Windows می‌تواند کار کند. نیازمند مدیریت دستی حافظه، نگاشت دقیق نوع‌ها و دانش عمیق از قراردادهای فراخوانی DLL است. این روش شکننده است، در بیشتر موارد مستند نشده و به‌طور کامل با هیچ پلتفرم غیر Windows سازگار نیست.
شکست می‌خورد وقتی: رابط DLL در یک به‌روزرسانی تغییر کند، که بدون هیچ تضمین نسخه‌بندی این اتفاق خواهد افتاد.
الگوی مشترک همه‌ی راه‌حل‌های موقتی

هر راه‌حل موقتی، Windows DLL را به عنوان یک محدودیت ثابت می‌پذیرد و دور آن می‌سازد. هیچ‌کدام این محدودیت را از بین نمی‌برد. همه‌ی آن‌ها پیچیدگی اضافه می‌کنند، سطح نگهداری را افزایش می‌دهند و حالت‌های شکست جدید ایجاد می‌کنند. راه‌حل درست ساختن یک راه‌حل موقتی بهتر نیست. بلکه حذف کامل وابستگی به DLL است.

معماری جایگزین چگونه است

Windows DLL وجود دارد زیرا سازنده‌ی دستگاه باید راهی به توسعه‌دهندگان می‌داد تا بدون افشای خود پروتکل، با پروتکل باینری اختصاصی دستگاه ارتباط برقرار کنند. DLL لایه‌ی انتزاعی بین فرمت باینری سیم و کد توسعه‌دهنده است.

این لایه‌ی انتزاعی لزوماً نباید یک DLL باشد. می‌تواند یک سرور HTTP باشد که با JSON صحبت می‌کند. این سرور در یک طرف پروتکل باینری را مدیریت می‌کند و در طرف دیگر یک API در دسترس قرار می‌دهد. توسعه‌دهندگان API را با کتابخانه‌های استاندارد کلاینت HTTP فراخوانی می‌کنند که روی هر پلتفرم، در هر زبان، داخل هر container، از طریق هر پایplan CI/CD و روی هر لپ‌تاپ توسعه‌دهنده، صرف‌نظر از سیستم‌عامل، اجرا می‌شوند.

رویکرد SDK

Windows DLL روی یک ماشین مشخص نصب می‌شود. با FFI یا wrapper مخصوص زبان فراخوانی می‌شود. به سیستم‌عامل و نسخه‌ی runtime وابسته است. نمی‌توان آن را containerized کرد. نمی‌توان آن را در CI تست کرد. با به‌روزرسانی سیستم‌عامل از کار می‌افتد. برای هر برند دستگاه یک SDK لازم است.

رویکرد Biometric Gateway

دو نوع API که هر کدام کار متفاوتی انجام می‌دهند. Callback API رویدادهای لحظه‌ای را با تأخیر صفر از دستگاه به سرور شما ارسال می‌کند. RESTful API دستورات را از سرور شما به دستگاه با زمان اجرای تقریبی ۱۵ ثانیه می‌پذیرد. هر دو با JSON روی HTTP/HTTPS و با رمزگذاری اختیاری AES-256 کار می‌کنند. هر زبان، هر سیستم‌عامل، کاملاً قابل containerized شدن و قابل تست در هر محیط CI.

هیچ‌کدام از دو نوع API نیازی به تغییر دستگاه ندارند. دستگاه همچنان با پروتکل باینری اختصاصی خود کار می‌کند. Biometric Gateway بین دستگاه‌ها و برنامه‌ی شما قرار می‌گیرد و تمام ترجمه‌ی پروتکل را داخلی انجام می‌دهد. Protocol Engine آن پردازش احراز هویت امن، ثبت تراکنش داده، ترجمه‌ی پروتکل و کش و صف آفلاین را برای زمانی که دستگاه‌ها موقتاً در دسترس نیستند مدیریت می‌کند. Standardised API Layer آن مدیریت هویت، یکپارچه‌سازی AI و MCP، ارسال callback، مسیریابی دستورات REST و نرمال‌سازی داده را بین تمام برندهای پشتیبانی‌شده‌ی دستگاه انجام می‌دهد.

آنچه برای تیم توسعه‌ی شما تغییر می‌کند

وقتی SDK با یک API جایگزین شود، تغییرات عملی در گردش کار توسعه‌ی شما قابل توجه است. این‌ها بهبودهای جزئی نیستند. حذف کامل دسته‌هایی از اصطکاک است که تیم شما به آن عادت کرده است.

وظیفه‌ی توسعه با SDK ویندوزی با API
راه‌اندازی محیط توسعه‌ی جدید ساعت‌ها تا روزها، Windows VM + نصب SDK + لایسنس + وابستگی‌های runtime دقایقی، افزودن آدرس پایه‌ی API و توکن احراز هویت به متغیرهای محیطی
توسعه و تست محلی نیازمند دسترسی از راه دور به ماشین Windows دارای SDK روی هر لپ‌تاپ، هر سیستم‌عامل و با هر ابزار کلاینت HTTP کار می‌کند
یکپارچه‌سازی پایplan CI/CD روی agentهای استاندارد Linux ممکن نیست فراخوانی‌های استاندارد HTTP، در هر محیط CI کار می‌کند
استقرار containerized نیازمند Windows container یا VM اختصاصی هر Linux container با هر اندازه، کاملاً قابل ارکستراسیون
افزودن برند دوم دستگاه SDK جدید، DLL جدید، wrapper جدید، مستندات جدید همان مجموعه‌ی Callback و RESTful API بدون توجه به برند
اشکال‌زدایی یک عملیات ناموفق لاگ‌های پروتکل باینری، که اغلب مستند نشده‌اند کدهای استاندارد پاسخ HTTP و بدنه‌های خطای JSON
تأثیر به‌روزرسانی سیستم‌عامل یا runtime ممکن است سازگاری SDK را از بین ببرد و نیازمند به‌روزرسانی فروشنده باشد بدون تأثیر بر کد کلاینت

دو نوع API: توسعه‌دهنده‌ی شما در عمل چه می‌نویسد

برای روشن شدن تفاوت، در اینجا نحوه‌ی کارکرد دو نوع API در عمل آمده است. RESTful API توسط سرور شما برای ارسال دستور به دستگاه فراخوانی می‌شود. Callback API برعکس است: Gateway سرور شما را فراخوانی می‌کند تا یک رویداد لحظه‌ای را ارسال کند. توسعه‌دهنده‌ی شما برای یکی یک receiver و برای دیگری یک caller می‌نویسد. هر دو از 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، یک CI runner روی Linux، یک Docker container روی Kubernetes و یک تابع serverless دقیقاً یکسان کار می‌کند. payload مربوط به Callback API به هر endpoint وب‌هوکی که سرور شما در اختیار می‌گذارد می‌رسد، با همان فرمت JSON، بدون توجه به اینکه کدام برند دستگاه یا نوع ورودی رویداد را ایجاد کرده است. اثرانگشت، تشخیص چهره، رگ کف دست، کارت RFID، PIN، کد QR یا بارکد: ساختاری که سرور شما دریافت می‌کند همیشه یکسان است. بدون DLL. بدون وابستگی runtime. بدون نیاز به Windows. بدون فایل لایسنس برای مدیریت.

این موضوع برای تیم شما به طور خاص چه معنایی دارد

توسعه‌دهنده‌ای که هفته‌ی آینده به تیم شما می‌پیوندد می‌تواند مخزن را clone کند، اطلاعات احراز هویت Gateway را به فایل محیطی خود اضافه کند و در عرض چند دقیقه پس از نشستن پشت میز، اولین فراخوانی موفق خود به یک دستگاه بایومتریک را انجام دهد. برای RESTful API یک HTTP POST استاندارد می‌نویسد. برای Callback API یک HTTP receiver استاندارد می‌نویسد. هیچ‌کدام به ماشین Windows، نصب‌کننده‌ی SDK، کلید لایسنس فروشنده یا دانش از پروتکل‌های باینری دستگاه نیاز ندارند. آن‌ها دقیقاً همان‌طور با Gateway یکپارچه می‌شوند که با هر سرویس JSON دیگر در stack شما یکپارچه می‌شوند.

پرسش‌های متداول

آیا جایگزینی SDK با یک API به معنای از دست رفتن هر یک از قابلیت‌های دستگاه است؟
Cams Biometrics Gateway در مجموع دو نوع API، ۳۸ عملیات بایومتریک را در معرض قرار می‌دهد. RESTful API دستوراتی را که سرور شما به دستگاه ارسال می‌کند مدیریت می‌کند، مانند افزودن کاربران، حذف رکوردها، بارگذاری لاگ‌ها و ثبت‌نام بایومتریک. Callback API رویدادهای لحظه‌ای را از دستگاه به سرور شما تحویل می‌دهد، از جمله ثبت‌های حضور و غیاب از ورودی‌های اثرانگشت، تشخیص چهره، رگ کف دست، کارت RFID، PIN، کد QR و بارکد. در بیشتر موارد Gateway قابلیت بیشتری نسبت به نسخه‌ی SDK یک سازنده‌ی مشخص ارائه می‌دهد، زیرا مستقیماً با پروتکل دستگاه کار می‌کند. قبل از مهاجرت، سازگاری آن را برای مدل دستگاه خاص خود با تیم پشتیبانی Cams بررسی کنید.
ما قبلاً یک wrapper قابل توجه دور SDK ساخته‌ایم. چقدر از آن را باید دور بریزیم؟
منطق کسب‌وکار در wrapper شما، قوانین مربوط به اینکه کدام کارمندان به کدام سطوح دسترسی دارند، نگاشت بین شناسه‌های HRMS شما و شناسه‌های کاربر دستگاه، مدیریت خطا و منطق تلاش مجدد، همه‌ی این موارد قابل استفاده‌ی مجدد هستند. آنچه جایگزین می‌شود لایه‌ای است که توابع DLL را فراخوانی می‌کند. به جای فراخوانی توابع SDK، درخواست‌های HTTP ارسال می‌کنید. منطق بالای آن لایه بدون تغییر باقی می‌ماند. در بیشتر موارد جایگزینی SDK تغییر کوچک‌تری از آنچه از بیرون به نظر می‌رسد خواهد بود.
آیا یک API کمتر از اتصال مستقیم SDK قابل اعتماد است؟
ذاتاً خیر. Gateway یک اتصال پایدار با دستگاه برقرار نگه می‌دارد و شامل یک کش و صف آفلاین است که عملیات را زمانی که دستگاه موقتاً در دسترس نیست ذخیره می‌کند. رویدادها در هنگام قطعی ارتباط از دست نمی‌روند و زمانی که اتصال برقرار شود به endpoint Callback شما تحویل داده می‌شوند. قابلیت اطمینان اتصال دستگاه به زیرساخت Gateway بستگی دارد، نه به اینکه برنامه‌ی شما از طریق HTTP یا فراخوانی DLL صحبت کند. یک gateway که به خوبی اداره شود، دسترس‌پذیری بالاتری از آنچه بیشتر تیم‌ها با یک نصب SDK خودمدیریت‌شده روی یک Windows VM واحد به دست می‌آورند، خواهد داشت.
درباره‌ی تأخیر چطور؟ آیا گام شبکه‌ی اضافی تأخیر قابل توجهی ایجاد می‌کند؟
برای بیشتر عملیات بایومتریک، گام شبکه‌ی اضافی تنها چند میلی‌ثانیه اضافه می‌کند. Callbackهای حضور و غیاب به صورت لحظه‌ای با ارسال gateway به endpoint وب‌هوک شما تحویل داده می‌شوند، بنابراین مدل تأخیر مشابه یک اتصال مستقیم SDK است که یک رویداد را دریافت می‌کند. برای عملیات نوشتن مانند افزودن کاربر، زمان کل رفت‌وبرگشت عمدتاً توسط زمان پردازش خود دستگاه تعیین می‌شود که بین ۱ تا ۳ ثانیه است، صرف‌نظر از اینکه دستور چگونه رسیده باشد. گام HTTP گلوگاه نیست.
آیا می‌توانیم بدون کتابخانه‌ی کلاینت خاص از API در بک‌اند موجود Python یا Node.js استفاده کنیم؟
بله. API از HTTP استاندارد با بدنه‌های JSON استفاده می‌کند. هر کتابخانه‌ی کلاینت HTTP در هر زبانی بدون تغییر کار می‌کند. به SDK خاص، کتابخانه‌ی کلاینت منتشرشده توسط فروشنده‌ی gateway، یا هیچ بسته‌ی مخصوص زبان نیازی ندارید. اگر بتوانید یک درخواست HTTP POST با بدنه‌ی JSON ارسال کنید، می‌توانید API را فراخوانی کنید. از دیدگاه برنامه‌ی شما، کل سطح یکپارچه‌سازی همین است.

نتیجه‌گیری: مشکل SDK راه‌حل روشنی دارد

SDK بیومتریک فقط روی Windows واقعیتی نیست که تیم مهندسی شما برای همیشه مجبور به دور زدن آن باشد. این نتیجه‌ی یک تصمیم توزیع است که دو دهه پیش در یک چشم‌انداز زیرساختی متفاوت گرفته شده است. آن تصمیم می‌تواند با یک gateway جایگزین شود که پیچیدگی پروتکل باینری را جذب می‌کند و دستگاه را از طریق یک API استاندارد در معرض قرار می‌دهد.

وقتی این انتقال انجام شود، Windows VM اختصاصی از سرویس خارج می‌شود. پایplan CI/CD یکپارچه‌سازی بایومتریک را دوباره به دست می‌آورد. توسعه‌دهنده‌ی جدید محیط محلی خود را در عرض چند دقیقه راه‌اندازی می‌کند. Docker container بدون پیکربندی خاص اجرا می‌شود. توسعه‌دهندگان Mac دیگر به تنها ماشین دفتر که لایسنس SDK روی آن نصب است متصل نمی‌شوند. این‌ها بهبودهای کوچک کیفیت زندگی نیستند. حذف یک محدودیت ساختاری هستند که سال‌ها زمان و صبر تیم مهندسی شما را گرفته است.

Cams Biometrics Gateway جایگزین کامل SDK ویندوزی می‌شود. این gateway به دستگاه‌های بایومتریک Cams، ZKTeco، Suprema، Hikvision، Anviz، Morpho/IDEMIA، Virdi، Mantra، Nitgen، Realtime، Biomax، Secugen، eSSL، Matrix و موارد دیگر را با استفاده از پروتکل‌های بومی آن‌ها متصل می‌کند، بدون اینکه در هیچ‌جای زیرساخت شما نیاز به نصب SDK باشد. این gateway ۳۸ عملیات را در دو نوع API در معرض قرار می‌دهد: یک Callback API که رویدادهای لحظه‌ای دستگاه را با تأخیر صفر به سرور شما ارسال می‌کند، و یک RESTful API که دستورات سرور شما را به دستگاه می‌پذیرد. تمام ارتباطات JSON روی HTTP/HTTPS با رمزگذاری اختیاری AES-256 است. یکپارچه‌سازی بومی MCP به این معناست که Claude، Gemini و ChatGPT می‌توانند عملیات بایومتریک را مستقیماً فراخوانی کنند. کش و صف آفلاین به‌طور خودکار قطعی‌های ارتباطی را مدیریت می‌کند. Gateway دقیقاً یکسان کار می‌کند، چه stack شما روی Linux، Mac، Windows، Docker، Kubernetes یا توابع serverless اجرا شود. بدون DLL. بدون Visual C++ Redistributable. بدون ماشین اختصاصی Windows. بدون فایل لایسنس. API کامل را در CamsBiometrics.com بررسی کنید و درباره‌ی مهاجرت یکپارچه‌سازی SDK موجود خود اطلاعات بیشتری به دست آورید.

 

Was this article helpful?