Support Hub/API & Integrations/الاتصال بأجهزة البصمة دون IP عام: شرح Hybrid Connector
Translated from the English article and reviewed by a person. Read the English original
Developer

الاتصال بأجهزة البصمة دون IP عام: شرح Hybrid Connector

الاتصال بأجهزة البصمة دون 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 يتبع المسار نفسه.

1

اختر الحاسوب المحلي المناسب

اختر حاسوباً على الشبكة المحلية نفسها للجهاز. وبالنسبة إلى DB Pull أو File Processing، يجب أن يكون هو الحاسوب الذي يخزّن فيه برنامج الجهاز قاعدة بياناته أو ملف الحضور، لأن الـ Connector يحتاج إلى وصول محلي إليهما.

2

تأكد من الوصول الصادر

شارك تفاصيل Ports Supported من توثيق Cams مع فريق تقنية المعلومات لديك، وتأكد من أن الحاسوب قادر على إجراء الاتصالات الصادرة المطلوبة.

3

ثبّت Hybrid Connector

ثبّت الـ Connector على هذا الحاسوب واربطه بحساب Cams الخاص بك، باتباع تعليمات الإعداد الخاصة بحسابك.

4

اختر طريقة الاتصال

اختر Device SDK إذا كان الـ Gateway يدعم SDK الخاص بجهازك. وإلا، فاختر DB Pull أو File Processing لبيانات الحضور.

5

حدّد Callback URL الخاص بك

اضبط عنوان HTTPS الخاص بالمستقبِل لديك، أو نظام HRMS أو ERP أو أداة الأتمتة، كـ Callback URL، حتى يكون لأحداث الحضور وجهة تصل إليها.

6

اختبر من طرف إلى طرف

امسح بصمة إصبع أو وجهاً على الجهاز، وتأكد من وصول الحدث إلى 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.

Was this article helpful?