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

تسجيل الدخول الموحّد لأنفاق HTTP

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

مساعدة بشأن هذه الصفحة
في هذه الصفحة 10 أقسام
  1. متى تستخدمه
  2. كيف يعمل
  3. قبل أن تبدأ
  4. المزوّدون
  5. الإعداد
  6. إضافة مزوّد
  7. تفعيله لنفق
  8. اختبره
  9. رابط إعادة التوجيه (Redirect URI)
  10. قواعد الوصول
  11. مسارات تسجيل الدخول ومسار تسجيل الخروج
  12. استكشاف الأخطاء وإصلاحها
  13. الأتمتة

يضع تسجيل الدخول الموحّد (SSO) صفحة تسجيل دخول أمام نفق HTTP. يسجّل الزوار الدخول عبر مزوّد هوية تختاره، مثل Google أو GitHub أو Microsoft أو GitLab، أو باسم مستخدم وكلمة مرور تحددهما أنت، قبل أن يصل أي طلب إلى خدمتك.

متى تستخدمه #

ما لم تحمِه، يبقى نفق HTTP مفتوحًا لكل من يعرف عنوانه. SSO هو الحماية المناسبة عندما يفتح الناس النفق في المتصفح وتريد أن تقرر من هم: لوحة إدارة، أو لوحة معلومات، أو أداة داخلية، أو موقع تجريبي. لا تتغير خدمتك ولا ترى كلمة مرور أبدًا.

SSO مصمم للمتصفحات. الطلب الذي لا يحمل كوكي تسجيل الدخول يُعاد توجيهه إلى صفحة تسجيل الدخول، ولذلك لا تستطيع السكربتات وwebhooks وعملاء API المرور. لهذه الحالات، احمِ بعض المسارات فقط (راجع مسارات تسجيل الدخول) أو استخدم الخيارات في التحكم في الوصول.

كيف يعمل #

يفتح الزائر رابط النفق. يعيد خادم Localtonet توجيه الزائر إلى صفحة تسجيل الدخول على auth.localtonet.com، حيث يسجّل الدخول عبر مزوّد هوية. ثم يُعاد الزائر إلى رابط النفق ويُمرَّر الطلب إلى خدمتك. الزائر المتصفح 1. يفتح رابط النفق خادم Localtonet 2. إعادة توجيه صفحة تسجيل الدخول auth.localtonet.com 3. تسجيل الدخول المزوّد Google, GitHub… 4. تم تسجيل الدخول، والعودة إلى النفق 5. الطلب خدمتك على جهازك
يتم تسجيل الدخول في صفحة تسجيل الدخول الخاصة بـ Localtonet، لا في خدمتك.
  1. يفتح الزائر رابط النفق. الطلب عبر HTTP يُعاد توجيهه أولًا إلى HTTPS.
  2. لم يسجّل الزائر الدخول بعد، فيعيد خادم Localtonet توجيه المتصفح إلى صفحة تسجيل الدخول على auth.localtonet.com. عنوان الصفحة Sign in to continue وتعرض المزوّدين الذين فعّلتهم لهذا النفق.
  3. يختار الزائر مزوّدًا ويسجّل الدخول هناك. وفي حالة مزوّد اسم المستخدم وكلمة المرور، يكون النموذج في صفحة تسجيل الدخول نفسها.
  4. يتحقق Localtonet من قواعد الوصول لديك ويعيد الزائر إلى العنوان الذي طلبه. يُحفظ تسجيل الدخول في كوكي خاص باسم مضيف النفق. وهو كوكي جلسة متصفح يُرسل عبر HTTPS فقط.
  5. ومن ثم تُمرَّر الطلبات إلى خدمتك كالمعتاد. وعندما لا يعود تسجيل الدخول صالحًا، يُوجَّه الزائر إلى صفحة تسجيل الدخول مرة أخرى.

الزائر الذي يسجّل الدخول لكن قواعدك لا تسمح له يرى 403 - Access Denied مع النص "You do not have permission to access this tunnel."

المسارات تحت /.well-known لا توضع خلف تسجيل الدخول أبدًا.

