انتقل إلى المحتوى
Localtonet Localtonet لوحة التحكم

تسجيل الدخول الموحّد مع GitLab

يتطلب رصيدًا أنفاق HTTP

مساعدة بشأن هذه الصفحة
في هذه الصفحة 4 أقسام
  1. قبل أن تبدأ
  2. الخطوات
  3. أنشئ تطبيق OAuth في GitLab
  4. أضف المزوّد في Localtonet
  5. فعّله لنفق
  6. اختبره
  7. استكشاف الأخطاء
  8. صفحات ذات صلة

دع الزوار يسجّلون الدخول بحساب GitLab الخاص بهم قبل أن يتمكنوا من فتح نفق HTTP. يعمل مع GitLab.com ومع نسخة GitLab مستضافة ذاتيًا. تنشئ تطبيق OAuth في GitLab، وتضيفه إلى Localtonet كمزوّد، ثم تفعّله للنفق.

قبل أن تبدأ #

  • نفق HTTP ورصيد في حسابك. راجع نظرة عامة على تسجيل الدخول الموحّد.
  • حساب GitLab على GitLab.com أو على نسختك الخاصة.
  • بالنسبة إلى نسخة مستضافة ذاتيًا: يجب أن يكون عنوانها قابلًا للوصول من الإنترنت. تفتح متصفحات زوّارك صفحة تسجيل الدخول فيها، ويستدعي مضيف تسجيل الدخول في Localtonet نقطتي التوكن والمستخدم فيها مباشرة.

الخطوات #

  1. أنشئ تطبيق OAuth في GitLab #

    دليل GitLab نفسه هو Configure GitLab as an OAuth 2.0 authentication identity provider. يمكن أن يتبع التطبيق مستخدمًا أو مجموعة أو النسخة كلها:

    المالكأين تنشئه
    المستخدم الخاص بكاختر صورتك الرمزية، ثم Edit profile، ثم Access › Applications وAdd new application.
    مجموعةافتح المجموعة، ثم Settings › Applications.
    النسخة (مستضافة ذاتيًا، للمسؤولين فقط)Admin › Applications وNew application.

    املأ النموذج واختر Save application:

    حقل GitLabالقيمة
    Nameاسم يتعرّف عليه زوّارك. يعرضه GitLab عندما يطلب منهم التفويض.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    Confidentialأبقه محدّدًا.
    Scopesread_user

    يعرض GitLab بعد ذلك Application ID وSecret. انسخهما معًا فورًا: يعرض GitLab السر فقط مباشرة بعد إنشاء التطبيق.

    يمنح النطاق read_user حق قراءة ملف المستخدم الذي سجّل الدخول عبر نقطة النهاية /api/v4/user، وهي نقطة نهاية معلومات المستخدم التي يملؤها Localtonet. وهو النطاق الوحيد الذي يطلبه تسجيل الدخول، فلا يحتاج التطبيق إلى نطاق آخر.

  2. أضف المزوّد في Localtonet #

    افتح أنفاقي › HTTP واختر SSO في أعلى الصفحة. في النافذة مزوّدو SSO، اختر إضافة مزوّد.

    الحقلالقيمة
    اسم المزوّدأي اسم، مثل Company GitLab. ستراه في إعدادات النفق.
    نوع المزوّدGitLab. تغيير نوع مزوّد محفوظ يفرّغ معرّف العميل (Client ID)، فأدخل معرّف العميل وسرّ العميل من جديد.
    نشطمفعّل
    معرّف العميل (Client ID)Application ID من GitLab.
    سر العميل (Client Secret)Secret من GitLab. لا يُعرض أبدًا بعد الحفظ.

    افتح نقاط النهاية ورابط الاستدعاء. تُملأ عناوين GitLab.com تلقائيًا. وبالنسبة إلى نسخة مستضافة ذاتيًا، استبدل gitlab.com باسم مضيف نسختك في الحقول الثلاثة الأولى.

    GitLab.com

    الحقلالقيمة المملوءة
    نقطة نهاية التفويضhttps://gitlab.com/oauth/authorize
    نقطة نهاية التوكن (Token)https://gitlab.com/oauth/token
    نقطة نهاية معلومات المستخدمhttps://gitlab.com/api/v4/user
    مسار الاستدعاء (Callback)/auth/callback/gitlab

    مستضافة ذاتيًا

    الحقلالقيمة التي تدخلها
    نقطة نهاية التفويضhttps://<YOUR_GITLAB_HOST>/oauth/authorize
    نقطة نهاية التوكن (Token)https://<YOUR_GITLAB_HOST>/oauth/token
    نقطة نهاية معلومات المستخدمhttps://<YOUR_GITLAB_HOST>/api/v4/user
    مسار الاستدعاء (Callback)/auth/callback/gitlab (دون تغيير)

    يبقى Redirect URI في تطبيق GitLab هو عنوان Localtonet من الخطوة 1. لا يحتوي على مضيف GitLab الخاص بك.

    املأ اختياريًا قواعد الوصول عبر البريد الإلكتروني، ثم اختر حفظ المزوّد.

  3. فعّله لنفق #

    تحت أنفاقك، اختر الإعدادات على النفق، ثم إدارة بجانب مزوّدو SSO. في النافذة تسجيل الدخول الموحّد، شغّل اشتراط تسجيل الدخول ومفتاح مزوّد GitLab الخاص بك. ثم اختر حفظ.

    على GitLab.com يستطيع أي شخص إنشاء حساب. وبدون قاعدة، يستطيع كل مستخدم في GitLab.com يعرف العنوان فتح النفق. املأ من يمكنه تسجيل الدخول في النفق، أو نطاقات البريد الإلكتروني المسموح بها في المزوّد. تُشرح القوائم في النظرة العامة.

  4. اختبره #

    افتح عنوان النفق في نافذة متصفح خاصة. يعرض Localtonet Sign in to continue مع زر لمزوّدك. يطلب منك GitLab تفويض التطبيق في المرة الأولى. بعد ذلك تُعاد إلى النفق وتُحمَّل خدمتك.

استكشاف الأخطاء #

يقول GitLab إن redirect URI المضمَّن غير صالح

لا يطابق أي Redirect URI في تطبيق GitLab العنوان الذي أُرسل. أدخل http://auth.localtonet.com/auth/callback تمامًا كما هو في Redirect URI الخاص بالتطبيق.

يقول GitLab إن النطاق المطلوب غير صالح أو غير معروف أو سيئ التنسيق

النطاق المطلوب غير محدّد في تطبيق GitLab. عدّل التطبيق وحدّد read_user.

يقول GitLab إن مصادقة العميل فشلت

لا يطابق معرّف العميل (Client ID) أو سر العميل (Client Secret) المحفوظ في Localtonet تطبيق GitLab. الصق Application ID وSecret من جديد واختر حفظ المزوّد. وإذا جدّدت السر في GitLab، يتوقف التطبيق عن العمل حتى تحفظ السر الجديد في Localtonet.

تسجيل الدخول بنسخة مستضافة ذاتيًا لا يكتمل أبدًا

تحقق من نقاط النهاية الثلاث بحثًا عن أخطاء إملائية، وتأكد من أن النسخة تستجيب من الإنترنت. وإذا كانت تستخدم HTTPS فهي تحتاج إلى شهادة يثق بها العملاء العموميون. لا يمكن استخدام نسخة يمكن الوصول إليها داخل شبكتك فقط.

"403 - Access Denied" بعد تسجيل دخول ناجح إلى GitLab

رفضت إحدى قواعد Localtonet الحساب. تحقق من قواعد الوصول عبر البريد الإلكتروني في المزوّد ومن من يمكنه تسجيل الدخول في النفق. بعد تصحيح القاعدة، انتظر دقيقة ثم أعد التحميل.

لا يوجد زر GitLab في صفحة تسجيل الدخول

المزوّد غير مفعّل لهذا النفق، أو هو معيّن كغير نشط. تحقق من الأمرين.

الدعم