إنشاء مساحة عمل وإدارتها في Azure API Management
ينطبق على: Premium
قم بإعداد مساحة عمل لتمكين فريق واجهة برمجة التطبيقات من إدارة واجهات برمجة التطبيقات الخاصة بهم وإنتاجها، مع تزويد فريق النظام الأساسي لواجهة برمجة التطبيقات بالأدوات لمراقبة النظام الأساسي لإدارة واجهة برمجة التطبيقات والتحكم فيه وصيانته. بعد إنشاء مساحة عمل وتعيين الأذونات، يمكن للمتعاونين في مساحة العمل إنشاء واجهات برمجة التطبيقات والمنتجات والاشتراكات والموارد ذات الصلة وإدارتها.
إشعار
- يتم دعم أحدث ميزات مساحة العمل في API Management REST API الإصدار 2023-09-01-preview أو أحدث.
- لاعتبارات التسعير، راجع تسعير APIM.
اتبع الخطوات الواردة في هذه المقالة من أجل:
- إنشاء مساحة عمل APIM وبوابة مساحة عمل باستخدام مدخل Microsoft Azure
- اختياريا، اعزل بوابة مساحة العمل في شبكة Azure الظاهرية
- تعيين أذونات لمساحة العمل
إشعار
حاليا، يعد إنشاء بوابة مساحة عمل عملية طويلة الأمد قد تستغرق ما يصل إلى 3 ساعات أو أكثر لإكمالها.
المتطلبات الأساسية
- مثيل API Management. إذا كنت بحاجة إلى ذلك، قم بإنشاء واحد في مستوى مدعوم.
- دور المالك أو المساهم في مجموعة الموارد حيث يتم نشر مثيل APIM، أو أذونات مكافئة لإنشاء موارد في مجموعة الموارد.
- (اختياري) شبكة Azure الظاهرية والشبكة الفرعية الموجودة أو الجديدة لعزل نسبة استخدام الشبكة الواردة والصادرة لبوابة مساحة العمل. للحصول على خيارات التكوين ومتطلباته، راجع متطلبات موارد الشبكة لبوابات مساحة العمل.
إنشاء مساحة عمل - مدخل
تسجيل الدخول إلى بوابة Azure، والانتقال إلى مثيل API Management.
في القائمة اليسرى، ضمن واجهات برمجة التطبيقات، حدد مساحات> العمل + إضافة.
في علامة التبويب Basics، أدخل اسم عرض وصفيا واسم المورد ووصفا اختياريا لمساحة العمل. حدد التالي.
في علامة التبويب Gateway ، قم بتكوين الإعدادات لبوابة مساحة العمل:
في تفاصيل البوابة، أدخل اسم بوابة وحدد عدد وحدات المقياس. تستند تكاليف البوابة إلى عدد الوحدات التي تحددها. لمزيد من المعلومات، راجع تسعير APIM.
في الشبكة، حدد تكوين شبكة لبوابة مساحة العمل الخاصة بك.
هام
خطط لتكوين شبكة مساحة العمل بعناية. لا يمكنك تغيير تكوين الشبكة بعد إنشاء مساحة العمل.
إذا حددت تكوين شبكة يتضمن الوصول إلى شبكة واردة خاصة أو خاصة صادرة، فحدد شبكة ظاهرية وشبكة فرعية لعزل بوابة مساحة العمل، أو أنشئ واحدة جديدة. للحصول على متطلبات الشبكة، راجع متطلبات موارد الشبكة لبوابات مساحة العمل.
حدد التالي. وبعد اكتمال عملية التحقق، حدد Create.
قد يستغرق إنشاء مساحة العمل وبوابة مساحة العمل والموارد ذات الصلة من عدة دقائق إلى عدة ساعات. لتعقب تقدم التوزيع في مدخل Microsoft Azure، انتقل إلى مجموعة موارد البوابة. في القائمة اليسرى، ضمن Settings، حدد Deployments.
بعد اكتمال النشر، تظهر مساحة العمل الجديدة في القائمة على صفحة مساحات العمل. حدد مساحة العمل لإدارة إعداداتها ومواردها.
إشعار
- لعرض اسم مضيف وقت تشغيل البوابة وتفاصيل البوابة الأخرى، حدد مساحة العمل في المدخل. ضمن Deployment + infrastructure، حدد Gateways، وحدد اسم بوابة مساحة العمل.
- أثناء إنشاء بوابة مساحة العمل، لن تنجح استدعاءات وقت التشغيل إلى واجهات برمجة التطبيقات لمساحة العمل.
تعيين المستخدمين إلى مساحة العمل - المدخل
بعد إنشاء مساحة عمل، قم بتعيين أذونات للمستخدمين لإدارة موارد مساحة العمل. يجب تعيين كل مستخدم مساحة عمل لكل من دور RBAC لمساحة العمل ذات نطاق الخدمة ودور RBAC في نطاق مساحة العمل، أو منح أذونات مكافئة باستخدام أدوار مخصصة.
لإدارة بوابة مساحة العمل، نوصي أيضا بتعيين دور RBAC المقدم من Azure لمستخدمي مساحة العمل إلى بوابة مساحة العمل.
إشعار
لتسهيل الإدارة، قم بإعداد مجموعات Microsoft Entra لتعيين أذونات مساحة العمل لعدة مستخدمين.
- للحصول على قائمة بأدوار مساحة العمل المضمنة، راجع كيفية استخدام التحكم في الوصول المستند إلى الدور في APIM.
- للحصول على خطوات لتعيين دور، راجع تعيين أدوار Azure باستخدام المدخل.
تعيين دور نطاق الخدمة
تسجيل الدخول إلى بوابة Azure، والانتقال إلى مثيل API Management.
في القائمة اليسرى، حدد Access control (IAM)>+ Add.
تعيين أحد الأدوار التالية ذات نطاق الخدمة لكل عضو في مساحة العمل:
- API Management Service Workspace API Developer
- API Management Service Workspace API Product Manager
تعيين دور نطاق مساحة العمل
في القائمة الخاصة بمثيل APIM، ضمن واجهات> برمجة التطبيقات، حدد مساحات العمل اسم مساحة العمل التي قمت بإنشائها.
في نافذة مساحة العمل، حدد Access control (IAM)>+ Add.
قم بتعيين أحد الأدوار التالية ذات نطاق مساحة العمل لأعضاء مساحة العمل حتى يتمكنوا من إدارة واجهات برمجة تطبيقات مساحة العمل والموارد الأخرى.
- قارئ مساحة عمل إدارة واجهة برمجة التطبيقات
- مساهم مساحة عمل إدارة واجهة برمجة التطبيقات
- مطور API Management Workspace API
- API Management Workspace API Product Manager
تعيين دور نطاق البوابة
تسجيل الدخول إلى بوابة Azure، والانتقال إلى مثيل API Management.
في القائمة اليسرى، ضمن واجهات> برمجة التطبيقات، حدد مساحات العمل اسم مساحة العمل الخاصة بك.
في القائمة اليسرى لمساحة العمل، حدد Gateways، وحدد بوابة مساحة العمل.
في القائمة اليسرى، حدد Access control (IAM)>+ Add.
تعيين أحد الأدوار التالية لكل عضو في مساحة العمل. على الأقل، نوصي بتعيين دور القارئ لعرض إعدادات البوابة. يمكن للمالكين والمساهمين إدارة إعدادات البوابة بما في ذلك تحجيم البوابة.
- المالك
- المساهم
- القارئ
بدء استخدام مساحة العمل
اعتمادا على دورهم في مساحة العمل، قد يكون لدى المستخدمين أذونات لإنشاء واجهات برمجة التطبيقات والمنتجات والاشتراكات والموارد الأخرى، أو قد يكون لديهم حق الوصول للقراءة فقط إلى بعضها أو كلها.
لبدء إدارة واجهات برمجة التطبيقات وحمايتها ونشرها في مساحة عمل، راجع الإرشادات التالية.
| Resource | الدليل: |
|---|---|
| واجهات برمجة التطبيقات (API) | البرنامج التعليمي: استيراد ونشر واجهة برمجة التطبيقات الأولى |
| المنتجات | البرنامج التعليمي: إنشاء منتج ونشره |
| الاشتراكات | Subscriptions in Azure API Management إنشاء اشتراكات في APIM |
| السياسات | البرنامج التعليمي: تحويل واجهة برمجة التطبيقات الخاصة بك وحمايتها النُهج في Azure API Management تعيين نهج إدارة واجهة برمجة التطبيقات أو تحريرها |
| القيم المسماة | إدارة البيانات السرية باستخدام القيم المسماة |
| الواجهات الخلفية | استخدام الخلفيات في Azure API Management |
| أجزاء النهج | إعادة استخدام تكوينات النهج في تعريفات نهج إدارة واجهة برمجة التطبيقات |
| المخططات | التحقق من صحة المحتوى |
| المجموعات | إنشاء مجموعات واستخدامها لإدارة حسابات المطورين |
| الإعلامات | كيفية تكوين الإعلامات وقوالب الإعلامات |