قبل أن تبدأ #

  • نفق HTTP. راجع HTTP / HTTPS.
  • رصيد في حسابك. بدونه يفشل حفظ مزوّد أو تفعيل تسجيل الدخول مع الرسالة «تحتاج إلى شراء رصيد لاستخدام هذه الميزة.» راجع الخطط والرصيد والأسعار.
  • للمزوّد الخارجي: حساب لديه يتيح لك تسجيل تطبيق OAuth.

يُعدّ SSO في لوحة التحكم الشخصية. الزر SSO والإعداد مزوّدو SSO لا يظهران لأنفاق الفريق.

المزوّدون #

تغطي هذه الأدلة الخيارات الأكثر شيوعًا خطوة بخطوة:

تحتوي قائمة نوع المزوّد في لوحة التحكم على: Username-Password وGoogle وGitHub وMicrosoft وOpenID Connect وDiscord وTwitter (X) وCustom وFacebook وApple وLinkedIn وGitLab وSlack وSpotify وTwitch وReddit وBitbucket وAmazon وYahoo. وفي كل نوع عدا Username-Password وCustom تُملأ نقاط النهاية تلقائيًا. أما في OpenID Connect فالعناوين المملوءة أمثلة تستبدلها بنقاط نهاية مزوّدك.

الإعداد #

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

  1. إضافة مزوّد #

    افتح أنفاقي › HTTP وحدد SSO أعلى الصفحة (تلميحه إعدادات مزوّد SSO). تُفتح نافذة مزوّدو SSO. حدد إضافة مزوّد واملأ النموذج ثم حدد حفظ المزوّد. يُحفظ كل مزوّد على حدة.

    الحقلما هوملاحظات
    اسم المزوّداسم لتعريف هذا المزوّد في إعدادات النفق.مطلوب. مثلًا Company Google.
    نوع المزوّدطريقة تسجيل الدخول.يبدأ المزوّد الجديد بنوع Google. تغيير نوع مزوّد محفوظ يفرّغ معرّف العميل (Client ID)، فأدخل معرّف العميل والسر من جديد.
    نشطيجعل المزوّد متاحًا للأنفاق.عندما تحوّل مزوّدًا إلى غير نشط وتحفظ، يُوقَف أيضًا في كل نفق كان يستخدمه.
    معرّف العميل (Client ID)معرّف التطبيق الذي سجّلته لدى المزوّد.مطلوب لكل نوع عدا Username-Password وCustom.
    سر العميل (Client Secret)سر ذلك التطبيق.لا يُعرض أبدًا بعد الحفظ. اتركه فارغًا لاحقًا للإبقاء على السر المحفوظ.
    نقاط النهاية ورابط الاستدعاءنقطة نهاية التفويض ونقطة نهاية التوكن (Token) ونقطة نهاية معلومات المستخدم ومسار الاستدعاء (Callback).تُملأ تلقائيًا للمزوّدين القياسيين. لا تغيّرها إلا عندما يطلب منك دليل ذلك.
    قواعد الوصول عبر البريد الإلكترونينطاقات البريد الإلكتروني المسموح بها ونطاقات البريد الإلكتروني المحظورة وعناوين البريد الإلكتروني المحظورة.اختياري. راجع قواعد الوصول.
    مستخدمو تسجيل الدخولأسماء المستخدمين وكلمات المرور.للنوعين Username-Password وCustom فقط.

    لإزالة مزوّد، حدد حذف المزوّد. يزيله هذا من حسابك ومن إعدادات SSO في أنفاقك.

  2. تفعيله لنفق #

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

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

    حدد حفظ.

  3. اختبره #

    افتح رابط النفق في نافذة متصفح خاصة. يجب أن تصل إلى صفحة Sign in to continue، وبعد تسجيل الدخول إلى خدمتك.

رابط إعادة التوجيه (Redirect URI) #

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

Redirect URI
http://auth.localtonet.com/auth/callback

يخبرك دليل كل مزوّد بمكان إدخالها.

القيمةأين توضع
رابط إعادة التوجيه أعلاهلدى المزوّد: Authorized redirect URIs (Google) وAuthorization callback URL (GitHub) وRedirect URI (Microsoft وGitLab).
مسار الاستدعاء (Callback)، مثلًا /auth/callback/googleفي Localtonet، تحت نقاط النهاية ورابط الاستدعاء. يُملأ تلقائيًا. اتركه كما هو.

يقارن المزوّد رابط إعادة التوجيه بالقيمة المسجّلة مقارنة تامة، فانسخه كما هو معروض هنا.

