هر دستگاه بیومتریک از طریق یکی از دو حالت push به Cams Biometric Gateway متصل میشود. نوع دستگاه شما تعیین میکند از کدام حالت استفاده کنید.
Native Push دستگاههای Cams و تأییدشده
همه دستگاههای Cams Biometrics و دستگاههای تأییدشده در developer.camsbiometrics.com از طریق Native Push متصل میشوند. به راهاندازی اضافه نیازی نیست — دستگاه مستقیماً از طریق اینترنت با Biometric Gateway ارتباط برقرار میکند.
پشتیبانی کامل از API. هر 38 عملیات بدون محدودیت کار میکنند — هم Callback و هم RESTful. بدون تأخیر برای callbackها، ~15 ثانیه برای فرمانهای RESTful.
Hybrid Push سایر دستگاهها
برای دستگاههای غیر Cams و تأییدنشده، شما یک حالت اتصال Hybrid Push متناسب با محیط خود انتخاب میکنید. ترکیب روش ارتباط و توپولوژی استقرار تعیین میکند کدام قابلیتهای API در دسترس است.
روشهای ارتباط
(a) Device SDKGateway از طریق SDK سازنده دستگاه با سختافزار ارتباط میگیرد. همه قابلیتهای پشتیبانیشده توسط SDK از طریق API در دسترس است. بهترین گزینه برای دسترسی کامل به API.
(b) DB PullGateway از یک پایگاه داده محلی که روی رایانه محل نصب شده (جایی که نرمافزار دستگاه حضور و غیاب را ذخیره میکند) میخواند. فقط push لاگ حضور/تردد به سرور شما پشتیبانی میشود. بدون APIهای RESTful (بدون افزودن/حذف کاربر، بدون بارگذاری لاگ و غیره).
(c) پردازش فایلیک فایل حضور مشخص روی رایانه محلی تحت پایش مداوم قرار میگیرد. هر بار که نرمافزار دستگاه فایل را بهروزرسانی کند، رکوردهای حضور جدید بهطور خودکار شناسایی، دریافت و بهصورت بلادرنگ به Callback URL شما push میشوند. محدودیتهای API همانند DB Pull است -- فقط push حضور، بدون APIهای RESTful.
توپولوژیهای استقرار
(X) مستقیمرایانه محل دارای IP عمومی با port forwarding به شبکه محلی است. Biometric Gateway مستقیماً از طریق اینترنت به دستگاه/پایگاه داده/فایلها متصل میشود.
(Y) غیرمستقیمیک Hybrid Connector روی رایانه محلی نصب میشود. این برنامه نقش پل بین دستگاه/پایگاه داده/فایلهای محلی و Biometric Gateway را دارد — بدون نیاز به IP عمومی در سمت مشتری.
Hybrid Push — ماتریس قابلیتهای در دسترس
حالت
روش ارتباط
توپولوژی
API نوع Callback
API نوع RESTful
دستگاه مستقیم
(a) SDK
(X) IP عمومی
کامل
کامل (با محدودیتهای SDK)
دستگاه غیرمستقیم
(a) SDK
(Y) Hybrid Connector
کامل
کامل (با محدودیتهای SDK)
پایگاه داده مستقیم
(b) DB Pull
(X) IP عمومی
فقط حضور
پشتیبانی نمیشود
پایگاه داده غیرمستقیم
(b) DB Pull
(Y) Hybrid Connector
فقط حضور
پشتیبانی نمیشود
فایل مستقیم
(c) فایل
(X) IP عمومی
فقط حضور
پشتیبانی نمیشود
فایل غیرمستقیم
(c) فایل
(Y) Hybrid Connector
فقط حضور
پشتیبانی نمیشود
کدام حالت را انتخاب کنم؟ اگر دستگاه غیر Cams شما SDKی دارد که Gateway از آن پشتیبانی میکند، حالت Device SDK (a) را برای دسترسی کامل به API انتخاب کنید. در غیر این صورت، DB Pull (b) یا پردازش فایل (c) باز هم جریان داده حضور را برقرار میکند. برای توپولوژی، اگر نمیتوانید IP عمومی تنظیم کنید، غیرمستقیم (Y) را با Hybrid Connector انتخاب کنید — استقرار آن از همه سادهتر است.
محدودیتهای سختافزاری ممکن است قابلیتهای API را بیشتر محدود کنند. حتی در حالت Device SDK، بسته به firmware مدل دستگاه یا قابلیتهای SDK ممکن است برخی APIها کار نکنند. همیشه با سختافزار خود تست کنید و با تیم پشتیبانی Cams تأیید بگیرید.