M365Con 2027 – مؤتمر مجاني عبر الإنترنت · 11–22 Jan 2027 · 120 sessions m365con.net

المدونة · Mirko Peters

AADSTS900561: خطأ "نقطة النهاية تقبل طلبات POST فقط"

By · · Updated

تعرّف على الخطأ AADSTS900561 (Endpoint only accepts POST)، وسبب ظهوره أثناء تسجيل الدخول إلى Microsoft Entra، وكيفية استكشافه وإصلاحه بأمان.

Automatically translated with AI from the original post. Read the English original

غلاف: إصلاح الوصول الشرطي لـ Microsoft Entra ID ودَين الهوية

الإجابة السريعة: يعني الخطأ AADSTS900561 (Endpoint only accepts POST) أن نقطة نهاية المصادقة في Microsoft Entra استقبلت طلبًا باستخدام أسلوب غير مدعوم. تحقّق من تدفق تسجيل الدخول في التطبيق، ومن معالجة إعادة التوجيه، ومن عنوان URL الدقيق الذي يتم فتحه، بدلًا من تغيير إعدادات الهوية على مستوى المستأجر بشكل متكرر.

هل واجهت الخطأ AADSTS900561 أثناء العمل مع Microsoft Entra ID أو Azure Active Directory؟ هذا هو الخطأ الذي يقول: «Endpoint only accepts POST requests». بلغة بسيطة، يعني ذلك أن تطبيقك حاول التواصل مع خدمة المصادقة من Microsoft باستخدام طلب GET، بينما يتوقع الخادم طلب POST. الأمر أشبه بالطرق على الباب الخلفي بينما كان ينبغي استخدام الباب الأمامي.

يظهر هذا الخطأ كثيرًا عند تطوير التطبيقات أو دمجها مع Microsoft 365 أو Azure أو Power Platform. وغالبًا ما يحدث أثناء تدفقات تسجيل الدخول، أو عند محاولة الحصول على رمز مميز من منصة الهوية لدى Microsoft. ومعرفة ما يُشغّل الخطأ AADSTS900561 أمر أساسي، لأنه يوجهك مباشرة إلى المكان الذي لا تتوافق فيه استدعاءات المصادقة لديك مع المتطلبات التقنية لدى Microsoft. وفيما يلي نفصّل سبب إطلاق هذا الخطأ، وكيف يرتبط برمز خطأ آخر معروف هو AADSTS90056.

وصف الخطأين AADSTS90056 وAADSTS900561 وخلفيتهما

قبل أن تبدأ في إصلاح الخطأ AADSTS900561، من المفيد أن تعرف بدقة ما الذي تتعامل معه. كلا الخطأين AADSTS90056 وAADSTS900561 هما رمزا خطأ تُطلقهما Microsoft Entra ID (المعروفة سابقًا باسم Azure AD) عندما تكون طريقة تواصل تطبيقك مع نقاط نهاية المصادقة غير صحيحة. والخلاصة المختصرة: يشير الخطأ AADSTS90056 عادةً إلى معامل مصادقة خاطئ أو مفقود، بينما يركّز الخطأ AADSTS900561 تحديدًا على مشكلات أسلوب HTTP، وتحديدًا عند استخدام GET في حين يُشترط POST.

تعتمد Microsoft Entra ID قواعد بروتوكول صارمة لتبادل الرموز المميزة وتدفقات المصادقة، وغالبًا ما تكون مبنية على OAuth 2.0. وعندما يحتاج تطبيقك إلى الحصول على رمز مميز عبر الوصول إلى نقطة النهاية /token، تتوقع Microsoft منك إرسال طلب POST. وليس هذا تشددًا غير مبرر، بل إن طلبات POST تتيح إرسال البيانات الحساسة بأمان داخل نص الطلب (Request Body) لا في عنوان URL، مما يقلل من مخاطر التسريب أو التسجيل العرضي.

