الاتصال بأجهزة البصمة دون IP عام: شرح Hybrid Connector
غالباً ما تتعثر مشاريع تكامل أجهزة البصمة عند سؤال لا علاقة له بالبصمة نفسها: كيف تصل السحابة إلى جهاز موجود خلف جهاز توجيه المكتب؟ كثير من المواقع لا تملك عنوان IP عاماً، أو عنواناً يتغير يومياً، أو فريق تقنية معلومات لا يفتح المنافذ الواردة في جدار الحماية، وهم محقون في توخّي الحذر. الإجابة التقليدية، أي توجيه المنافذ (Port Forwarding)، معقدة وتعرّض الشبكة المحلية للخطر. تحل Cams Biometrics هذه المشكلة بـ Hybrid Connector، وهو برنامج صغير يربط موقعك بالـ Gateway من الداخل إلى الخارج. يشرح هذا الدليل سبب صعوبة الوصول إلى كثير من الأجهزة، وكيف يعمل Hybrid Connector بلغة مبسطة، وما الذي يمكنك تنفيذه من خلاله، وكيفية إعداده.
01 · مشكلة الشبكة
لماذا يصعب الوصول إلى كثير من أجهزة البصمة
الجهاز البيومتري الموجود على شبكة محلية يشبه منزلاً على طريق خاص. يستطيع من في الداخل الخروج متى شاء، لكن لا يستطيع أحد من الخارج الدخول ما لم يفتح أحدهم البوابة. ولكي تصل منصة سحابية إلى الجهاز مباشرةً، يحتاج الموقع إلى عنوان عام وفتحة مقصودة في جدار الحماية تؤدي إلى الجهاز. كثير من المواقع لا تملك ذلك، ولأسباب وجيهة.
| الوضع | ماذا يعني | لماذا يفشل الوصول المباشر |
|---|---|---|
| لا يوجد IP عام | يشارك مزود الإنترنت عنواناً عاماً واحداً بين عملاء كثيرين | لا يوجد عنوان فريد يقود إلى موقعك |
| تغيّر عنوان IP | يتغير عنوان IP العام للموقع بشكل دوري | عنوان يعمل اليوم قد يشير إلى مكان آخر غداً |
| سياسة جدار حماية صارمة | لا تسمح تقنية المعلومات بالاتصالات الواردة من الإنترنت | لا تستطيع السحابة بدء الاتصال مع الجهاز |
| تعذر توجيه المنافذ | يُدار الموجه من قبل المالك أو مزود الإنترنت أو المقر الرئيسي | لا يستطيع أحد في الموقع فتح البوابة |
| مخاوف أمنية | فتح المنافذ يعرّض الأنظمة الداخلية للإنترنت | حتى إن أمكن ذلك، فكثير من المؤسسات لن تقبل المخاطرة |
تواجه فروع البيع بالتجزئة، ومواقع البناء، والمستودعات، والمدارس، والمكاتب الصغيرة جميعها هذه القيود. ولا يُعد أيٌّ منها سبباً للتخلي عن تكامل البصمة السحابي، بل سبباً للاتصال بطريقة مختلفة.
02 · مباشر مقابل غير مباشر
طريقتان للاتصال بجهاز Hybrid Push
تتصل أجهزة Cams، والأجهزة المعتمدة في developer.camsbiometrics.com، بالـ Gateway عبر Native Push، إذ تتواصل معه مباشرةً عبر الإنترنت. أما الأجهزة الأخرى فتتصل عبر Hybrid Push، ويقدم Hybrid Push طريقتين لطوبولوجيا النشر. والخيار الصحيح يعتمد كلياً على شبكة موقعك.
| طوبولوجيا مباشرة | طوبولوجيا غير مباشرة (Hybrid Connector) | |
|---|---|---|
| كيفية الاتصال | يتصل الـ Gateway بالجهاز أو قاعدة البيانات أو الملفات عبر الإنترنت | يتصل Hybrid Connector على حاسوب محلي بالـ Gateway بشكل خارجي |
| مطلوب IP عام | نعم، على حاسوب الموقع | لا |
| مطلوب توجيه المنافذ | نعم | لا |
| برنامج في الموقع | لا يوجد | Hybrid Connector على حاسوب محلي |
| الأفضل لـ | المواقع التي لديها IP عام وفرق تقنية معلومات مرتاحة لتوجيه المنافذ | المواقع خلف الموجهات أو جدران الحماية الصارمة أو التي لا تملك IP عاماً |
|
الخيار الأسهل لمعظم المواقع إذا لم تتمكن من إعداد IP عام وتوجيه المنافذ، فاختر الطوبولوجيا غير المباشرة مع Hybrid Connector. فهي تتجنب إجراء أي إعدادات شبكية على جانب العميل تماماً، ولهذا السبب تُعد عادةً أسهل طريقة للنشر. |
03 · من الداخل إلى الخارج، لا من الخارج إلى الداخل
كيف يعمل Hybrid Connector
يقلب Hybrid Connector مشكلة الشبكة رأساً على عقب. فبدلاً من أن تحاول السحابة الدخول إلى موقعك، يمد شيءٌ ما داخل موقعك يده إلى السحابة. وللعودة إلى مثال المنزل على الطريق الخاص: فبدلاً من طلب فتح البوابة، يخرج أحد المقيمين ويُبقي خط تواصل مفتوحاً من العالم الخارجي إلى المنزل.
بدون Hybrid Connector
|
Cams Gateway يحاول الوصول إلى الجهاز من الإنترنت |
→ |
موجه الموقع أو جدار الحماية يمنع الاتصال الوارد |
→ |
الجهاز لا يستقبل الطلب أبداً |
مع Hybrid Connector
|
الجهاز أو قاعدة البيانات أو الملف يبقى على الشبكة المحلية |
→ |
Hybrid Connector يعمل على حاسوب محلي ويتواصل مع الجهاز محلياً |
→ |
اتصال صادر يمد الـ Connector يده إلى الـ Gateway |
→ |
Cams Gateway يتبادل البيانات مع ERP/HRMS الخاص بك عبر هذا الاتصال |
لأن الاتصال يبدأ من داخل شبكتك، فإنه يعمل بالطريقة نفسها التي يعمل بها متصفح الويب على ذلك الحاسوب. فالموقع لا يحتاج إلى IP عام، وجدار الحماية لا يحتاج إلى قبول أي اتصال وارد جديد. يعمل Hybrid Connector كجسر بين الجهاز المحلي أو قاعدة البيانات أو الملفات من جهة، وبين Biometric Gateway من جهة أخرى.
|
يفتح توجيه المنافذ باباً إلى شبكتك. أما Hybrid Connector فيُبقي الباب مغلقاً ويُجري الاتصال من الداخل. |
|
تحقق من المنافذ المسموح بها يجب أن يسمح جدار الحماية بالاتصالات الصادرة أيضاً. تسمح معظم الشبكات بحركة الويب الصادرة الشائعة، لكن الشبكات الصارمة قد تقيّدها. راجع قسم Ports Supported في توثيق Cams Web API، وشاركه مع فريق تقنية المعلومات لديك قبل التثبيت. |
04 · الميزات والحدود
ما الذي يمكنك فعله من خلال Hybrid Connector
يحدد Hybrid Connector كيف يتصل موقعك. ولا يحدد ماذا يمكنك أن تفعل. فذلك تحدده طريقة الاتصال المستخدمة للتواصل مع الجهاز، وهناك ثلاث طرق للاختيار منها.
| الوضع | طريقة الاتصال | Callback API | RESTful API |
|---|---|---|---|
| Indirect Device | Device SDK | كامل | كامل، ضمن حدود SDK |
| Indirect DB | DB Pull من قاعدة البيانات المحلية لبرنامج الجهاز | الحضور فقط | غير مدعوم |
| Indirect File | File Processing لملف الحضور الخاص ببرنامج الجهاز | الحضور فقط | غير مدعوم |
| طريقة الاتصال | كيف تعمل |
|---|---|
| Device SDK | يتواصل الـ Gateway مع الجهاز عبر SDK الخاص بالشركة المصنّعة، لذا فإن كل ميزة يدعمها الـ SDK متاحة عبر الـ API. وهذا هو الخيار الأفضل للوصول الكامل إلى الـ API |
| DB Pull | يقرأ الـ Gateway سجلات الحضور الجديدة من قاعدة البيانات المحلية التي يخزّن فيها برنامج الجهاز بياناته، ثم يدفعها إلى Callback URL الخاص بك |
| File Processing | يتم مراقبة ملف حضور محدد على الحاسوب المحلي بشكل مستمر. وفي كل مرة يحدّثه برنامج الجهاز، يتم اكتشاف السجلات الجديدة ودفعها إلى Callback URL الخاص بك في الوقت الفعلي |
|
الطوبولوجيا والميزات قراران منفصلان تقدم الطوبولوجيا المباشرة وغير المباشرة الميزات نفسها تماماً لطريقة الاتصال نفسها. اختر طريقة الاتصال بناءً على ميزات الـ API التي تحتاجها، واختر الطوبولوجيا بناءً على ما تسمح به شبكتك. |
حتى في وضع Device SDK، قد تحد البرمجيات الثابتة (firmware) أو SDK لطراز جهاز معين من بعض العمليات. اختبر دائماً باستخدام أجهزتك الفعلية، وتأكد من الحالات الخاصة مع فريق Cams.
05 · خطوة بخطوة
إعداد Hybrid Connector
تعتمد الشاشات الدقيقة على حساب Cams الخاص بك، لكن كل إعداد لـ Hybrid Connector يتبع المسار نفسه.
|
اختر الحاسوب المحلي المناسب اختر حاسوباً على الشبكة المحلية نفسها للجهاز. وبالنسبة إلى DB Pull أو File Processing، يجب أن يكون هو الحاسوب الذي يخزّن فيه برنامج الجهاز قاعدة بياناته أو ملف الحضور، لأن الـ Connector يحتاج إلى وصول محلي إليهما. |
|
|
تأكد من الوصول الصادر شارك تفاصيل Ports Supported من توثيق Cams مع فريق تقنية المعلومات لديك، وتأكد من أن الحاسوب قادر على إجراء الاتصالات الصادرة المطلوبة. |
|
|
ثبّت Hybrid Connector ثبّت الـ Connector على هذا الحاسوب واربطه بحساب Cams الخاص بك، باتباع تعليمات الإعداد الخاصة بحسابك. |
|
|
اختر طريقة الاتصال اختر Device SDK إذا كان الـ Gateway يدعم SDK الخاص بجهازك. وإلا، فاختر DB Pull أو File Processing لبيانات الحضور. |
|
|
حدّد Callback URL الخاص بك اضبط عنوان HTTPS الخاص بالمستقبِل لديك، أو نظام HRMS أو ERP أو أداة الأتمتة، كـ Callback URL، حتى يكون لأحداث الحضور وجهة تصل إليها. |
|
|
اختبر من طرف إلى طرف امسح بصمة إصبع أو وجهاً على الجهاز، وتأكد من وصول الحدث إلى Callback URL الخاص بك. وفي وضع Device SDK، جرّب أيضاً عملية RESTful، مثل إضافة مستخدم تجريبي. |
تحتاج إلى مستقبِل لإرسال الأحداث إليه؟ يمكن لـ Cams AI Code Generator Prompts توليد مستقبِل Callback كامل بلغة Python وNode.js وPHP ولغات أخرى عدة.
06 · أفضل الممارسات
الحفاظ على سلامة الاتصال
بعد التثبيت، يصبح Hybrid Connector جزءاً من البنية التحتية لموقعك. بضع عادات بسيطة تحافظ على موثوقيته.
| الممارسة | لماذا تهم |
|---|---|
| استخدم حاسوباً يبقى مفعّلاً | إذا دخل الحاسوب في وضع السكون أو أُغلق، يتوقف الاتصال بين الموقع والـ Gateway مؤقتاً |
| عطّل السكون والإسبات | إعدادات توفير الطاقة هي السبب الأكثر شيوعاً للانقطاعات الصامتة |
| شغّل الـ Connector تلقائياً | بعد إعادة التشغيل أو انقطاع الكهرباء، ينبغي أن يعود الاتصال دون أن يسجّل أحد الدخول |
| احمِ من انقطاع الكهرباء | يُبقي UPS صغير الحاسوب والشبكة تعملان خلال الانقطاعات القصيرة |
| حافظ على تحديث الحاسوب وتأمينه | إنه موجود على شبكتك، لذا عامله كأي جهاز مُدار آخر |
| راقب الفجوات في الأحداث | إذا توقّف موقع مزدحم فجأة عن إرسال الأحداث، فافحص الحاسوب واتصاله أولاً |
|
ماذا يحدث عند انقطاع الاتصال يُسجَّل الحضور على الجهاز، وصُمم الكاش غير المتصل وقائمة الانتظار في الـ Gateway للتعامل مع الانقطاعات. وعند عودة الاتصال، تُسلَّم السجلات بطوابعها الزمنية الأصلية، لذا تظهر عمليات المسح التي تمت أثناء الانقطاع في الوقت الصحيح. أما بالنسبة إلى DB Pull وFile Processing، فتبقى السجلات في قاعدة بيانات برنامج الجهاز أو ملفه حتى يقرأها الـ Connector. |
الأسئلة الشائعة
|
هل تحتاج أجهزة Cams إلى Hybrid Connector؟ لا. تتصل أجهزة Cams والأجهزة المعتمدة في developer.camsbiometrics.com عبر Native Push، إذ تتواصل مباشرةً مع الـ Gateway عبر الإنترنت. ويُستخدم Hybrid Connector لأجهزة Hybrid Push. |
|
هل Hybrid Connector أكثر أماناً من توجيه المنافذ؟ إنه يتجنب فتح المنافذ الواردة إلى شبكتك المحلية، مما يزيل مصدراً شائعاً للمخاطر. تعمل الاتصالات عبر HTTP/HTTPS مع التحقق من صحة رمز المصادقة (auth token)، ويتوفر تشفير AES-256 اختيارياً. |
|
يتغير عنوان IP لموقعنا يومياً. هل سيسبب ذلك مشاكل؟ لا، مع الطوبولوجيا غير المباشرة. فلأن Hybrid Connector يتصل خارجياً بالـ Gateway، لا يحتاج موقعك إلى عنوان IP ثابت أو عام. |
|
هل ما زال بإمكاني إضافة المستخدمين وحذفهم عبر Hybrid Connector؟ نعم، في وضع Device SDK، ضمن حدود SDK الخاص بالجهاز. أما DB Pull وFile Processing فيدعمان استدعاءات الحضور فقط، دون عمليات RESTful. |
|
هل يعمل Hybrid Connector مع HRMS أو ERP الخاص بي؟ نعم. يتولى الـ Connector الاتصال بين موقعك والـ Gateway. ويستقبل نظام HRMS أو ERP أو أداة الأتمتة لديك الأحداث عبر Callback API بالطريقة نفسها تماماً كما في أي وضع اتصال آخر. |
الخاتمة: لا ينبغي للشبكة أن تحدد تكاملك
لسنوات، كانت الشبكة في موقع الجهاز تحدد بصمت أي تكاملات بيومترية ممكنة. فغياب IP عام كان يعني عدم وجود اتصال سحابي. وجدار الحماية الصارم كان يعني تفاوضاً طويلاً مع تقنية المعلومات. وعنوان IP المتغير كان يعني تكاملات تتعطل دون إنذار.
يزيل Hybrid Connector هذا القيد. فبالاتصال من الداخل إلى الخارج، يتيح للأجهزة خلف موجهات المكاتب العادية وجدران الحماية الصارمة واتصالات الإنترنت المشتركة أن تشارك في التكاملات الفورية نفسها مثل أي جهاز آخر، دون فتح أي منفذ وارد واحد.
يوصل Cams Biometrics Gateway الأجهزة بالإنترنت أينما كانت. يربط Native Push أجهزة Cams والأجهزة المعتمدة مباشرةً. ويربط Hybrid Push العلامات التجارية الأخرى عبر Device SDK أو DB Pull أو File Processing، باستخدام إما الطوبولوجيا المباشرة أو Hybrid Connector عند عدم توفر IP عام. تصل كل الأحداث إلى أنظمتك عبر Callback API نفسه، مع التحقق من صحة رمز المصادقة وتشفير AES-256 اختيارياً. استكشف المنصة على CamsBiometrics.com، واقرأ التوثيق الكامل، بما في ذلك أوضاع الاتصال والمنافذ المدعومة، على developer.camsbiometrics.com، وولّد المستقبِل الخاص بك عبر AI Code Generator Prompts.