العربية
  • auth
  • authentication
  • identity
  • integration
  • outline
  • oidc
  • oauth

تبسيط مصادقة Outline باستخدام Logto

في هذه المقالة، سنوضح كيفية استخدام Logto كمزود هوية معتمد لبروتوكول OpenID Connect (OIDC) لـ Outline.

Gao
Gao
Founder

المقدمة

  • Logto هو حل هويات سهل مع جميع الميزات التي تحتاجها. يدعم طرق تسجيل الدخول المختلفة، بما في ذلك اسم المستخدم، البريد الإلكتروني، رقم الهاتف، وتسجيلات الدخول الاجتماعية الشهيرة مثل Google وGitHub.
  • Outline يعمل كقاعدة معرفة للفرق المتزايدة.

الجزء الأفضل هو أن كلاً من Logto وOutline مفتوح المصدر. في هذه المقالة، سنوضّح كيفية استخدام Logto كمزود هوية لـ OpenID Connect لـ Outline.

المتطلبات المسبقة

للبدء، تأكد من أن لديك ما يلي:

  • تشغيل مثيل Logto أو الوصول إلى حساب Logto Cloud.
  • بيئة استضافة Outline مع الوصول إلى متغيرات البيئة.

تهيئة Logto

إذا كنت تستضيف Logto بنفسك، فارجع إلى توثيق Logto "ابدأ" لإعداد مثيل Logto الخاص بك.

افتح Logto Console بإدخال عنوان URL https://cloud.logto.io/ إذا كنت تستخدم Logto Cloud، أو نقطة النهاية التي قمت بإعدادها للاستضافة الذاتية.

افتح Logto Cloud وأكمل التكوين بسهولة

بعد ذلك، انتقل إلى علامة التبويب "التطبيقات" وانقر على "إنشاء تطبيق".

علامة تبويب التطبيقات

في النافذة المنبثقة التي تظهر، اختر "ويب تقليدي" وقدم اسمًا للتطبيق، مثل "Outline". ثم انقر على "إنشاء تطبيق".

إنشاء تطبيق

سيتم توجيهك إلى صفحة تعليمية في Logto. انقر على "تخطي" في الركن العلوي الأيمن للمتابعة إلى صفحة تفاصيل التطبيق.

تفاصيل التطبيقات

في قسم "إعادة التوجيه URIs"، أدخل القيمة التالية:

على سبيل المثال، إذا كنت تستضيف Outline على http://localhost:3000، فيجب أن تكون القيمة:

حفظ التغييرات

انقر على زر "حفظ التغييرات" في الأسفل. بمجرد النجاح، احتفظ بهذه الصفحة مفتوحة لأنها ستكون مفيدة لتكوين Outline.

تهيئة 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احتفظ بالإعداد الافتراضي؛ لا داعي للتعيين

للمستضاف ذاتيًا فقط: تهيئة تسجيل الدخول بالبريد الإلكتروني في Logto

نظرًا لأن Outline يتطلب تقديم بريد إلكتروني للمستخدم، تحتاج إلى تهيئة تسجيل الدخول بالبريد الإلكتروني أو تسجيل الدخول الاجتماعي الذي يقدم عنوان بريد إلكتروني موثوق به، مثل تسجيل الدخول باستخدام Google.

راجع تهيئة الموصلات لمعرفة المزيد عن تهيئة الموصلات في Logto.

نقطة تحقق: اختبر تكامل Logto وOutline

ابدأ مثيل Outline وادخل إلى نقطة النهاية الخاصة به. يجب أن ترى زرًا في الوسط يحمل التسمية "Continue with OpenID Connect"؛ يمكن تخصيصه عن طريق تعيين متغير البيئة OIDC_DISPLAY_NAME.

صفحة تسجيل الدخول لـ Outline

انقر على الزر، وستتوجه إلى تجربة تسجيل الدخول الخاصة بـ Logto.

تجربة تسجيل الدخول لـ Logto

إذا تم تكوين كل شيء بشكل صحيح، بمجرد إتمام عملية تسجيل الدخول أو التسجيل في Logto، ستتم إعادة توجيهك إلى Outline. يمكنك بعد ذلك رؤية معلوماتك الشخصية معروضة في الركن السفلي الأيسر من الصفحة.

صفحة البداية لـ Outline

إذا واجهت أية مشاكل أثناء التكامل، فلا تتردد في الاتصال بنا عبر البريد الإلكتروني [email protected] أو الانضمام إلى خادم Discord الخاص بنا!

قراءات إضافية

جرّب Logto اليوم