إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على: الإصدار 2 الأساسي | الإصدار 2 القياسي | Premium | Premium v2
توفر هذه المقالة نظرة عامة على مساحات عمل إدارة واجهة برمجة التطبيقات وكيفية تمكين فرق تطوير واجهة برمجة التطبيقات اللامركزية لإدارة واجهات برمجة التطبيقات الخاصة بها في بنية أساسية مشتركة للخدمة.
لماذا يجب على المؤسسات توحيد إدارة واجهة برمجة التطبيقات؟
تواجه المؤسسات اليوم تحديات متزايدة في إدارة انتشار واجهات برمجة التطبيقات. مع نمو عدد واجهات برمجة التطبيقات وفرق تطوير واجهة برمجة التطبيقات، يزداد تعقيد إدارتها. يمكن أن يؤدي هذا التعقيد إلى زيادة النفقات التشغيلية والمخاطر الأمنية وتقليل السرعة. من ناحية، ترغب المؤسسات في إنشاء بنية أساسية مركزية لواجهة برمجة التطبيقات لضمان حوكمة واجهة برمجة التطبيقات وأمانها وتوافقها. من ناحية أخرى، يريدون أن تبتكر فرق واجهة برمجة التطبيقات الخاصة بهم وتستجيب بسرعة لاحتياجات الأعمال، دون النفقات العامة لإدارة منصة واجهة برمجة التطبيقات.
يعالج نموذج متحد لإدارة واجهة برمجة التطبيقات هذه الاحتياجات. تسمح إدارة واجهة برمجة التطبيقات الموحدة بإدارة واجهة برمجة التطبيقات اللامركزية بواسطة فرق التطوير مع العزل المناسب لأنظمة التحكم ووحدات البيانات، مع الحفاظ على الحوكمة المركزية والمراقبة واكتشاف واجهة برمجة التطبيقات التي يديرها فريق النظام الأساسي لواجهة برمجة التطبيقات. يتغلب هذا النموذج على قيود النهج البديلة مثل إدارة واجهة برمجة التطبيقات المركزية بالكامل من قبل فريق النظام الأساسي أو إدارة واجهة برمجة التطبيقات المنعزلة من قبل كل فريق تطوير.
توفر إدارة واجهة برمجة التطبيقات الموحدة ما يلي:
- إدارة واجهة برمجة التطبيقات المركزية وإمكانية المراقبة
- مدخل مطور موحد لاكتشاف واجهة برمجة التطبيقات الفعالة وإلحاقها
- فصل الأذونات الإدارية بين فرق واجهة برمجة التطبيقات، ما يعزز الإنتاجية والأمان
- وقت تشغيل واجهة برمجة التطبيقات المنفصل بين فرق واجهة برمجة التطبيقات، وتحسين الموثوقية والمرونة والأمان
كيف تمكن مساحات العمل إدارة واجهة برمجة التطبيقات الموحدة
في إدارة Azure API، استخدم مساحات العمل لتنفيذ إدارة واجهة برمجة التطبيقات الموحدة. تعمل مساحات العمل مثل "المجلدات" داخل خدمة APIM:
- تحتوي كل مساحة عمل على واجهات برمجة التطبيقات والمنتجات والاشتراكات والقيم المسماة والموارد ذات الصلة. راجع مرجع API Management REST API للحصول على قائمة كاملة بالموارد والعمليات المدعومة في مساحات العمل.
- تتم إدارة وصول Teams إلى الموارد داخل مساحة العمل من خلال التحكم في الوصول استنادا إلى الدور (RBAC) في Azure مع أدوار مضمنة أو مخصصة قابلة للتعيين لحسابات Microsoft Entra ويتم تحديد نطاقها إلى مساحة عمل.
- يرتبط كل مساحة عمل ببوابة أو أكثر لتوجيه حركة مرور واجهة برمجة التطبيقات إلى خدمات الواجهة الخلفية لواجهات برمجة التطبيقات في مساحة العمل. اعتمادا على مستوى الخدمة ومتطلباتك، يمكن لمساحة العمل استخدام بوابة الخدمة المدارة الافتراضية أو واحدة أو أكثر من بوابات مساحة العمل.
- يمكن لفريق النظام الأساسي تطبيق السياسات التي تغطي واجهات برمجة التطبيقات والمنتجات في مساحات العمل للتحكم في وقت تشغيل واجهة برمجة التطبيقات عبر المؤسسة. يتيح لك تعريف نهج Azure المضمن (
API Management policies should inherit parent scope policies using <base/>) تدقيق أو فرض تطبيق هذه النهج عبر جميع موارد مساحة العمل. - يمكن لفريق النظام الأساسي تنفيذ تجربة اكتشاف واجهة برمجة تطبيقات مركزية باستخدام مدخل المطور.
- يمكن لكل فريق مساحة عمل جمع وتحليل سجلات موارد البوابة لمراقبة واجهات برمجة تطبيقات مساحة العمل الخاصة بهم، بينما قام فريق النظام الأساسي بوحد الوصول إلى السجلات عبر جميع مساحات العمل في خدمة APIM، ما يوفر الإشراف والأمان والتوافق عبر النظام البيئي لواجهة برمجة التطبيقات الخاصة بهم.
Note
- جديد! ميزة مساحات العمل متوفرة الآن في مستويين Basic v2 وStandard v2، بالإضافة إلى مستويين Premium وPremium v2. يمكن ربط مساحات العمل في مستويات v2 إما ببوابة إدارة API الافتراضية أو بمورد بوابة منفصلة لمساحة العمل، مما يوفر مرونة في كيفية تكوين وتوسيع مساحات العمل الخاصة بك. للحصول على معلومات حول خارطة الطريق لدعم مستويات مساحات العمل، راجع منشور المدونة.
- لاعتبارات التسعير، راجع تسعير APIM.
بينما تتم إدارة مساحات العمل بشكل مستقل عن خدمة APIM ومساحات العمل الأخرى، يمكن حسب التصميم الرجوع إلى الموارد المحددة على مستوى الخدمة. راجع مساحات العمل وميزات إدارة واجهة برمجة التطبيقات الأخرى، لاحقا في هذه المقالة.
مثال على نظرة عامة على السيناريو
قد يكون لدى المنظمة التي تدير واجهات برمجة التطبيقات باستخدام إدارة Azure API فرق تطوير متعددة تقوم بتطوير وتعريف وصيانة وإنتاج مجموعات مختلفة من واجهات البرمجة (APIs). باستخدام مساحات العمل، يمكن لهذه الفرق استخدام إدارة واجهات برمجة التطبيقات لإدارة والوصول إلى وتأمين واجهات برمجة التطبيقات بشكل منفصل ومستقل عن إدارة بنية الخدمة التحتية.
يعرض سير العمل التالي نموذجا لعملية إنشاء واستخدام مساحة العمل.
فريق منصة API مركزي يدير مثيل إدارة واجهة برمجة التطبيقات ينشئ مساحة عمل ويمنح الأذونات للمتعاونين في مساحة العمل باستخدام أدوار RBAC. على سبيل المثال، تعيين الأذونات لإنشاء أو قراءة الموارد في مساحة العمل. يقوم الفريق إما بإنشاء أو ربط بوابة API بمساحة العمل لتوجيه حركة مرور API.
يستخدم فريق النظام الأساسي المركزي لواجهة برمجة التطبيقات أدوات DevOps لإنشاء مسار DevOps لواجهات برمجة التطبيقات في مساحة العمل هذه.
يقوم أعضاء مساحة العمل بتطوير ونشر ونتاج وصيانة واجهات برمجة التطبيقات في مساحة العمل.
يدير فريق النظام الأساسي المركزي لواجهة برمجة التطبيقات البنية الأساسية للخدمة، مثل مراقبة سياسات واجهات برمجة التطبيقات ومرونتها وإنفاذها.
بوابة مساحة العمل
يتم تكوين كل مساحة عمل ببوابة أو أكثر لتمكين وقت تشغيل واجهات برمجة التطبيقات المدارة داخل مساحة العمل. اعتمادا على مستوى الخدمة ومتطلباتك، يمكنك استخدام بوابة الخدمة المدارة الافتراضية و/أو واحدة أو أكثر من بوابات مساحة العمل (موارد بوابة منفصلة).
| خيار | التوفر | المزايا | الاعتبارات |
|---|---|---|---|
| بوابة الإدارة الافتراضية | حاليا في مستويات v2 | لا توجد تكلفة إضافية لموارد البوابة؛ التوفر في جميع المناطق التي تتوفر فيها الفئة؛ يمكن لمساحات العمل الاستفادة من قدرات البوابة المدمجة التي لا تتوفر في بوابات مساحة العمل، مثل النشر متعدد المناطق، أو أسماء المضيفين المخصصة، أو الاتصال بالروابط الخاصة إذا كان مدعوما في طبقة الخدمة | عزلة أقل؛ جميع مساحات العمل تشترك في سعة وتكوين البوابة |
| بوابة مساحة العمل | Basic v2، Standard v2، Premium، Premium v2 | عزل قوي أثناء التشغيل؛ التوسع المستقل، اسم المضيف، وتكوين الشبكة لكل بوابة مساحة عمل | تكلفة إضافية؛ وقت نشر أطول؛ الدعم في مناطق أقل |
بوابة الإدارة الافتراضية
في مستويات v2، يمكنك تكوين مساحة عمل لتوجيه حركة مرور API عبر بوابة الخدمة المدارة الافتراضية، بالإضافة إلى مورد أو أكثر منفصل لبوابة مساحة العمل. عندما تستخدم مساحة العمل البوابة المدارة الافتراضية:
- تمر حركة مرور API عبر اسم المضيف الافتراضي للخدمة (على سبيل المثال،
<service-name>.azure-api.net). - تشارك مساحة العمل سعة وتكوين البوابة مع مساحات العمل الأخرى وواجهات برمجة التطبيقات على مستوى الخدمة.
Note
حاليا يمكنك ربط مساحة عمل بالبوابة المدارة الافتراضية فقط في مستويات خدمة v2 ومن خلال مساحة إدارة API - إنشاء أو تحديث واجهة REST API.
بوابة مساحة العمل
بوابة مساحة العمل هي مورد Azure مستقل (workspace gateway premium) بنفس الوظائف الأساسية للبوابة المدارة الافتراضية.
تدير بوابات مساحة العمل بشكل مستقل عن خدمة إدارة واجهة برمجة التطبيقات وعن بعضها البعض. تسمح بعزل وقت التشغيل بين مساحات العمل أو حالات الاستخدام، مما يزيد من موثوقية واجهة برمجة التطبيقات (API) ومرونتها وأمانها. كما تتيح نسب مشاكل وقت التشغيل إلى مساحات العمل.
- للحصول على معلومات حول تكلفة بوابات مساحة العمل، راجع أسعار إدارة واجهة برمجة التطبيقات.
- للحصول على مقارنة مفصلة لبوابات APIM، راجع نظرة عامة على بوابات APIM.
إقران مساحات العمل ببوابة مساحة عمل
بناء على احتياجات مؤسستك، يمكنك إقران مساحة عمل واحدة أو مساحات عمل متعددة ببوابة مساحة عمل.
Note
يتوفر ربط مساحات عمل متعددة ببوابة مساحة عمل فقط لبوابات مساحة العمل التي تم إنشاؤها بعد 15 أبريل 2025.
- تحتوي بوابة مساحة العمل على إعدادات إعدادات معينة، مثل الشبكة الافتراضية، والمقياس، واسم المضيف، وموارد حوسبة مخصصة، بما في ذلك وحدة المعالجة المركزية، والذاكرة، وموارد الشبكة.
- جميع مساحات العمل المنشورة على بوابة تشارك التكوين وموارد الحوسبة.
- يمكن أن تؤدي الأخطاء في واجهة برمجة التطبيقات أو حركة مرور غير عادية إلى نفاد هذه الموارد، مما يؤثر على جميع مساحات العمل على تلك البوابة. بعبارة أخرى، كلما زادت مساحة العمل التي تنشرها على البوابة، زاد خطر أن تواجه واجهة برمجة تطبيقات من مساحة عمل واحدة مشاكل موثوقية ناجمة عن واجهة برمجة تطبيقات من مساحة عمل أخرى.
- راقب أداء بوابة مساحة العمل باستخدام مقاييس مدمجة لاستخدام وحدة المعالجة المركزية والذاكرة.
ضع في اعتبارك الموثوقية والأمان والتكلفة عند اختيار نموذج توزيع لمساحات العمل.
- تعيين مساحة عمل لبوابة مساحة عمل مخصصة لها لأحمال العمل الحرجة - لتعظيم موثوقية وأمان واجهة برمجة التطبيقات، خصص كل مساحة عمل حرجة إلى بوابة خاصة بها، مع تجنب الاستخدام المشترك مع مساحات العمل الأخرى.
- موازنة بين الموثوقية والأمان والتكلفة - ربط عدة مساحات عمل ببوابة مساحة عمل (أو، إذا كان ذلك ينطبق، البوابة المدارة الافتراضية) لتحقيق توازن بين الموثوقية والأمان والتكلفة لأحمال العمل غير الحرجة. وزع مساحات العمل عبر بوابتين على الأقل للمساعدة في منع المشاكل، مثل نفاد الموارد أو أخطاء التكوين، من التأثير على جميع واجهات برمجة التطبيقات داخل المؤسسة.
- استخدم بوابات مميزة لحالات استخدام مختلفة - قم بتجميع مساحات العمل على بوابة مساحة العمل بناء على حالة استخدام أو متطلبات الشبكة. على سبيل المثال، يمكنك التمييز بين واجهات برمجة التطبيقات الداخلية والخارجية عن طريق تعيينها لبوابات منفصلة، لكل منها تكوين شبكة خاص بها.
- استعد لعزل مساحات العمل المضطربة - استخدم وكيل مثل Azure Application Gateway أو الواجهة الأمامية لـ Azure أمام بوابات مساحة العمل المشتركة لتبسيط نقل مساحة عمل تسبب استنزاف الموارد إلى بوابة مختلفة. هذا النهج يمنع التأثير على مساحات العمل الأخرى التي تشارك البوابة.
Note
- يجب أن تكون بوابة مساحة العمل في نفس المنطقة التي تقع فيها منطقة Azure الأساسية لجهاز إدارة واجهة برمجة التطبيقات وفي نفس الاشتراك.
- يجب أن تكون جميع مساحات العمل المرتبطة ببوابة مساحة العمل في نفس مثيل إدارة واجهة برمجة التطبيقات (API).
- يمكنك ربط ما يصل إلى 30 مساحة عمل ببوابة مساحة عمل. تواصل مع الدعم لزيادة هذا الحد.
اسم المضيف لبوابة مساحة العمل
توفر كل بوابة مساحة عمل اسم مضيف فريد لواجهات برمجة التطبيقات المدارة في مساحة عمل مقترنة. تتبع أسماء المضيفين الافتراضية النمط <gateway-name>-<hash>.gateway.<region>.azure-api.net. استخدم اسم مضيف البوابة لتوجيه طلبات واجهة برمجة التطبيقات إلى واجهات برمجة التطبيقات الخاصة بمساحة العمل الخاصة بك.
حاليا، بوابات مساحة العمل لا تدعم أسماء المضيفين المخصصة. يمكنك تكوين بوابة تطبيق Azure أو الواجهة الأمامية لـ Azure باستخدام اسم مضيف مخصص أمام بوابة مساحة العمل.
عزل الشبكة لبوابات مساحة العمل
يمكنك اختياريا تكوين مورد بوابة مساحة عمل في شبكة افتراضية خاصة لعزل حركة المرور الواردة والصادرة. إذا قمت بتكوين هذا العزل، يجب على بوابة مساحة العمل استخدام شبكة فرعية مخصصة في الشبكة الافتراضية.
للحصول على متطلبات مفصلة، راجع متطلبات موارد الشبكة لبوابات مساحة العمل.
Note
- تكوين الشبكة لبوابة مساحة العمل مستقل عن تكوين الشبكة لمثيل APIM.
- حاليا، لا يمكن تكوين بوابة مساحة العمل إلا في شبكة ظاهرية عند إنشاء البوابة. لا يمكنك تغيير تكوين شبكة البوابة أو إعداداتها لاحقا.
السعة الموسعة لمداخل بوابات مساحة العمل
إدارة سعة بوابة مساحة العمل عن طريق إضافة أو إزالة وحدات الحجم، مشابهة للوحدات التي يمكنك إضافتها إلى مثيل إدارة واجهة برمجة التطبيقات في مستويات خدمة معينة. تستند تكاليف بوابة مساحة العمل إلى عدد الوحدات التي تحددها.
توفر بوابات مساحة العمل الإقليمية
للحصول على قائمة حالية بالمناطق التي تتوفر فيها بوابات مساحة العمل، راجع توفر مستويات v2 وبوابات مساحة العمل.
قيود بوابات مساحة العمل ومساحة العمل
قيود مساحات العمل
- لا يمكن إقران مساحة العمل ببوابة ذاتية الاستضافة
- واجهات برمجة التطبيقات في مساحات العمل لا يغطيها Defender لواجهات برمجة التطبيقات
- مساحات العمل لا تدعم مدير الاعتمادات
- تدعم مساحات العمل فقط ذاكرة تخزين مؤقت داخلي؛ الذاكرة المخبأة الخارجية غير مدعومة
- مساحات العمل لا تدعم واجهات برمجة التطبيقات التركيبية GraphQL
- مساحات العمل لا تدعم إنشاء واجهات برمجة التطبيقات مباشرة من موارد Azure مثل خدمة Azure OpenAI، App Service، تطبيقات الوظائف، وهكذا في بوابة Azure
- مساحات العمل لا تدعم خوادم MCP
- لا يمكن تقسيم مقاييس الطلب حسب مساحة العمل في Azure Monitor؛ يتم تجميع جميع مقاييس مساحة العمل على مستوى الخدمة
- مساحات العمل لا تدعم شهادات CA
- مساحات العمل لا تدعم الهويات المدارة، بما في ذلك الميزات ذات الصلة مثل تخزين الأسرار في Azure Key Vault واستخدام سياسة
authentication-managed-identity
قيود بوابة مساحة العمل
تنطبق القيود التالية على مورد بوابة مساحة العمل المدارة. لا تنطبق عند استخدام مساحات العمل على بوابة الخدمة المدارة الافتراضية.
- لا تدعم بوابات مساحة العمل نقاط النهاية الخاصة الواردة
- بوابات مساحة العمل لا تدعم أسماء المضيفين المخصصة
- يمكن ربط مساحات العمل فقط ببوابات مساحة العمل الموجودة في نفس المنطقة والاشتراك مع مورد إدارة واجهة برمجة التطبيقات
وراثة السياسات العالمية في بوابات مساحة العمل
تقوم بوابات مساحة العمل بتنفيذ سلسلة السياسات الكاملة، بما في ذلك السياسة العالمية على مستوى الخدمة (global.policy.xml). هذا السلوك يعني أن أي سياسات محددة في النطاق العالمي يتم تقييمها وتنفيذها لاستدعاءات API التي تتم معالجتها بواسطة بوابات مساحة العمل، تماما كما هو الحال مع البوابة الافتراضية. هذا السلوك مصمم ومتوافق مع نموذج تقييم سياسات إدارة واجهة برمجة التطبيقات، حيث تطبق السياسات بشكل هرمي ضمن النطاقات التالية: تشغيل واجهة برمجة التطبيقات > لمنتجات > مساحة العمل > (الخدمة) > العالمية.
توصيات للسياسات العالمية مع بوابات مساحة العمل
راجع سياستك العالمية للتأكد من أنها تحتوي فقط على السياسات المخصصة للتطبيق عبر جميع البوابات، بما في ذلك بوابات مساحة العمل.
إذا كنت بحاجة إلى سلوك مختلف لكل بوابة، استخدم سياسة Choose مع
context.Deployment.Gateway.Idلتنفيذ السياسات بشكل مشروط بناء على معالجة البوابة للطلب.إذا قمت بتعريف هوية مدارة بالمصادقة في النطاق العام لكن الرمز لا ينبغي أن يكون متاحا لواجهات برمجة التطبيقات ذات نطاق مساحة العمل، انقل السياسة إلى نطاق أضيق (على سبيل المثال، مستوى المنتج أو واجهة برمجة التطبيقات) بدلا من السياسة العالمية.
أدوار التحكم في الوصول استنادا إلى الدور لمساحات العمل
يتم استخدام Azure RBAC لتكوين أذونات المتعاونين في مساحة العمل لقراءة الكيانات وتحريرها في مساحة العمل. للحصول على قائمة بالأدوار، راجع كيفية استخدام التحكم في الوصول المستند إلى الدور في APIM.
لإدارة واجهات برمجة التطبيقات والموارد الأخرى في مساحة العمل، قم بتعيين الأدوار لأعضاء مساحة العمل (أو أذونات مكافئة من خلال أدوار مخصصة) التي تم تخصيصها لخدمة إدارة واجهة برمجة التطبيقات ومساحة العمل. يتيح الدور نطاق الخدمة الرجوع إلى موارد معينة على مستوى الخدمة من موارد على مستوى مساحة العمل. على سبيل المثال، قم بتنظيم مستخدم في مجموعة على مستوى مساحة العمل للتحكم في واجهة برمجة التطبيقات ورؤية المنتج.
إذا كانت مساحة العمل تستخدم بوابة مساحة عمل مخصصة، يجب أيضا تعيين دور للأعضاء الذين يديرون البوابة ليتم تخصيص دور مخصص لمورد بوابة مساحة العمل.
Note
لتسهيل الإدارة، قم بإعداد مجموعات Microsoft Entra لتعيين أذونات مساحة العمل لعدة مستخدمين.
مساحات العمل وميزات إدارة واجهة برمجة التطبيقات الأخرى
مساحات العمل مكتفية ذاتيا لتعظيم فصل الوصول الإداري ووقت تشغيل واجهة برمجة التطبيقات (API). لضمان إنتاجية أعلى وتمكين الحوكمة على مستوى المنصة، وقابلية الملاحظة، وإعادة الاستخدام، واكتشاف واجهات برمجة التطبيقات، هناك عدة استثناءات.
مراجع الموارد - يمكن للموارد في مساحة العمل الرجوع إلى موارد أخرى في مساحة العمل والموارد المحددة من مستوى الخدمة، مثل المستخدمين أو خوادم التخويل أو مجموعات المستخدمين المضمنة. لا يمكنهم الرجوع إلى الموارد من مساحة عمل أخرى.
لأسباب أمنية، لا يمكنك الرجوع إلى موارد مستوى الخدمة من سياسات على مستوى مساحة العمل (مثل القيم المسماة) أو بأسماء الموارد، كما
backend-idفي سياسة إعادة الخلفية-الخدمة .Important
تحتاج جميع الموارد في خدمة APIM (على سبيل المثال، واجهات برمجة التطبيقات أو المنتجات أو العلامات أو الاشتراكات) إلى أسماء فريدة، حتى لو كانت موجودة في مساحات عمل مختلفة. لا يمكنك أن تمتلك موارد من نفس النوع وبنفس اسم موارد Azure في نفس مساحة العمل، أو في مساحات عمل أخرى، أو على مستوى الخدمة.
مدخل المطور - مساحات العمل هي مفهوم إداري ولا تظهر على هذا النحو لمستخدمي مدخل المطور، بما في ذلك من خلال واجهة مستخدم مدخل المطور وواجهة برمجة التطبيقات الأساسية. يمكنك نشر واجهات برمجة التطبيقات والمنتجات داخل مساحة عمل إلى بوابة المطورين، تماما مثل واجهات البرمجة والمنتجات على مستوى الخدمة.
Note
تدعم APIM تعيين خوادم التخويل المعرفة على مستوى الخدمة إلى واجهات برمجة التطبيقات داخل مساحات العمل.
الترحيل من مساحات عمل المعاينة
إذا قمت بإنشاء مساحات عمل معاينة في إدارة Azure API وتريد متابعة استخدامها، فرحل مساحات العمل إلى الإصدار المتاح بشكل عام عن طريق ربط بوابة مساحة عمل بكل مساحة عمل.
للحصول على التفاصيل وللتعرف على التغييرات الأخرى التي قد تؤثر على مساحات عمل المعاينة، راجع مساحات العمل التي تتعطل التغييرات (مارس 2025).
حذف مساحة عمل
عندما تحذف مساحة عمل باستخدام واجهة بوابة Azure، فإنك تحذف أيضا جميع مواردها الفرعية (واجهات برمجة التطبيقات، المنتجات، وما إلى ذلك) وبوابة مساحة عمل مخصصة إذا كانت مرتبطة. لا يحذف مثيل إدارة واجهة برمجة التطبيقات أو مساحات العمل الأخرى.