أنت تعرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
المؤسسة هي الحاوية ذات المستوى الأعلى في Apigee Edge. تحتوي على جميع الخوادم الوكيلة لواجهة برمجة التطبيقات والموارد ذات الصلة. في حين أنّ بقية هذا الموضوع تتعمّق أكثر في المؤسسات، إليك بعض النقاط العملية:
- يظهر اسم مؤسستك تلقائيًا في عنوان URL المستخدَم للاتّصال بخدمات الوكيل لواجهات برمجة التطبيقات، كما هو описан في لمحة عن المضيفين الظاهريين.
على سبيل المثال:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- يظهر اسم مؤسستك في عنوان URL لواجهة مستخدم إدارة Edge. على سبيل المثال، يعرض عنوان URL التالي الوكلاء لـ API في مؤسسة
docs:
- على الرغم من أنّك قد أنشأت مؤسسة واحدة فقط، يمكنك الانتماء إلى مؤسسات أخرى بصفتك مستخدِمًا أو مشرفًا لديه أذونات محدّدة. في واجهة مستخدم إدارة Edge، إذا كنت تنتمي إلى أكثر من مؤسسة واحدة، يمكنك التبديل إلى مؤسسة مختلفة كما هو موضّح في التبديل بين المؤسسات.
- عند إجراء مكالمات باستخدام Management API بصفتك مستخدمًا في دور "مشرف المؤسسة"،
تكون المؤسسة جزءًا مطلوبًا من المسار في معظم المكالمات. على سبيل المثال، يعرض يليه
طلب cURL لواجهة برمجة تطبيقات الإدارة قائمة بجميع الوكلاء لواجهة برمجة التطبيقات في مؤسسة:
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
فيديو: يمكنك مشاهدة فيديو قصير لمعرفة الآلية التي تتيح بها المؤسسات استخدام بنية متعددة الإيجارات لإدارة واجهة برمجة التطبيقات.
مكونات المؤسسة
عند إنشاء حساب Edge، تنشئ Edge تلقائيًا مؤسسة لك. بعد الإنشاء، يمكنك إضافة مستخدمين إلى مؤسستك وإنشاء تطبيقات ووكلاء لواجهات برمجة التطبيقات، وتسجيل المطوّرين والتطبيقات.
تعرض الصورة التالية المكوّنات الرئيسية لنموذج Edge التنظيمي. يحدّد هذا النموذج العلاقة بين واجهات برمجة التطبيقات ومنتجات واجهات برمجة التطبيقات والتطبيقات ومطوّري التطبيقات في Edge.
لا يعرض هذا النموذج جميع ميزات Apigee Edge. إذا كنت تستخدم ميزة تحقيق الربح، سيتضمّن النموذج مكونات إضافية. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على تحقيق الربح. يمكنك الاطّلاع على إدارة الشركات والمطوّرين للحصول على معلومات حول إدارة الشركات والمطوّرين باستخدام ميزة تحقيق الربح.
أسماء المؤسسات
اسم المؤسسة هو:
- مؤسسة التقييم:
username-eval - المؤسسة المدفوعة: يحدّدها المستخدم في وقت الإعداد الأولي.
لا يمكنك إعادة تسمية مؤسسة بعد إنشائها.
يصبح اسم المؤسسة جزءًا من عنوان URL إلى الخوادم الوكيلة لواجهة برمجة التطبيقات وجزءًا من عنوان URL عند تقديم طلب إلى واجهة برمجة تطبيقات إدارة Edge. على سبيل المثال، يكون لعنوان URL النموذجي المستخدَم للوصول إلى خادم وكيل لواجهة برمجة التطبيقات الشكل التالي:
http://org-name-env.apigee.net/v1/weather/forecastrss
حيث:
- org-name هو اسم مؤسستك.
- env هي بيئة نشر الوكيل لواجهة برمجة التطبيقات، والتي تكون إما اختبار أو prod.
على سبيل المثال:
http://myorg-test.apigee.net/v1/weather/forecastrss
مكونات المؤسسة
يصف الجدول التالي مكونات النموذج التنظيمي بمزيد من التفصيل:
| المكوّن | الوصف |
|---|---|
|
المؤسسة |
يتم ربط كل حساب في Apigee بمؤسسة واحدة أو أكثر على Apigee Edge. وتحتوي المؤسسة على تمثيل لجميع المكوّنات، بما في ذلك الخوادم الوكيلة لواجهة برمجة التطبيقات ومنتجات واجهات برمجة التطبيقات وحِزم واجهات برمجة التطبيقات والتطبيقات ومطوّري البرامج. لا يقتصر أصحاب الحسابات على مؤسسة واحدة. قد يحدِّد بعض أصحاب الحسابات مؤسسات متعددة تدعم منتديات مختلفة لمطوّري التطبيقات أو يكونون أعضاء فيها. |
| البيئة | سياق تنفيذ وقت التشغيل لخوادم وكيل واجهة برمجة التطبيقات في مؤسسة اطّلِع على القسم أدناه لمعرفة المزيد عن البيئات. |
|
مستخدم |
يمكنك إنشاء المزيد من المستخدمين ضمن مؤسسة يكون فيها الشخص الذي ينشئ الحساب مشرفًا تلقائيًا. يشكل المستخدمون فريق واجهة برمجة التطبيقات للمؤسسة، والذي يمكن أن يشمل أشخاصًا مثل المشرفين، والخادم الوكيل لواجهة برمجة التطبيقات ومنشئي منتجات واجهة برمجة التطبيقات، والمستخدمين الذين يراقبون الإحصاءات وغيرها من الإحصاءات، وغير ذلك. يمكن أن يكون لدى المستخدمين المختلفين أدوار وامتيازات وصول مختلفة. مثلاً، يمكنك تعريف بعض المستخدمين على أنّهم "مشرفو مؤسسات" و"مسؤولو عمليات" لديهم امتيازات لتعديل المؤسسة ومكوّناتها. يمكنك تحديد مستخدمين آخرين لديهم أذونات ل إنشاء منتجات وخوادم وكيل لواجهات برمجة التطبيقات، ولكن بدون امتيازات تعديل المستخدمين الآخرين. يمكن أن يكون المستخدمون أعضاءً في عدة مؤسسات. على سبيل المثال، قد تحدِّد شركتك مؤسسات متعدّدة على Apigee Edge لدعم منتديات المطوّرين المختلفة. على المستوى الداخلي، ينشئ الأشخاص أنفسهم جميع الخوادم الوكيلة لواجهة برمجة التطبيقات ومنتجات واجهة برمجة التطبيقات، وبالتالي هم أعضاء في جميع مؤسساتك. ولا يلزمك إنشاء حساب في Apigee، أي إنشاء مؤسسة Apigee، لتكون مستخدمًا. يمكن لمشرف إضافتك إلى مؤسسه حالية. يسجّل جميع المستخدمين الدخول إلى Apigee Edge من هنا: https://enterprise.apigee.com. |
|
وكيل واجهة برمجة التطبيقات |
ينشئ المستخدمون في مؤسسة وكيل واجهة برمجة تطبيقات واحدًا أو أكثر. يحدِّد وكيل واجهة برمجة التطبيقات تعيينًا لنقطة نهاية HTTP متاحة للجميع إلى خدمة خلفية. يمكن أيضًا ضبط الوكلاء لواجهة برمجة التطبيقات لتضمين الأمان (مثل OAuth) وتنفيذ تحويل الرسائل (مثل XML إلى JSON) والحد من عدد الزيارات إلى خدمات الخلفية وتنفيذ عمليات قيّمة أخرى على الطلب والاستجابة وطلبات البيانات من الخدمات. يجمع Edge البيانات لأغراض الإحصاءات في أدوات الربط بين واجهة برمجة التطبيقات. |
|
منتج واجهة برمجة التطبيقات |
ينشئ المستخدمون في المؤسسة منتجًا واحدًا أو أكثر من منتجات واجهة برمجة التطبيقات، حيث يكون منتج واجهة برمجة التطبيقات عبارة عن مجموعة من الخوادم الوكيلة لواجهة برمجة التطبيقات مع خطة خدمة. يمكن أن تضع خطة الخدمة هذه حدودًا للوصول إلى الخوادم الوكيلة لواجهات برمجة التطبيقات، وتوفير الأمان، والسماح بالمراقبة والإحصاءات، وتقديم ميزات إضافية. يجمع Edge البيانات لأغراض الإحصاءات حول منتجات واجهة برمجة التطبيقات. |
|
مطور التطبيق |
تحتوي المؤسسة على مطوّر واحد أو أكثر ينشئ التطبيقات التي تستخدِم واجهات برمجة التطبيقات (المجمَّعة في منتجات واجهات برمجة التطبيقات) التي تحدّدها مؤسستك. يستخدم المطوّرون واجهات برمجة التطبيقات ولكن لا يمكنهم إنشاء واجهات برمجة التطبيقات أو تنفيذ أي إجراءات أخرى في المؤسسة. يمكن أن يكون المطوّرون من داخل شركتك أو شركاء أو مطوّرين خارجيين يدفعون مقابل الوصول إلى واجهات برمجة التطبيقات. يجب أن يكون المطوّرون مسجَّلين في مؤسستك قبل أن يتمكّنوا من تسجيل تطبيق وتلقّي مفتاح واجهة برمجة التطبيقات للوصول إلى واجهات برمجة التطبيقات. بصفتك مقدّم واجهة برمجة التطبيقات، عليك تحديد كيفية إضافة المطوّرين أو تعديل بياناتهم أو إزالتهم من مؤسستك. يمكنك إضافتها يدويًا من خلال واجهة مستخدم إدارة Edge، أو إنشاء بوابة مطوّرين لتسجيلها من خلال موقع إلكتروني، أو تحديد آلية التسجيل الخاصة بك باستخدام واجهة برمجة التطبيقات لإدارة Edge. لا يُشترَط من المطوّر أن يكون لديه حساب على Edge، ولن يحتاج معظم المطوّرين إلى معرفة أي شيء عن Edge. إذا كان المطوّر لديه حساب على Edge، يكون عادةً مستخدمًا في مؤسسة مختلفة أو يستخدم خدمات Edge API. |
|
تطبيق |
ينشئ المطوّرون تطبيقًا واحدًا أو أكثر من تطبيقات العملاء التي تستخدِم واجهات برمجة التطبيقات. على المطوّرين تسجيل تطبيقاتهم في مؤسستك. "التطبيق في Edge" هو تمثيل لتطبيق المطوّر الفعلي الذي يقدّم للمطوّر مفتاح واجهة برمجة التطبيقات ليقوم بإرساله مع كل طلب إلى واجهات برمجة التطبيقات. وبما أنّ جميع التطبيقات مسجّلة في مؤسستك، يمكنك استخدام Edge لتتبُّع وجمع معلومات تحليلية عن التطبيق واستخدامه لواجهات برمجة التطبيقات. |
|
مفتاح واجهة برمجة التطبيقات/الرمز المميّز لبروتوكول OAuth |
استنادًا إلى آلية التفويض التي تحدّدها لواجهات برمجة التطبيقات، يُرسِل التطبيق مفتاح واجهة برمجة التطبيقات مع كل طلب إلى واجهات برمجة التطبيقات. إذا كان هذا المفتاح صالحًا، تتم الموافقة على الطلب. يتوافق Edge مع أنواع مختلفة من المصادقة، مثل مفتاح واجهة برمجة التطبيقات البسيط، وOAuth الثنائي وOAuth الثلاثي وغيرها. بصفتك مزوّد واجهة برمجة التطبيقات، عليك تحديد طريقة تتيح للمطوّرين تسجيل تطبيقاتهم. من خلال تسجيل تطبيقه، يمكنك إعادة المفتاح المطلوب للوصول إلى واجهات برمجة التطبيقات إلى المطوّر. في وقت تسجيل التطبيق، يمكن للمطوّر اختيار الوصول إلى منتج واحد من واجهة برمجة التطبيقات أو منتجات متعددة من واجهات برمجة التطبيقات. يستخدم تطبيق المطوّر الفعلي المفتاح نفسه للوصول إلى جميع منتجات واجهة برمجة التطبيقات المرتبطة بالتطبيق (التمثيل المسجَّل لتطبيق المطوّر في Edge). يمكنك في أي وقت إبطال المفتاح كي لا يتمكّن تطبيق المطوّر من الوصول إلى واجهات برمجة التطبيقات (حتى إذا كان التمثيل المسجَّل لتطبيق المطوّر لا يزال متوفّرًا في مؤسستك). ويمكنك بدلاً من ذلك تحديد حد زمني لأحد المفاتيح بحيث على المطوّر إعادة تحميل المفتاح بعد وقت محدّد. |
لمحة عن البيئات
البيئة هي سياق لتنفيذ بيئة التشغيل للخوادم الوكيلة لواجهة برمجة التطبيقات في إحدى المؤسسات. يجب نشر وكيل واجهة برمجة التطبيقات في بيئة قبل أن تتمكّن من الوصول إليه. يمكنك نشر وكيل واجهة برمجة التطبيقات في بيئة واحدة أو في بيئات متعدّدة.
يمكن أن تحتوي المؤسسة على بيئات متعددة. على سبيل المثال، يمكنك تحديد بيئة dev وtest وprod في مؤسسة.
توفّر المؤسسة نطاقًا لبعض إمكانات Apigee. على سبيل المثال، يمكن إتاحة بيانات خريطة المفاتيح (KVM) على مستوى المؤسسة، ما يعني أنّ الخوادم الوكيلة لواجهة برمجة التطبيقات المنشورة في أي بيئة ستحصل على البيانات نفسها من KVM. يمكن حصر بعض الإمكانات، مثل التخزين المؤقت، في نطاق محدود على المؤسسة أو على بيئة معيّنة داخل المؤسسة. يتم تقسيم بيانات الإحصاءات في Apigee حسب مجموعة من المؤسسة والبيئة.
في ما يلي الكيانات الرئيسية التي تديرها ضمن مؤسسة، بما في ذلك تلك المحدّدة على مستوى المؤسسة، وتلك المحدّدة لبيئة معيّنة:
