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

تسجيل الدخول الموحّد عبر Microsoft

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

مساعدة بشأن هذه الصفحة
في هذه الصفحة 6 أقسام
  1. قبل أن تبدأ
  2. الخطوات
  3. تسجيل تطبيق في Microsoft Entra
  4. إضافة المزوّد في Localtonet
  5. تفعيله لنفق
  6. اختبره
  7. أنواع الحسابات ونقاط النهاية
  8. ما الذي يقرؤه Localtonet من Microsoft
  9. استكشاف الأخطاء وإصلاحها
  10. صفحات ذات صلة

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

قبل أن تبدأ #

الخطوات #

  1. تسجيل تطبيق في Microsoft Entra #

    أدلة Microsoft نفسها هي Register an app in Microsoft Entra ID وAdd a redirect URI وAdd app credentials. باختصار:

    1. في مركز إدارة Microsoft Entra، انتقل إلى Entra ID › App registrations واختر New registration.
    2. أدخل Name. يراه الزوار عند تسجيل الدخول.
    3. ضمن Supported account types اختر من يستطيع استخدام التطبيق، ثم اختر Register.
    4. في صفحة Overview انسخ Application (client) ID. وللتطبيق أحادي المستأجر (single-tenant) انسخ أيضًا Directory (tenant) ID.
    5. ضمن Manage افتح Authentication، واختر Add Redirect URI، واختر المنصة Web، وأدخل عنوان إعادة التوجيه أدناه ثم اختر Configure.
    6. افتح Certificates & secrets › Client secrets واختر New client secret. أضف وصفًا، واختر مدة انتهاء، ثم اختر Add. انسخ Value الخاصة بالسر فورًا: لا تعرضها Microsoft مرة أخرى بعد مغادرة الصفحة.
    Redirect URI (platform: Web)
    http://auth.localtonet.com/auth/callback

    ينتهي السر الخاص بالعميل (client secret). تحدد Microsoft عمره بـ 24 شهرًا. وعند انتهائه يتوقف تسجيل الدخول عن العمل إلى أن تنشئ سرًا جديدًا وتحفظه في مزوّد Localtonet.

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

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

    الحقلالقيمة
    اسم المزوّدأي اسم، مثل Company Microsoft. تراه في إعدادات النفق.
    نوع المزوّدMicrosoft. يؤدي تغيير نوع مزوّد محفوظ إلى تفريغ معرّف العميل (Client ID)، لذا أدخل معرّف العميل وسر العميل مرة أخرى.
    نشطمفعّل
    معرّف العميل (Client ID)Application (client) ID من Microsoft Entra.
    سر العميل (Client Secret)Value الخاصة بالسر، لا Secret ID. لا تُعرض أبدًا بعد الحفظ.

    افتح نقاط النهاية ورابط الاستدعاء. تُملأ هذه القيم تلقائيًا:

    الحقلالقيمة المملوءةهل تغيّرها؟
    نقطة نهاية التفويضhttps://login.microsoftonline.com/common/oauth2/v2.0/authorizeاستبدل common وفق الجدول في القسم التالي.
    نقطة نهاية التوكن (Token)https://login.microsoftonline.com/common/oauth2/v2.0/tokenاستبدل common بالقيمة نفسها المذكورة أعلاه.
    نقطة نهاية معلومات المستخدمhttps://graph.microsoft.com/oidc/userinfoلا. فهي لا تتضمن مستأجرًا (tenant).
    مسار الاستدعاء (Callback)/auth/callback/microsoftلا.

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

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

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

    القائمتان ضمن من يمكنه تسجيل الدخول ومسارات تسجيل الدخول اختياريتان. وهما مشروحتان في النظرة العامة.

  4. اختبره #

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

أنواع الحسابات ونقاط النهاية #

الجزء من عنوان Microsoft الذي يلي login.microsoftonline.com/ يتحكم في من يستطيع تسجيل الدخول. ويجب أن يناسب Supported account types الخاصة بتطبيقك. تحصل نقطة نهاية التفويض ونقطة نهاية التوكن (Token) دائمًا على القيمة نفسها. أما نقطة نهاية معلومات المستخدم فلا تتغير أبدًا.

Supported account types في Microsoft Entraاستخدمه بدلًا من commonمن يمكنه تسجيل الدخول
Single tenant onlyDirectory (tenant) ID الخاص بكمستخدمو مستأجرك وضيوفه.
Multiple Entra ID tenantsorganizationsحسابات العمل أو المدرسة لأي مؤسسة.
Any Entra ID Tenant + Personal Microsoft accountsأبقِ commonحسابات العمل أو المدرسة وحسابات Microsoft الشخصية.
Personal accounts onlyconsumersحسابات Microsoft الشخصية.

مثال لتطبيق أحادي المستأجر. استبدل <TENANT_ID> بـ Directory (tenant) ID الخاص بك:

Single tenant
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint:         https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint:     https://graph.microsoft.com/oidc/userinfo

التطبيق أحادي المستأجر لا يعمل مع common. تردّ Microsoft بالخطأ AADSTS50194. إما أن تضع معرّف المستأجر في نقطتي النهاية كلتيهما، أو تغيّر التطبيق إلى نوع حساب متعدد المستأجرين.

مع نوع حساب متعدد المستأجرين أو شخصي، يستطيع أشخاص من خارج مؤسستك تسجيل الدخول في Microsoft. استخدم نطاقات البريد الإلكتروني المسموح بها على المزوّد، أو من يمكنه تسجيل الدخول على النفق، لقبول الأشخاص الذين تريدهم فقط.

ما الذي يقرؤه Localtonet من Microsoft #

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

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

AADSTS50011: the reply URL does not match

عنوان إعادة التوجيه في الطلب غير مسجّل للتطبيق. تعرض الرسالة العنوان الذي أُرسل. ويجب أن يطابق تمامًا عنوان إعادة توجيه في صفحة Authentication بتسجيل التطبيق، على المنصة Web، بما في ذلك حالة الأحرف. سجّل بالضبط http://auth.localtonet.com/auth/callback.

AADSTS50194: the application is not configured as a multitenant application

التطبيق أحادي المستأجر، لكن نقطتي النهاية ما زالتا تحتويان على common. استبدل common بـ Directory (tenant) ID في نقطة نهاية التفويض ونقطة نهاية التوكن (Token)، ثم اختر حفظ المزوّد.

AADSTS700016: the application was not found in the directory

معرّف العميل (Client ID) خاطئ، أو أن نقطتي النهاية تشيران إلى مستأجر لا يوجد فيه التطبيق. تحقق من Application (client) ID ومعرّف المستأجر في نقطتي النهاية.

AADSTS7000215 أو AADSTS7000222: سر عميل غير صالح أو منتهي

أنشئ سر عميل جديدًا ضمن Certificates & secrets، والصق Value الخاصة به في سر العميل (Client Secret) في Localtonet ثم اختر حفظ المزوّد.

تطلب Microsoft موافقة المسؤول

لا يسمح مستأجرك للمستخدمين بالموافقة على التطبيقات بأنفسهم. يجب أن يمنح مسؤول المستأجر الموافقة على التطبيق في مركز إدارة Microsoft Entra.

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

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

الدعم