في هذه المقالة، سنوضح كيفية استخدام Logto كمزود هوية معتمد لبروتوكول OpenID Connect (OIDC) لـ Outline.
الجزء الأفضل هو أن كلاً من Logto وOutline مفتوح المصدر. في هذه المقالة، سنوضّح كيفية استخدام Logto كمزود هوية لـ OpenID Connect لـ Outline.
للبدء، تأكد من أن لديك ما يلي:
إذا كنت تستضيف Logto بنفسك، فارجع إلى توثيق Logto "ابدأ" لإعداد مثيل Logto الخاص بك.
افتح Logto Console بإدخال عنوان URL https://cloud.logto.io/ إذا كنت تستخدم Logto Cloud، أو نقطة النهاية التي قمت بإعدادها للاستضافة الذاتية.
بعد ذلك، انتقل إلى علامة التبويب "التطبيقات" وانقر على "إنشاء تطبيق".
في النافذة المنبثقة التي تظهر، اختر "ويب تقليدي" وقدم اسمًا للتطبيق، مثل "Outline". ثم انقر على "إنشاء تطبيق".
سيتم توجيهك إلى صفحة تعليمية في Logto. انقر على "تخطي" في الركن العلوي الأيمن للمتابعة إلى صفحة تفاصيل التطبيق.
في قسم "إعادة التوجيه URIs"، أدخل القيمة التالية:
على سبيل المثال، إذا كنت تستضيف Outline على http://localhost:3000، فيجب أن تكون القيمة:
انقر على زر "حفظ التغييرات" في الأسفل. بمجرد النجاح، احتفظ بهذه الصفحة مفتوحة لأنها ستكون مفيدة لتكوين Outline.
اتبع الخطوات الموضحة في دليل استضافة Outline حتى تصل إلى خطوة تكوين المصادقة. نظرًا لأن Outline يدعم موفري المصادقة المتوافقين مع OIDC بشكل افتراضي، يمكنك بسهولة العثور على معظم قيم التكوين المطلوبة في صفحة تفاصيل تطبيق Logto.
ارجع إلى الجدول التالي للحصول على تفاصيل التكوين الضرورية:
| متغير بيئة Outline | اسم العرض في Logto |
|---|---|
| OIDC_CLIENT_ID | معرف التطبيق |
| OIDC_CLIENT_SECRET | سر التطبيق |
| OIDC_AUTH_URI | نقطة نهاية التفويض |
| OIDC_TOKEN_URI | نقطة نهاية الرمز |
| OIDC_USERINFO_URI | نقطة نهاية معلومات المستخدم |
هنا جدول آخر يحتوي على متغيرات إضافية:
| متغير بيئة Outline | الوصف |
|---|---|
| OIDC_USERNAME_CLAIM | تعيين إلى اسم المستخدم |
| OIDC_DISPLAY_NAME | اختياري - تخصيص حسب الحاجة |
| OIDC_SCOPES | احتفظ بالإعداد الافتراضي؛ لا داعي للتعيين |
نظرًا لأن Outline يتطلب تقديم بريد إلكتروني للمستخدم، تحتاج إلى تهيئة تسجيل الدخول بالبريد الإلكتروني أو تسجيل الدخول الاجتماعي الذي يقدم عنوان بريد إلكتروني موثوق به، مثل تسجيل الدخول باستخدام Google.
راجع تهيئة الموصلات لمعرفة المزيد عن تهيئة الموصلات في Logto.
ابدأ مثيل Outline وادخل إلى نقطة النهاية الخاصة به. يجب أن ترى زرًا في الوسط يحمل التسمية "Continue with OpenID Connect"؛ يمكن تخصيصه عن طريق تعيين متغير البيئة OIDC_DISPLAY_NAME.
انقر على الزر، وستتوجه إلى تجربة تسجيل الدخول الخاصة بـ Logto.
إذا تم تكوين كل شيء بشكل صحيح، بمجرد إتمام عملية تسجيل الدخول أو التسجيل في Logto، ستتم إعادة توجيهك إلى Outline. يمكنك بعد ذلك رؤية معلوماتك الشخصية معروضة في الركن السفلي الأيسر من الصفحة.
إذا واجهت أية مشاكل أثناء التكامل، فلا تتردد في الاتصال بنا عبر البريد الإلكتروني [email protected] أو الانضمام إلى خادم Discord الخاص بنا!