أما طلبات GET فهي على العكس من ذلك مكشوفة تمامًا، إذ تضع تفاصيلك في عنوان URL، فيستطيع أي شخص أو أي وكيل وسيط على الطريق رؤيتها. وهذا يمثل مشكلة أمنية، خاصة بالنسبة إلى الخدمات المؤسسية التي تدير الهويات والبيانات الحساسة. لذلك تفرض منصة الهوية لدى Microsoft استخدام POST لأي إجراء يتضمن تبادل أسرار أو رموز أو معلومات المستخدم. وإذا أرسلت طلب GET، تكتشف المنصة ذلك وتوقف الطلب بالخطأ AADSTS900561. ويساعدك فهم هذه الخلفية التقنية على إدراك ما الذي أخطأت فيه، ولماذا وُضعت هذه القاعدة، ولماذا لا يمكن التهاون فيها عبر خدمات السحابة من Microsoft.

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

الأسباب الشائعة وحلولها لمشكلات المصادقة AADSTS900561

إذا ظهر الخطأ AADSTS900561، فمن المرجح جدًا وجود خطأ في الطريقة التي يتواصل بها تطبيقك مع نقطة نهاية الرموز المميزة لدى Microsoft. ومن أبرز الأسباب تسجيل التطبيق بإعدادات غير صحيحة، أو وجود عنوان Redirect URI خاطئ في Azure AD. فإذا لم يتطابق عنوان إعادة التوجيه المسجّل مع ما يستخدمه تطبيقك فعليًا، أو كان ينقصه تفاصيل مطلوبة، فقد تُطلق دون قصد طلب GET بدلًا من طلب POST المتوقع.

ومن الأخطاء الشائعة الأخرى الالتباس في طريقة برمجة تدفق المصادقة نفسه. فبعض المطورين يستخدمون GET عند استدعاء نقطة النهاية /token، خاصة عندما يحاولون بناء الطلبات يدويًا أو عند إساءة فهم المكتبة التي يستخدمونها. ففي OAuth 2.0 مع Microsoft Entra، يجب دائمًا إرسال طلب الحصول على الرمز المميز النهائي باستخدام POST، وليس GET. وإذا أرسل سير العمل لديك طلب GET في هذه الخطوة، فسيظهر الخطأ AADSTS900561 فورًا.

إذن، كيف تصلح المشكلة؟ ابدأ بالتحقق مرة أخرى من عناوين إعادة التوجيه (redirect URIs) في تسجيل التطبيق على بوابة Azure وفي إعدادات التطبيق المحلية. تأكد من أنها متطابقة تمامًا، حتى في البروتوكول (http أو https) والمسار. إذا كنت تستخدم مكتبتي MSAL أو ADAL، فتأكد من أنك لا تعمل بنسخة قديمة، وأنك لا تكتب شيفرة تتجاوز سلوك POST الافتراضي فيها. وإذا كنت تستخدم شيفرة مصادقة مخصصة، فافحص طلبات HTTP للتأكد من أن نقطة نهاية الرمز المميز (token endpoint) تُستدعى دائمًا بطلب POST.

تحتاج إلى مساعدة في الشيفرة؟ إليك نصيحة سريعة: في JavaScript، عند استخدام fetch أو axios، تأكد من أن استدعاءك لـ /token يبدو تقريبًا كالتالي: method: 'POST'. إذا رأيت الرسالة "endpoint only accepts post" في السجلات أو في المتصفح، فهذه إشارة لفحص كل خطوة تنفذها شيفرتك بين التفويض وتبادل الرمز المميز، خاصة إذا كان تطبيقك ينتقل بين منطق الواجهة الأمامية والخلفية. للتعمق أكثر في مخاطر الهوية وحلول الحوكمة الواقعية، اطلع على هذه الحلقة حول الهوية بوصفها مستوى التحكم في أمان Azure.

تصحيح الأخطاء وأفضل الممارسات للوقاية من أخطاء AADSTS900561

دعنا نتحدث عن تتبع هذا الخطأ وضمان عدم عودته مجددًا. إذا كنت تشغّل تطبيق صفحة واحدة (SPA) باستخدام React أو Vue أو Angular، فافتح أدوات المطوّر في المتصفح. انتقل إلى علامة التبويب Network، ونفّذ تدفق تسجيل الدخول، وراقب بدقة طلب GET الموجَّه إلى نقطة النهاية /token. بمجرد أن تراه، تكون قد وجدت المتسبب.

