تسجيل الدخول الموحّد عبر Microsoft
يتطلب رصيدًا أنفاق HTTP
في هذه الصفحة 6 أقسام
اسمح للزوار بتسجيل الدخول بحساب عمل أو مدرسة في Microsoft Entra ID، أو بحساب Microsoft شخصي، قبل أن يتمكنوا من فتح نفق HTTP. تسجّل تطبيقًا في Microsoft Entra، وتضيفه إلى Localtonet كمزوّد، ثم تفعّله للنفق.
قبل أن تبدأ #
- نفق HTTP ورصيد في حسابك. راجع نظرة عامة على تسجيل الدخول الموحّد.
- إمكانية الوصول إلى مركز إدارة Microsoft Entra بدور يتيح تسجيل التطبيقات. تذكر Microsoft أن الحد الأدنى هو Application Developer.
- قرار بشأن من يحق له تسجيل الدخول: مؤسستك فقط، أو أي مؤسسة، أو الحسابات الشخصية أيضًا. يحدد هذا اثنين من العناوين التي تدخلها في Localtonet. راجع أنواع الحسابات ونقاط النهاية.
الخطوات #
-
تسجيل تطبيق في Microsoft Entra #
أدلة Microsoft نفسها هي Register an app in Microsoft Entra ID وAdd a redirect URI وAdd app credentials. باختصار:
- في مركز إدارة Microsoft Entra، انتقل إلى Entra ID › App registrations واختر New registration.
- أدخل Name. يراه الزوار عند تسجيل الدخول.
- ضمن Supported account types اختر من يستطيع استخدام التطبيق، ثم اختر Register.
- في صفحة Overview انسخ Application (client) ID. وللتطبيق أحادي المستأجر (single-tenant) انسخ أيضًا Directory (tenant) ID.
- ضمن Manage افتح Authentication، واختر Add Redirect URI، واختر المنصة Web، وأدخل عنوان إعادة التوجيه أدناه ثم اختر Configure.
- افتح 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.
-
إضافة المزوّد في 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لا. يمكنك اختياريًا ملء قواعد الوصول عبر البريد الإلكتروني، ثم اختر حفظ المزوّد.
-
تفعيله لنفق #
ضمن أنفاقك اختر الإعدادات على النفق، ثم إدارة بجوار مزوّدو SSO. في نافذة تسجيل الدخول الموحّد فعّل اشتراط تسجيل الدخول ومفتاح مزوّد Microsoft الخاص بك. اختر حفظ.
القائمتان ضمن من يمكنه تسجيل الدخول ومسارات تسجيل الدخول اختياريتان. وهما مشروحتان في النظرة العامة.
-
اختبره #
افتح رابط النفق في نافذة متصفح خاصة. يعرض Localtonet Sign in to continue مع زر لمزوّدك. بعد تسجيل الدخول في Microsoft تُعاد إلى النفق وتُحمَّل خدمتك.
أنواع الحسابات ونقاط النهاية #
الجزء من عنوان Microsoft الذي يلي login.microsoftonline.com/ يتحكم في من يستطيع تسجيل الدخول. ويجب أن يناسب Supported account types الخاصة بتطبيقك. تحصل نقطة نهاية التفويض ونقطة نهاية التوكن (Token) دائمًا على القيمة نفسها. أما نقطة نهاية معلومات المستخدم فلا تتغير أبدًا.
| Supported account types في Microsoft Entra | استخدمه بدلًا من common | من يمكنه تسجيل الدخول |
|---|---|---|
| Single tenant only | Directory (tenant) ID الخاص بك | مستخدمو مستأجرك وضيوفه. |
| Multiple Entra ID tenants | organizations | حسابات العمل أو المدرسة لأي مؤسسة. |
| Any Entra ID Tenant + Personal Microsoft accounts | أبقِ common | حسابات العمل أو المدرسة وحسابات Microsoft الشخصية. |
| Personal accounts only | consumers | حسابات Microsoft الشخصية. |
مثال لتطبيق أحادي المستأجر. استبدل <TENANT_ID> بـ Directory (tenant) ID الخاص بك:
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 الحساب. تحقق من قواعد الوصول عبر البريد الإلكتروني على المزوّد ومن يمكنه تسجيل الدخول على النفق، وهل للحساب عنوان بريد إلكتروني أصلًا. بعد تصحيح القاعدة انتظر دقيقة وأعد التحميل.