نظرة سريعة
- الحالة
- يحتاج إلى تكامل
- الفئات
- قارئات ووحدات تحكم في الأبواب مُدارة سحابيًا
- ما يستخدمه الأعضاء
- بطاقات
- المتطلبات
- مفتاح واجهة Kisi وتكامل صغير بين السحابتين
كيف يتصل
- العضو يمرّر بطاقة على قارئ Kisi
- سحابة Kisi
- التكامل يسأل Chronix Hub
- عند نعم يستدعي التكامل واجهة فتح القفل في Kisi
مع Kisi يُتحكَّم بالقفل من سحابة Kisi، فلا يوجد صندوق على شبكتك للترجمة. يقف تكامل (خدمة سحابية صغيرة يشغّلها المدمج لديك) بين الطرفين: يعلم بالمحاولة، ويستدعي نقطة تحقق Chronix Hub، ولا يستدعي واجهة فتح القفل في Kisi إلا إذا كانت الإجابة granted: true.
لا يوفّر Chronix Hub تكاملًا مع Kisi اليوم وليس شريكًا رسميًا لـ Kisi. يُبنى التكامل فوق واجهة HTTPS المفتوحة الموضحة في صفحة «أي جهاز يدعم HTTPS». وجانب النادي جاهز الآن.
الأجهزة المدعومة
Kisi تدير الأجهزة. المهم أن يستطيع إعداد Kisi لديك إتاحة كل محاولة لتكاملك.
- قارئات ووحدات تحكم أبواب Kisi المُدارة سحابيًا.
- أكّد مع مدمجك أي المحاولات ستمررها Kisi إلى التكامل وبأي سرعة، قبل الاعتماد عليه في باب مزدحم.
ما الذي يمكن للأعضاء استخدامه
البطاقات هي ما ندرجه لـ Kisi اليوم.
بطاقة
رقم البطاقة الذي يقرؤه قارئ Kisi، مضافًا في تبويب «الدخول» لدى العضو ويمرّره التكامل.
بيانات اعتماد أخرى
بطاقة QR أو رمز PIN لمرة واحدة من البوابة يتطلب جهازًا يستطيع قراءته وإرساله إلى التكامل. اسأل مدمجك قبل أن تعد به الأعضاء.
الإعداد خطوة بخطوة
جانب النادي يستغرق دقائق. أما التكامل فللمدمج لديك.
أنشئ الباب
تبويب «الأبواب»: سمِّه واختر جدولًا ومدة منع التمرير المزدوج.
أضف الجهاز
تبويب «الأجهزة»، «إضافة جهاز». اختر الشركة المصنّعة Kisi والباب، وأضف عنوان IP العام للتكامل إلى قائمة السماح.
انسخ المفتاح ومعرّف الجهاز
يظهر المفتاح مرة واحدة. أعطه مع معرّف الجهاز لمدمجك عبر مدير كلمات مرور.
أنشئ مفتاح واجهة في Kisi
في Kisi أنشئ مفتاح واجهة للتكامل. يصبح لدى المدمج مفتاحان: مفتاح Kisi ومفتاح Chronix Hub.
ابنِ التكامل
يسأل نقطة التحقق أولًا ولا يستدعي واجهة فتح القفل في Kisi إلا عند granted: true. أي خطأ أو انتهاء مهلة أو حالة غير 200 يعني عدم الفتح.
جرّب
مرّر بطاقة وراقب السجل المباشر. جمّد ذلك العضو وجرّب مجددًا لتتأكد من الرفض.
مفتاحان، مهمتان
مفتاح جهاز Chronix Hub لا يتيح للتكامل إلا طرح أسئلة التحكم في الدخول. ومفتاح واجهة Kisi لا يتيح إلا الفتح. احتفظ بهما في مخزن أسرار التكامل وبدّل أيًا منهما بشكل مستقل: «إعادة توليد المفتاح» في Chronix Hub تُنهي القديم فورًا.
استكشاف الأخطاء وإصلاحها
| ما تراه | السبب المرجّح | الحل |
|---|---|---|
| لا شيء في السجل المباشر | لم يصل التكامل إلى Chronix Hub. | تحقق من المفتاح ومعرّف الجهاز وقائمة IP (عنوان التكامل العام) وإنترنته. |
| مسموح في السجل لكن الباب يبقى مقفلًا | لم يستدعِ التكامل واجهة فتح القفل في Kisi، أو أن مفتاح Kisi غير صالح. | افحص سجلات التكامل ومفتاح واجهة Kisi. |
| unknown_credential عند كل لمسة | البطاقة غير مسجّلة أو أن صيغة الرقم مختلفة. | أضف بيانات الاعتماد بالرقم الدقيق الذي يرسله التكامل. |
| بطء في الفتح | استدعاءان سحابيان متتاليان يضيفان زمنًا للشبكة. | اطلب من مدمجك وضع التكامل قرب الخدمتين. |
| 403 من استدعاء التحقق | عنوان IP للتكامل ليس في قائمة السماح. | أضف عنوانه العام إلى قائمة السماح للجهاز. |
ما الذي تسأله للمدمج
اسأل قبل أن تلتزم.
- كيف يعلم التكامل بكل محاولة عند قارئ Kisi؟
- هل يستدعي نقطة التحقق عبر HTTPS أولًا ولا يفتح عبر Kisi إلا عند granted: true؟
- هل سيبقى الباب مقفلًا عند أي خطأ أو انتهاء مهلة؟
- من يستضيف التكامل ويصونه، وماذا يحدث إذا توقف؟
- أين يُخزَّن مفتاح واجهة Kisi ومفتاح جهاز Chronix Hub؟
الأسئلة الشائعة
هل يوجد تكامل مع Kisi؟
غير مضمَّن. يعمل Kisi عبر تكامل يُبنى فوق واجهة Chronix Hub المفتوحة. وChronix Hub ليست شريكًا معتمدًا أو رسميًا لـ Kisi.
هل يعمل الباب إذا تعذّر الوصول إلى Chronix Hub؟
هذا قرار تصميم يعود إلى مدمجك. خادم Chronix Hub نفسه لا يقول «نعم» بسبب خطأ أبدًا. وفتح الباب أثناء الانقطاع يعتمد على التكامل وإعداد Kisi لديك.
هل يستطيع الأعضاء استخدام QR أو رمز PIN لمرة واحدة؟
فقط إذا كانت أجهزة Kisi لديك تستطيع قراءتها ويمررها التكامل. البطاقات هي بيانات الاعتماد التي ندرجها لـ Kisi اليوم.
ما أسرع خيار لباب واحد؟
كشك الويب يعمل اليوم بلا تكامل.
طرق ربط أخرى
أسماء المنتجات ملك لأصحابها. Chronix Hub ليست شريكًا معتمدًا أو رسميًا لأي مصنّع أجهزة ولا تبيع أجهزة.
هل تريد رؤية التحكم في الدخول على ناديك؟
احجز عرضًا توضيحيًا قصيرًا وسنراجع معك بابك وأجهزتك وخطط العضوية.