قواعد الوصول #

يثبت تسجيل الدخول هوية الزائر. وتقرر القواعد ما إذا كان يجوز لذلك الشخص فتح النفق. هناك مستويان، وكلاهما يُطبَّق.

أينالقائمةما تقوله لوحة التحكم
المزوّدنطاقات البريد الإلكتروني المسموح بهااتركه فارغًا لعدم وضع قيد على النطاقات. تعتمد أحرف البدل على المزوّد.
المزوّدنطاقات البريد الإلكتروني المحظورةاحظر تسجيل الدخول من نطاقات البريد الإلكتروني هذه.
المزوّدعناوين البريد الإلكتروني المحظورةاحظر عناوين البريد الإلكتروني الفردية هذه.
النفقعناوين البريد الإلكتروني ونطاقات البريد الإلكتروني وأسماء المستخدميناترك القائمة فارغة لتخطي ذلك الفحص. وتُطبَّق القوائم على جميع المزوّدين المفعّلين للنفق.

أدخل عنصرًا واحدًا في كل سطر، أو افصل العناصر بفواصل. يُدخل النطاق بدون @، مثلًا example.com.

بعد تغيير قاعدة، قد يحتفظ الزائر الذي سُمح له بالدخول بالوصول لمدة تصل إلى خمس دقائق. أما الزائر الذي رُفض فيُفحص مرة أخرى بعد دقيقة واحدة.

مسارات تسجيل الدخول ومسار تسجيل الخروج #

الإعدادالسلوكمثال
مسارات تسجيل الدخولفارغة: كل مسار في النفق يتطلب تسجيل الدخول. معبأة: فقط الطلبات التي يبدأ مسارها بأحد العناصر تتطلب تسجيل الدخول./admin يشمل /admin و/admin/users، ولا يشمل /administrator.
مسار تسجيل الخروجفتحه يزيل تسجيل الدخول لهذا النفق ويوجّه الزائر إلى صفحة بداية النفق، أو إلى العنوان الموجود في قيمة الاستعلام returnUrl./sso/logout

تبدأ المسارات بشرطة مائلة. ولا فرق بين الأحرف الكبيرة والصغيرة.

قائمة مسارات تسجيل الدخول المعبأة تترك كل ما عداها مفتوحًا. مع وجود /admin في القائمة، يُحمى /admin فقط وتبقى جميع المسارات الأخرى متاحة بدون تسجيل دخول. اترك القائمة فارغة لحماية النفق كله.

مسار تسجيل الخروج يُخرج الزائر من النفق فقط. ولا يُخرجه من Google أو GitHub أو أي مزوّد هوية آخر.

استكشاف الأخطاء وإصلاحها #

«تحتاج إلى شراء رصيد لاستخدام هذه الميزة.»

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

«أضف مزوّدًا قبل تفعيل تسجيل الدخول.»

ليس لديك مزوّد نشط بعد. حدد إضافة مزوّد في النافذة، أو استخدم الزر SSO أعلى صفحة HTTP.

«فعّل مزوّدًا واحدًا على الأقل، أو أوقف تسجيل الدخول.»

اشتراط تسجيل الدخول مفعّل لكن لا يوجد مفتاح مزوّد مفعّل. المزوّد الذي تجعله غير نشط يُوقَف في أنفاقه ولا يظهر في القائمة بعد ذلك.

تقول صفحة تسجيل الدخول "No authentication providers are currently configured for this tunnel."

تسجيل الدخول مطلوب لكن لا يوجد مزوّد مفعّل لهذا النفق. افتح مزوّدو SSO › إدارة على النفق وفعّل واحدًا.

يُفتح النفق دون طلب تسجيل الدخول

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

"403 - Access Denied" بعد تسجيل الدخول

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

يتلقى webhook أو عميل API إعادة توجيه بدل الرد

الطلبات التي لا تحمل كوكي تسجيل الدخول تُعاد توجيهها إلى صفحة تسجيل الدخول. ضع في مسارات تسجيل الدخول الصفحات المخصصة للأشخاص فقط، أو استخدم نفقًا منفصلًا لحركة الآلات.

الأتمتة #

يمكن أيضًا إدارة المزوّدين وإعدادات SSO للنفق عبر API، تحت /api/v2/sso-providers، وعبر خادم MCP.

الدعم