تسجيل الدخول التلقائي

Shayan Taslimتم التحديث

يتيح تسجيل الدخول التلقائي لـ UserJot نقل جلسة المستخدم الذي سجّل دخوله من منتجك إلى لوحة الملاحظات العامة أو خارطة الطريق أو سجل التغييرات أو مركز المساعدة أو التضمينات المضمّنة، من دون مطالبة المستخدم بتسجيل الدخول مرة أخرى.

يمكن للويدجت التعرّف إلى المستخدمين تلقائيًا؛ أما تسجيل الدخول التلقائي فهو إعداد مساحة العمل الذي يسمح باستخدام هذه الهوية لتسجيل دخول المستخدمين إلى صفحاتك العامة، والتضمينات المضمّنة، وSwift SDK.

تفعيل تسجيل الدخول التلقائي

  1. افتح الإعدادات → تسجيل الدخول.

  2. ضمن المصادقة، فعّل تسجيل الدخول التلقائي.

  3. للجلسات التي يتحقق منها الخادم، فعّل أيضًا اشتراط الرموز المميزة الموقّعة (يظهر هذا الخيار بعد تفعيل تسجيل الدخول التلقائي).

يتطلب تسجيل الدخول التلقائي خطة Starter أو Professional. في الخطة المجانية، يظهر مفتاح التبديل لكنه يكون مقفلاً.

ما وظيفة إعداد «اشتراط الرموز المميزة الموقّعة»؟

يُنفَّذ استدعاء uj.identify عادي في المتصفح ويمكن للزائر تعديله. عند تفعيل اشتراط الرموز الموقّعة، يرفض UserJot استدعاءات identify غير الموقّعة، ويشترط تضمين عضويات الشركة داخل الرمز الموقّع (ويتجاهل companies غير الموقّع من جهة العميل مع إصدار تحذير UNSIGNED_COMPANY_IGNORED)، ولا يقبل إلا الهويات الموقّعة على خادمك باستخدام JWT من نوع HS256 (أو توقيع HMAC-SHA256 في Swift SDK). راجع الهوية الموقّعة للاطلاع على أمثلة من جهة الخادم.

آلية العمل

  1. فعّل تسجيل الدخول التلقائي من الإعدادات → تسجيل الدخول.

  2. ثبّت الأداة المصغّرة في منتجك.

  3. استدعِ uj.identify(...) بمجرد تحميل جلسة المستخدم (مع تمرير token موقّع إذا لزم الأمر). لا يؤدي تمرير email إلى ربطه بحساب UserJot موجود إلا إذا كان عنوان البريد الإلكتروني لذلك الحساب مؤكّدًا.

  4. أنشئ في تطبيقك رابطًا إلى عنوان UserJot العام، سواء كان عنوان userjot.com أو نطاقًا مخصصًا.

HTML
<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.

JavaScript
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.

الخطوات التالية

هل أجاب هذا عن سؤالك؟