تسجيل الدخول التلقائي
يتيح تسجيل الدخول التلقائي لـ UserJot نقل جلسة المستخدم الذي سجّل دخوله من منتجك إلى لوحة الملاحظات العامة أو خارطة الطريق أو سجل التغييرات أو مركز المساعدة أو التضمينات المضمّنة، من دون مطالبة المستخدم بتسجيل الدخول مرة أخرى.
يمكن للويدجت التعرّف إلى المستخدمين تلقائيًا؛ أما تسجيل الدخول التلقائي فهو إعداد مساحة العمل الذي يسمح باستخدام هذه الهوية لتسجيل دخول المستخدمين إلى صفحاتك العامة، والتضمينات المضمّنة، وSwift SDK.
تفعيل تسجيل الدخول التلقائي
افتح الإعدادات → تسجيل الدخول.
ضمن المصادقة، فعّل تسجيل الدخول التلقائي.
للجلسات التي يتحقق منها الخادم، فعّل أيضًا اشتراط الرموز المميزة الموقّعة (يظهر هذا الخيار بعد تفعيل تسجيل الدخول التلقائي).
يتطلب تسجيل الدخول التلقائي خطة Starter أو Professional. في الخطة المجانية، يظهر مفتاح التبديل لكنه يكون مقفلاً.
ما وظيفة إعداد «اشتراط الرموز المميزة الموقّعة»؟
يُنفَّذ استدعاء uj.identify عادي في المتصفح ويمكن للزائر تعديله. عند تفعيل اشتراط الرموز الموقّعة، يرفض UserJot استدعاءات identify غير الموقّعة، ويشترط تضمين عضويات الشركة داخل الرمز الموقّع (ويتجاهل companies غير الموقّع من جهة العميل مع إصدار تحذير UNSIGNED_COMPANY_IGNORED)، ولا يقبل إلا الهويات الموقّعة على خادمك باستخدام JWT من نوع HS256 (أو توقيع HMAC-SHA256 في Swift SDK). راجع الهوية الموقّعة للاطلاع على أمثلة من جهة الخادم.
آلية العمل
فعّل تسجيل الدخول التلقائي من الإعدادات → تسجيل الدخول.
ثبّت الأداة المصغّرة في منتجك.
استدعِ
uj.identify(...)بمجرد تحميل جلسة المستخدم (مع تمريرtokenموقّع إذا لزم الأمر). لا يؤدي تمريرemailإلى ربطه بحساب UserJot موجود إلا إذا كان عنوان البريد الإلكتروني لذلك الحساب مؤكّدًا.أنشئ في تطبيقك رابطًا إلى عنوان UserJot العام، سواء كان عنوان
userjot.comأو نطاقًا مخصصًا.
<a href="https://feedback.example.com/">Give feedback</a>
<a href="https://feedback.example.com/roadmap">Roadmap</a>
<a href="https://feedback.example.com/updates">Updates</a>يرفق SDK الجلسة تلقائيًا عندما يتبع المستخدمون روابط إلى نطاق مشروعك؛ لا حاجة إلى إضافة الرموز المميزة إلى عناوين URL بنفسك. تستخدم التضمينات المضمّنة آلية التبادل نفسها تلقائيًا بعد تشغيل uj.identify.
if (user) {
uj.identify({ token: user.userJotToken });
} else {
uj.logout();
}القيود
لا ينطبق ذلك على مشرفي مساحات العمل أو مالكيها في اللوحات العامة. لا يؤدي تسجيل الدخول التلقائي إلى تسجيل دخول مشرفي مساحات العمل أو مالكيها إلى اللوحات العامة (احرص دائمًا على اختبار تسجيل الدخول التلقائي إلى اللوحة باستخدام حساب عميل عادي؛ إذ يسجّل أعضاء الفريق الدخول إلى اللوحات العامة مباشرةً باستخدام حساب UserJot الخاص بهم أو عبر إعادة التوجيه باستخدام SSO). داخل الأداة المصغّرة داخل التطبيق، يعمل الرمز الموقّع
uj.identifyللمشرفين والمالكين، ويزامنtraitsوcompaniesمع الإبقاء على الاسم والصورة الرمزية والبريد الإلكتروني التي يديرونها عبر لوحة التحكم دون تغيير.منفصل عن تسجيل الدخول الأحادي. ينقل تسجيل الدخول التلقائي جلسات الويدجت إلى الصفحات العامة من داخل تطبيقك؛ أما تسجيل الدخول الأحادي فيستبدل زر تسجيل الدخول في لوحة الملاحظات بإعادة توجيه إلى صفحة تسجيل الدخول الخاصة بك.
يفشل الوضع الصارم بطريقة آمنة. عند تفعيل اشتراط الرموز المميزة الموقّعة، يؤدي غياب الرمز المميز أو عدم صلاحيته إلى رفض
uj.identifyباستخدامIDENTIFY_FAILED، مع إبقاء الزائر خارج الجلسة.
استكشاف الأخطاء وإصلاحها
لا يزال المستخدم يرى مطالبة بتسجيل الدخول
تأكد من تفعيل تسجيل الدخول التلقائي في الإعدادات → تسجيل الدخول.
تأكد من تحميل SDK الخاص بالويدجت على الصفحة التي تحتوي على الرابط، ومن تشغيل
uj.identifyقبل النقر على الرابط.تأكد من أن الرابط يشير إلى نطاقك الفرعي
userjot.comالصحيح تمامًا أو إلى نطاقك المخصص.تأكّد من أنك لا تختبر تسجيل الدخول التلقائي إلى لوحة عامة باستخدام عنوان البريد الإلكتروني لمشرف مساحة عمل أو مالكها.
الرموز المميزة الموقّعة مطلوبة، لكن تسجيل الدخول لا يزال يفشل
تأكد من أن
uj.identifyيتلقىtokenموقّعًا باستخدام HS256 وسر المشروع الحالي.تأكد من أن
issيطابق معرّف المشروع، وأنaudهوuserjot، وأن كلاً منiatوexpبوحدات الثواني وفق توقيت Unix، معexp - iat <= 3600(مدة صلاحية لا تتجاوز ساعة واحدة).تحقّق من الوعد الذي يعيده
uj.identifyبحثًا عنIDENTIFY_FAILED.
الخطوات التالية
أنشئ رموز JWT من جهة الخادم في الهوية الموقّعة.
قارن جميع خيارات المصادقة في التعرّف إلى المستخدمين.