في بعض الأحيان، يحدث هذا الخلل لأن مكتبة المصادقة غير مهيأة بشكل صحيح. ففي MSAL.js مثلًا، قد يؤدي استخدام loginRedirect في موضع كان المقصود فيه acquireTokenSilent، أو سوء إعداد المكتبة، إلى إرسال طلب GET بدلًا من POST. إن تحديث MSAL.js إلى أحدث إصدار والتحقق مرة أخرى من إعدادات التهيئة يمكن أن يوفّر عليك كثيرًا من المتاعب. الأطر البرمجية دقيقة في هذا الشأن، لكن وثائق Microsoft واضحة جدًا بشأن ضرورة استخدام POST في طلبات الرموز المميزة.

ولا تُهمل سجلات Azure أيضًا. تحقق من سجلات تسجيل الدخول في Azure AD للاطلاع على تفاصيل تتبع الطلبات. ستجد نقطة النهاية التي تم استدعاؤها، والأسلوب المستخدم، وأي إشارات إلى عدم تطابق البروتوكول. وإذا كنت تحتاج إلى تشخيص متعمق، فيمكن لأدوات مثل Fiddler تحليل حركة HTTP سطرًا بسطر، ويمكن لـ Application Insights ربط مكدس الاستدعاءات مباشرةً بموضع المشكلة.

الوقاية خير من العلاج. اختبر دائمًا تدفقات المصادقة في بيئتي التطوير والتجهيز (staging) قبل إطلاقها على بيئة الإنتاج. تأكد من أن كل جزء من الشيفرة الذي يستبدل رمز التفويض برمز مميز يعمل على الخادم باستخدام POST، تمامًا كما تنص إرشادات OAuth 2.0. إن تبادل الرموز داخل المتصفح طريقة شائعة للوقوع في خطأ AADSTS900561، وقد يفتح ثغرات أمنية.

إذا كنت تعمل في بيئات Microsoft 365 أو Azure الكبيرة، فألقِ نظرة على نهج الحوكمة لديك. أصبح Entra ID يدعم جزءًا كبيرًا من الوصول الحرج، لذا فإن إبقاء نهجك محكمًا وجعل شيفرتك تتبع أفضل ممارسات Microsoft يجعل الأمور أسهل بكثير. للاطلاع على معلومات حول تصميم حوكمة لا تسمح بتسرب الثغرات، تستحق هذه حلقة استراتيجية حوكمة المؤسسات في Azure المشاهدة.

وإذا كان تطبيقك جزءًا من Power Platform، أو كان يستخدم الموصلات فقط، فأدر هويات الموصلات بعناية لتجنب الانحراف المعماري وأخطاء الأذونات غير المتوقعة. ستجد إرشادات عملية في هذا المرجع: أفضل ممارسات أمان Power Platform وحوكمته.

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


قائمة التحقق العملية

  • تأكد من النتيجة الدقيقة للمستخدم والنطاق المتأثر.
  • استخدم أضيق إعداد آمن أو خيار تواصل آمن.
  • اختبر التجربة قبل النشر الواسع.
  • وثّق الملكية، وإجراءات المتابعة، ونقاط المراجعة.

الأسئلة المتداولة

ما هي أفضل خطوة أولى؟

حدّد سيناريو المستخدم والنتيجة المحددة التي تحتاجها. فهذا يمنع التغييرات غير الضرورية، ويُنتج تنفيذًا أوضح وأكثر موثوقية.

🎧 قد ترغب أيضًا في الاستماع إلى

آخر مراجعة: يوليو 2026.

Entities in this article

مواضيع هذا المقال:

Microsoft Entra ID – أداة الهوية والأمان من Microsoft Microsoft Entra – أداة الهوية والأمان من Microsoft Microsoft Azure – منصة سحابية من Microsoft Microsoft – مؤسسة HTTP – مفهوم OAuth 2.0 – مفهوم Power Platform – أداة منخفضة التعليمات البرمجية من Microsoft Governance – مفهوم

Related articles

مقالات أخرى عن Microsoft Entra ID:

RSS