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