تسجيل الدخول الموحّد عبر GitHub
يتطلب رصيدًا أنفاق HTTP
في هذه الصفحة 4 أقسام
اسمح للزوار بتسجيل الدخول بحساب GitHub الخاص بهم قبل أن يتمكنوا من فتح نفق HTTP. تسجّل تطبيق OAuth على GitHub، وتضيفه إلى Localtonet كمزوّد، ثم تفعّله للنفق.
قبل أن تبدأ #
- نفق HTTP ورصيد في حسابك. راجع نظرة عامة على تسجيل الدخول الموحّد.
- حساب GitHub. ولتسجيل التطبيق لمؤسسة، تحتاج إلى الوصول إلى إعدادات تلك المؤسسة.
الخطوات #
-
تسجيل تطبيق OAuth على GitHub #
دليل GitHub نفسه هو Creating an OAuth app. باختصار:
- في GitHub افتح القائمة أسفل صورة ملفك الشخصي واختر Settings، ثم Developer settings، ثم OAuth apps.
- اختر New OAuth App. وإذا لم يكن لديك تطبيق بعد فسيكون الزر Register a new application.
- املأ النموذج بالقيم أدناه ثم اختر Register application.
- في صفحة التطبيق الجديد انسخ Client ID، ثم اختر Generate a new client secret وانسخ السر فورًا.
حقل GitHub القيمة Application name اسم يتعرّف عليه زوارك. يعرضه GitHub عندما يطلب منهم التفويض. Homepage URL عنوان ويب يصف التطبيق، مثل موقعك الإلكتروني. Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow اتركه متوقفًا. لا تحدد النطاقات (scopes) على GitHub. فطلب تسجيل الدخول يذكرها:
read:userوuser:email. يطلب GitHub من الزائر الموافقة عليها عند أول تسجيل دخول. -
إضافة المزوّد في Localtonet #
افتح أنفاقي › HTTP واختر SSO في أعلى الصفحة. في نافذة مزوّدو SSO اختر إضافة مزوّد.
الحقل القيمة اسم المزوّد أي اسم، مثل GitHub. تراه في إعدادات النفق.نوع المزوّد GitHub. يؤدي تغيير نوع مزوّد محفوظ إلى تفريغ معرّف العميل (Client ID)، لذا أدخل معرّف العميل وسر العميل مرة أخرى. نشط مفعّل معرّف العميل (Client ID) معرّف العميل من GitHub. سر العميل (Client Secret) سر العميل من GitHub. لا يُعرض أبدًا بعد الحفظ. ضمن نقاط النهاية ورابط الاستدعاء تُملأ عناوين GitHub القياسية تلقائيًا. اتركها كما هي:
الحقل القيمة المملوءة نقطة نهاية التفويض https://github.com/login/oauth/authorizeنقطة نهاية التوكن (Token) https://github.com/login/oauth/access_tokenنقطة نهاية معلومات المستخدم https://api.github.com/userمسار الاستدعاء (Callback) /auth/callback/githubيمكنك اختياريًا ملء قواعد الوصول عبر البريد الإلكتروني، ثم اختر حفظ المزوّد.
-
تفعيله لنفق #
ضمن أنفاقك اختر الإعدادات على النفق، ثم إدارة بجوار مزوّدو SSO. في نافذة تسجيل الدخول الموحّد فعّل اشتراط تسجيل الدخول ومفتاح مزوّد GitHub الخاص بك. اختر حفظ.
يستطيع أي شخص إنشاء حساب GitHub. ومن دون قاعدة، يستطيع كل مستخدم GitHub يعرف العنوان فتح النفق. املأ من يمكنه تسجيل الدخول على النفق، أو نطاقات البريد الإلكتروني المسموح بها على المزوّد. القوائم مشروحة في النظرة العامة.
-
اختبره #
افتح رابط النفق في نافذة متصفح خاصة. يعرض Localtonet Sign in to continue مع زر لمزوّدك. يطلب منك GitHub تفويض التطبيق في المرة الأولى. بعد ذلك تُعاد إلى النفق وتُحمَّل خدمتك.
استكشاف الأخطاء وإصلاحها #
يبلّغ GitHub عن عدم تطابق عنوان إعادة التوجيه
خطأ GitHub هو redirect_uri_mismatch: "The redirect_uri MUST match the registered callback URL for this application." لا يطابق أي عنوان استدعاء في تطبيق OAuth العنوان الذي أُرسل. اضبط Authorization callback URL على GitHub بالضبط على http://auth.localtonet.com/auth/callback.
يُرفض زائر رغم أن عنوانه في القائمة
قد لا تعيد نقطة نهاية معلومات المستخدم الافتراضية، https://api.github.com/user، أي عنوان بريد إلكتروني عندما لا يكون مستخدم GitHub قد حدد بريدًا عامًا في ملفه الشخصي. اطلب من الزائر التحقق من العنوان المضبوط كبريد عام في ملفه الشخصي على GitHub، وقارنه بقوائمك.
"403 - Access Denied" بعد تسجيل دخول ناجح في GitHub
رفضت إحدى قواعد Localtonet الحساب. تحقق من قواعد الوصول عبر البريد الإلكتروني على المزوّد ومن يمكنه تسجيل الدخول على النفق. بعد تصحيح القاعدة انتظر دقيقة وأعد التحميل.
يفشل تسجيل الدخول قبل صفحة التفويض في GitHub أو بعدها
قارن معرّف العميل (Client ID) وسر العميل (Client Secret) المحفوظين في Localtonet بتطبيق OAuth. الصق معرّف العميل مرة أخرى، وأنشئ سر عميل جديدًا على GitHub، والصقه في المزوّد، ثم اختر حفظ المزوّد.
لا يوجد زر GitHub في صفحة تسجيل الدخول
المزوّد غير مفعّل لهذا النفق، أو مضبوط على غير نشط. تحقق من الأمرين.