كيفية تفعيل تسجيل الدخول الموحد
مقدمة
لقد قمت بربط Casdoor وقمت بتكوين أكثر من تطبيق في منظمة. تريد أن يقوم المستخدمون بتسجيل الدخول مرة واحدة إلى أي تطبيق في المنظمة ثم يتمكنون من تسجيل الدخول عند الانتقال إلى تطبيق آخر دون أي نقرات إضافية.
نحن نقدم هذه الميزة لتسجيل الدخول الموحد. لتفعيلها، كل ما تحتاجه هو:
- تفعيل زر تسجيل الدخول التلقائي.
- املأ عنوان URL للصفحة الرئيسية.
- أضف وظيفة تسجيل الدخول الصامت إلى الصفحة الرئيسية للتطبيق.
عملية تسجيل الدخول الأساسية التي يوفرها Casdoor تسمح للمستخدمين بتسجيل الدخول إلى تطبيقات أخرى في المنظمة عن طريق اختيار المستخدم الذي قام بتسجيل الدخول حاليًا أو باستخدام حساب آخر.
بعد تفعيل تسجيل الدخول التلقائي، لن يتم عرض مربع الاختيار، وسيقوم المستخدم المسجل بتسجيل الدخول مباشرة.
التكوين
- املأ حقل "الرئيسية". يمكن أن تكون الصفحة الرئيسية للتطبيق أو صفحة تسجيل الدخول.
2. تفعيل زر تسجيل الدخول التلقائي.
أضف تسجيل الدخول الصامت
في الواقع، نحن ننفذ تسجيل الدخول التلقائي عن طريق حمل المعاملات في عنوان URL. لذلك، يجب أن تحتوي تطبيقاتك على طريقة لتشغيل تسجيل الدخول بعد القفز إلى عنوان URL. نحن نوفر casdoor-react-sdk لمساعدتك على تنفيذ هذه الميزة بسرعة. يمكنك رؤية التفاصيل في use-in-react.
كيف يعمل
- في عنوان URL للصفحة الرئيسية للتطبيق، سنحمل المعامل
silentSignin
. - في صفحتك الرئيسية، حدد ما إذا كنت بحاجة إلى تسجيل الدخول بصمت (تلقائيًا) عن طريق التحقق من المعامل
silentSignin
. إذا كانsilentSignin === 1
، فيجب أن تعيد الوظيفة مكونSilentSignin
، الذي سيساعدك على بدء طلب تسجيل الدخول. بما أنك قمت بتفعيل تسجيل الدخول التلقائي، سيقوم المستخدمون بتسجيل الدخول تلقائيًا دون النقر.
أضف تسجيل الدخول المنبثق
ميزة "تسجيل الدخول المنبثق" ستفتح نافذة صغيرة. بعد تسجيل الدخول إلى Casdoor في النافذة الفرعية، سيتم إرسال معلومات المصادقة إلى النافذة الرئيسية ثم يغلق تلقائيًا. نحن ننفذ هذه الميزة عن طريق حمل المعاملات في عنوان URL.
كيفية الاستخدام
استخدم طريقة popupSignin()
في casdoor-js-sdk لتنفيذ هذه الميزة بسرعة. يمكنك رؤية عرض توضيحي في casdoor-nodejs-react-example.
كيف يعمل
- في عنوان URL للصفحة الرئيسية للتطبيق، سنحمل المعامل
popup
. - عندما يكون
popup=1
ضمن معاملات تسجيل الدخول، سيقوم Casdoor بإرسالcode
وstate
كرسالة إلى النافذة الرئيسية وإنهاء الحصول علىtoken
في النافذة الرئيسية باستخدام الـ SDK.
استخدام تسجيل الدخول الموحد
اكتمل التكوين. فيما يلي، سنوضح لك كيفية استخدام تسجيل الدخول التلقائي.
تأكد من أن تطبيقك يمكنه إعادة التوجيه إلى صفحة ملف المستخدم الشخصي. يتم توفير واجهة برمجة التطبيقات getMyProfileUrl(account, returnUrl) في SDK الخاص بنا لكل لغة.
افتح صفحة الملف الشخصي وانتقل إلى صفحة "الرئيسية" (مسار عنوان URL /
). سترى قائمة التطبيقات التي تقدمها المنظمة. من المهم ملاحظة أن المستخدمين في المنظمات غير "المدمجة" فقط يمكنهم رؤية قائمة التطبيقات على صفحة "الرئيسية". جميع المدراء العالميين (أولئك في منظمة "المدمجة") لا يمكنهم رؤيتها.
انقر على مربع في قائمة التطبيقات، وسيقفز إلى عنوان URL للصفحة الرئيسية لذلك التطبيق مع معامل GET ?silentSignin=1
. سيتم تسجيل الدخول تلقائيًا إلى التطبيق إذا كان التطبيق قد تم دمجه مع Casdoor SSO (لذلك سيتعرف على معامل ?silentSignin=1
ويؤدي تسجيل الدخول الصامت في الخلفية).